Fonction AccessibleObjectFromWindow (oleacc.h)

Article
02/29/2024

Récupère l’adresse de l’interface spécifiée pour l’objet associé à la fenêtre spécifiée.

Syntaxe

HRESULT AccessibleObjectFromWindow(
  [in]  HWND   hwnd,
  [in]  DWORD  dwId,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

Paramètres

[in] hwnd

Type : HWND

Spécifie le handle d’une fenêtre pour laquelle un objet doit être récupéré. Pour récupérer un pointeur d’interface vers l’objet cursor ou caret, spécifiez NULL et utilisez l’ID d’objet approprié dans dwObjectID.

[in] dwId

Type : DWORD

Spécifie l'ID d'objet. Cette valeur est l’une des constantes d’identificateur d’objet standard ou un ID d’objet personnalisé tel que OBJID_NATIVEOM, qui est l’ID d’objet pour le modèle objet natif Office. Pour plus d’informations sur OBJID_NATIVEOM, consultez la section Remarques de cette rubrique.

[in] riid

Type : REFIID

Spécifie l’identificateur de référence de l’interface demandée. Cette valeur est IID_IAccessible ou IID_IDispatch, mais elle peut également être IID_IUnknown ou l’IID de toute interface que l’objet est censé prendre en charge.

[out] ppvObject

Type : void**

Adresse d’une variable pointeur qui reçoit l’adresse de l’interface spécifiée.

Valeur retournée

Type : STDAPI

En cas de réussite, retourne S_OK.

En cas de non-réussite, retourne l’un des codes d’erreur COM suivants ou un autre code d’erreur COM standard.

Code de retour	Description
E_INVALIDARG	Un argument n’est pas valide.
E_NOINTERFACE	L’interface demandée n’est pas prise en charge.

Notes

Les clients appellent cette fonction pour récupérer l’adresse du pointeur IAccessible, IDispatch, IEnumVARIANT, IUnknown ou d’un autre pointeur d’interface pris en charge.

Comme avec d’autres méthodes et fonctions IAccessible , les clients peuvent recevoir des erreurs pour les pointeurs d’interface IAccessible en raison d’une action de l’utilisateur. Pour plus d’informations, consultez Réception d’erreurs pour les pointeurs d’interface IAccessible.

Les clients utilisent cette fonction pour obtenir l’accès au modèle objet natif Microsoft Office 2000. Le modèle objet natif fournit aux clients des informations d’accessibilité sur le document ou la zone cliente d’une application Office qui n’est pas exposée par Microsoft Active Accessibility.

Pour obtenir un pointeur d’interface IDispatch vers une classe prise en charge par le modèle objet natif, spécifiez OBJID_NATIVEOM dans dwObjectID. Lors de l’utilisation de cet identificateur d’objet, le paramètre hwnd doit correspondre aux types de classe de fenêtre suivants.

Application Office	Classe Window	Pointeur IDispatch vers
Word	_WwG	Fenêtre
Excel	EXCEL7	Fenêtre
PowerPoint	paneClassDC	DocumentWindow
Barres de commandes	MsoCommandBar	CommandBar

Notez que les classes de fenêtre ci-dessus correspondent à la fenêtre de document ou à la fenêtre de volet la plus intérieure. Pour plus d’informations sur le modèle objet Office, consultez le Guide du programmeur Microsoft Office 2000/Visual Basic.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h
Bibliothèque	Oleacc.lib
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95

Voir aussi

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

IDispatch

Partager via