Méthode IAccessibleWindowlessSite ::AcquireObjectIdRange (oleacc.h)

Acquiert une plage d’ID d’objet à partir de l’hôte de contrôle et les marque comme réservés par un contrôle sans fenêtre spécifique.

Syntaxe

HRESULT AcquireObjectIdRange(
  [in]           long               rangeSize,
  [in, optional] IAccessibleHandler *pRangeOwner,
  [out]          long               *pRangeBase
);

Paramètres

[in] rangeSize

Taille de la plage d’ID d’objet demandée.

[in, optional] pRangeOwner

Contrôle sans fenêtre qui demande la plage.

[out] pRangeBase

Premier ID d’objet dans la plage acquise.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour éviter d’utiliser un ID d’objet qui appartient à un autre contrôle sans fenêtre, un contrôle doit acquérir une plage d’ID d’objet avant d’appeler la fonction NotifyWinEvent . Un contrôle doit acquérir suffisamment d’ID d’objet pour tous ses objets accessibles contenus. Par exemple, un contrôle d’arborescence avec 100 enfants réserve au moins 101 ID d’objet, un pour la racine et un pour chaque enfant. Un contrôle d’arborescence qui devrait croître réserve autant d’ID d’objet que prévu. Si le contrôle de l’arbre devrait croître de plusieurs centaines d’enfants, il réserverait une plage de 1 000 ID juste pour être sûr.

Lorsque la fenêtre qui contient le contrôle Microsoft ActiveX reçoit un message WM_GETOBJECT avec une valeur LPARAM (ID d’objet) qui se trouve dans une plage réservée, elle doit appeler la méthode IAccessibleHandler ::AccessibleObjectFromID pour obtenir un objet IAccessible pour cet ID d’objet.

Configuration requise

Voir aussi

IAccessibleWindowlessSite

IAccessibleWindowlessSite ::ReleaseObjectIdRange