Tablets.TabletsEnumerator.Current Property
Gets the Tablet object in the Tablets collection to which the enumerator is pointing.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public ReadOnly Property Current As Tablet
'Usage
Dim instance As Tablets.TabletsEnumerator
Dim value As Tablet
value = instance.Current
public Tablet Current { get; }
public:
property Tablet^ Current {
Tablet^ get ();
}
public function get Current () : Tablet
Property Value
Type: Microsoft.Ink.Tablet
The Tablet object in the Tablets collection to which the enumerator is pointing.
Remarks
After a Tablets.TabletsEnumerator enumerator is created, or after the Reset method is called, the MoveNext method must be called to advance the enumerator to the first element of the collection before reading the value of the Current property; otherwise, the Current property is undefined.
The Current property throws an exception if the last call to the MoveNext method returns false. If the last call to the MoveNext method returns false, the enumerator has reached the end of the Tablets collection.
The Current property does not move the position of the enumerator. Consecutive calls to the Current property return the same object until either the MoveNext or Reset method is called.
An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection—such as adding, modifying or deleting elements—the enumerator is irrecoverably invalidated. The next call to the MoveNext or Reset method throws an InvalidOperationException exception. If the collection is modified between calling the MoveNext method and calling the Current property, the Current property returns the element that it is set to, even if the enumerator is already invalidated.
Examples
This example uses the IEnumerator for the Tablets collection to iterate over the Tablets collection, allTablets, and populate the ListBox object listBoxTablets with the names of each tablet device that is attached to the system.
' Calling the constructor automatically fills the
' Tablets collection with the available Tablet objects.
Dim allTablets As Tablets = New Tablets()
' clear the list box
Me.listBoxTablets.Items.Clear()
' populate the list box with the name of each tablet
' version using GetEnumerator()
Dim theTabletsEnumerator As IEnumerator = allTablets.GetEnumerator()
While (theTabletsEnumerator.MoveNext())
Dim T As Tablet = theTabletsEnumerator.Current
Me.listBoxTablets.Items.Add(T.Name)
End While
// Calling the constructor automatically fills the
// Tablets collection with the available Tablet objects.
Tablets allTablets = new Tablets();
// clear the list box
this.listBoxTablets.Items.Clear();
// populate the list box with the name of each tablet
// version using GetEnumerator()
IEnumerator theTabletsEnumerator = allTablets.GetEnumerator();
while (theTabletsEnumerator.MoveNext())
{
Tablet T = (Tablet)theTabletsEnumerator.Current;
this.listBoxTablets.Items.Add(T.Name);
}
Platforms
Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Framework
Supported in: 3.0
See Also
Reference
Tablets.TabletsEnumerator Class
Tablets.TabletsEnumerator Members
Tablets.TabletsEnumerator.MoveNext
Tablets.TabletsEnumerator.Reset