VARIANT Structure
La plupart des fonctions d’accessibilité Active Microsoft et des propriétés et méthodes IAccessible prennent une structure VARIANT en tant que paramètre. Essentiellement, la structure VARIANT est un conteneur pour une grande union qui contient de nombreux types de données.
La valeur dans le premier membre de la structure, vt, décrit laquelle des membres de l’union est valide. Bien que la structure VARIANT prenne en charge de nombreux types de données différents, Microsoft Active Accessibility utilise uniquement les types suivants.
| Valeur vt | Nom de membre de valeur correspondant |
|---|---|
| VT_I4 | lVal |
| VT_DISPATCH | pdispVal |
| VT_BSTR | bstrVal |
| VT_EMPTY | aucun |
Lorsque vous recevez des informations dans une structure de VARIANT, consultez le membre vt pour savoir quel membre contient des données valides. De même, lorsque vous envoyez des informations à l’aide d’une structure VARIANT, définissez toujours pour refléter le membre de l’union qui contient les informations.
Avant d’utiliser la structure, initialisez-la en appelant la fonction VariantInit component Object Model (COM). Une fois la structure terminée, effacez-la avant la mémoire qui contient leVARIANTest libérée en appelant VariantClear.