CursorButtons.CursorButtonsEnumerator.Current (Propiedad)

Actualización: noviembre 2007

Obtiene el objeto CursorButton de la colección CursorButtons a la que señala el enumerador.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public ReadOnly Property Current As CursorButton
'Uso
Dim instance As CursorButtons..::.CursorButtonsEnumerator
Dim value As CursorButton

value = instance.Current

public CursorButton Current { get; }

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

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

public function get Current () : CursorButton

Valor de propiedad

Tipo: Microsoft.Ink.CursorButton
Objeto CursorButton de la colección CursorButtons a la que señala el enumerador.

Comentarios

Después de crear un enumerador CursorButtons.CursorButtonsEnumerator, o después de llamar al método Reset, es necesario llamar al método MoveNext para desplazar el enumerador hasta el primer elemento de la colección antes de leer el valor de la propiedad Current; de lo contrario, la propiedad Current queda sin definir.

La propiedad Current genera una excepción si la última llamada al método MoveNext devuelve false. Si la última llamada al método MoveNext devuelve false, significa que el enumerador ha llegado al final de la colección CursorButtons.

La propiedad Current no desplaza la posición del enumerador. Las llamadas consecutivas a la propiedad Current devuelven el mismo objeto hasta que se llama a cualquiera de los métodos MoveNext o Reset.

Un enumerador es válido mientras la colección no experimenta cambios. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador se invalida definitivamente. La siguiente llamada al método MoveNext o Reset genera una excepción System.InvalidOperationException. Si se modifica la colección entre la llamada al método MoveNext y la llamada a la propiedad Current, la propiedad Current devuelve el elemento en el que se ha establecido, aunque el enumerador ya esté invalidado.

Ejemplos

En este ejemplo, se obtiene la interfaz System.Collections.IEnumerator para la colección CursorButtons y se usa para enumerar cada elemento de la colección. La propiedad Cursor.Buttons devuelve la colección CursorButtons.

Dim names As ArrayList = New ArrayList()
Dim ienum As IEnumerator = cursor.Buttons.GetEnumerator()
ienum.Reset()
While ienum.MoveNext()
    Dim theButton As CursorButton = DirectCast(ienum.Current, CursorButton)
    names.Add(theButton.Name)
End While

ArrayList names = new ArrayList();
IEnumerator ienum = cursor.Buttons.GetEnumerator();
ienum.Reset();
while (ienum.MoveNext())
{
    CursorButton theButton = (CursorButton)ienum.Current;
    names.Add(theButton.Name);
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.