IAccessibleWindowlessSite::AcquireObjectIdRange-Methode (oleacc.h)
Ruft einen Bereich von Objekt-IDs vom Steuerelementhost ab und markiert sie als reserviert durch ein bestimmtes fensterloses Steuerelement.
Syntax
HRESULT AcquireObjectIdRange(
[in] long rangeSize,
[in, optional] IAccessibleHandler *pRangeOwner,
[out] long *pRangeBase
);
Parameter
[in] rangeSize
Die Größe des angeforderten Objekt-ID-Bereichs.
[in, optional] pRangeOwner
Das fensterlose Steuerelement, das den Bereich anfordert.
[out] pRangeBase
Die erste Objekt-ID im erfassten Bereich.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Um die Verwendung einer Objekt-ID zu vermeiden, die zu einem anderen fensterlosen Steuerelement gehört, sollte ein Steuerelement einen Objekt-ID-Bereich abrufen, bevor die NotifyWinEvent-Funktion aufgerufen wird. Ein Steuerelement sollte genügend Objekt-IDs für alle enthaltenen objekte abrufen, auf die zugegriffen werden kann. Beispielsweise würde ein Struktursteuerelement mit 100 untergeordneten Elementen mindestens 101 Objekt-IDs reservieren, eine für den Stamm und eine für jedes untergeordnete Element. Ein Struktursteuerelement, das voraussichtlich wachsen wird, reserviert so viele Objekt-IDs wie erwartet. Wenn das Baumsteuerelement um mehrere hundert Kinder wachsen wird, würde es einen Bereich von 1.000 IDs reservieren, nur um sicher zu sein.
Wenn das Fenster, das das Microsoft ActiveX-Steuerelement enthält, eine WM_GETOBJECT Nachricht mit einem LPARAM-Wert (Objekt-ID) empfängt, der sich in einem reservierten Bereich befindet, sollte es die IAccessibleHandler::AccessibleObjectFromID-Methode aufrufen, um ein IAccessible-Objekt für diese Objekt-ID abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | oleacc.h |
| Bibliothek | Oleacc.lib |
| DLL | Oleacc.dll |