CursorButtons.GetEnumerator, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne un objet qui implémente l'interface System.Collections.IEnumerator (page pouvant être en anglais) et peut parcourir les objets CursorButton contenus dans la collection CursorButtons.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function GetEnumerator As CursorButtons..::.CursorButtonsEnumerator
'Utilisation
Dim instance As CursorButtons
Dim returnValue As CursorButtons..::.CursorButtonsEnumerator

returnValue = instance.GetEnumerator()

public CursorButtons..::.CursorButtonsEnumerator GetEnumerator()

public:
CursorButtons..::.CursorButtonsEnumerator^ GetEnumerator()

public CursorButtons..::.CursorButtonsEnumerator GetEnumerator()

public function GetEnumerator() : CursorButtons..::.CursorButtonsEnumerator

Valeur de retour

Type : Microsoft.Ink.CursorButtons.CursorButtonsEnumerator
Objet qui implémente l'interface System.Collections.IEnumerator (page pouvant être en anglais) et peut parcourir les objets CursorButton contenus dans la collection CursorButtons.

Notes

Cette fonction peut être exécutée à nouveau si elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Exemples

Ces exemples présentent deux façons de parcourir la collection CursorButtons et d'obtenir le nom de chaque objet CursorButton dans l'objet Cursor, theCursor. La collection CursorButtons est retournée par la propriété Cursor.Buttons.

Dans cet exemple, System.Collections.IEnumerator (page pouvant être en anglais) est obtenu pour la collection CursorButtons et utilisé pour énumérer chaque élément de la collection.

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);
}

Cet exemple utilise l'instruction foreach, qui appelle la méthode GetEnumerator dans le code interne que le compilateur génère pour prendre en charge l'instruction.

Dim names As ArrayList = New ArrayList()
For Each theButton As CursorButton In cursor.Buttons
    names.Add(theButton.Name)
Next

ArrayList names = new ArrayList();
foreach (CursorButton theButton in cursor.Buttons)
{
    names.Add(theButton.Name);
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.