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

Weitere Informationen

IAccessibleWindowlessSite

IAccessibleWindowlessSite::ReleaseObjectIdRange