Cursors.CursorsEnumerator.Current-Eigenschaft

Ruft das Cursor-Objekt in der Cursors-Auflistung ab, auf das der Enumerator zeigt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property Current As Cursor
'Usage
Dim instance As Cursors..::.CursorsEnumerator
Dim value As Cursor

value = instance.Current

public Cursor Current { get; }

public:
property Cursor^ Current {
    Cursor^ get ();
}

/** @property */
public Cursor get_Current()

public function get Current () : Cursor

Eigenschaftenwert

Typ: Microsoft.Ink.Cursor
Das Cursor-Objekt in der Cursors-Auflistung, auf das der Enumerator zeigt.

Hinweise

Nach dem Erstellen eines Cursors.CursorsEnumerator-Enumerators oder nach dem Aufrufen der Reset-Methode muss die MoveNext-Methode aufgerufen werden, um den Enumerator vor dem Lesen des Werts der Current-Eigenschaft auf das erste Element der Auflistung festzulegen. Andernfalls ist die Current-Eigenschaft nicht definiert.

Die Current-Eigenschaft löst eine Ausnahme aus, wenn der letzte Aufruf der MoveNext-Methode false zurückgibt. Wenn der letzte Aufruf der MoveNext-Methode den Wert false zurückgibt, hat der Enumerator das Ende der Cursors-Auflistung erreicht.

Die Current-Eigenschaft verschiebt nicht die Position des Enumerators. Nachfolgende Aufrufe der Current-Eigenschaft geben dasselbe Objekt zurück, bis entweder die MoveNext-Methode oder die Reset-Methode aufgerufen werden.

Ein Enumerator bleibt so lange gültig, bis die Auflistung geändert wird. Wenn an der Auflistung Änderungen vorgenommen werden, z. B. durch Hinzufügen, Ändern oder Löschen von Elementen, wird der Enumerator unwiderruflich ungültig. Der nächste Aufruf der MoveNext-Methode oder der Reset-Methode löst eine System.InvalidOperationException-Ausnahme aus. Wenn die Auflistung zwischen dem Aufruf der MoveNext-Methode und dem Aufruf der Current-Eigenschaft geändert wird, gibt die Current-Eigenschaft das Element zurück, auf das sie festgelegt wurde, auch wenn der Enumerator bereits ungültig ist.

Beispiele

In diesem Beispiel wird die System.Collections.IEnumerator-Schnittstelle für die Cursors-Auflistung abgerufen und zum Aufzählen der einzelnen Elemente der Auflistung verwendet. Die Cursors-Auflistung wird von der InkOverlay.Cursors-Eigenschaft zurückgegeben.

Dim names As ArrayList = New ArrayList()
Dim ienum As IEnumerator = mInkOverlay.Cursors.GetEnumerator()
ienum.Reset()
While ienum.MoveNext()
    Dim theCursor As Microsoft.Ink.Cursor = DirectCast(ienum.Current, Microsoft.Ink.Cursor)
    names.Add(theCursor.Name)
End While

ArrayList names = new ArrayList();
IEnumerator ienum = mInkOverlay.Cursors.GetEnumerator();
ienum.Reset();
while (ienum.MoveNext())
{
    Microsoft.Ink.Cursor theCursor = (Microsoft.Ink.Cursor)ienum.Current;
    names.Add(theCursor.Name);
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.