IPointerInactive::GetActivationPolicy-Methode (ocidl.h)

  • Artikel

Ruft die aktuelle Aktivierungsrichtlinie für das -Objekt ab. Diese Methode wird vom Container beim Empfang einer WM_SETCURSOR- oder WM_MOUSEMOVE-Nachricht aufgerufen, wenn sich ein inaktives Objekt unter dem Mauszeiger befindet.

Syntax

HRESULT GetActivationPolicy(
  [out] DWORD *pdwPolicy
);

Parameter

[out] pdwPolicy

Ein Zeiger auf eine Variable, die die Aktivierungsrichtlinie empfängt. Mögliche Werte stammen aus der POINTERINACTIVE-Enumeration .

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird sie E_FAIL.

Hinweise

Das Objekt kann anfordern, dass es aktiviert wird, sobald die Maus es über den POINTERINACTIVE_ACTIVATEONENTRY-Wert eingibt. Ein Objekt, das mehr visuelles Feedback als das einfache Festlegen des Mauszeigers bietet, würde diesen Wert verwenden. Wenn das Objekt beispielsweise spezielle visuelles Feedback unterstützt, muss es in den aktiven Zustand gelangen, damit es das visuelle Feedback zeichnen kann, das es unterstützt.

Ein Objekt kann diese Methode auch verwenden, um die Aktivierung anzufordern, wenn die Maus während eines Drag-and-Drop-Vorgangs über das POINTERINACTIVE_ACTIVATEONDRAG gezogen wird.

Wenn das Objekt einen dieser Werte zurückgibt, sollte der Container das Objekt sofort aktivieren und die Window-Meldung weiterleiten, die den Aufruf ausgelöst hat. Das Objekt bleibt dann aktiv und verarbeitet nachfolgende Nachrichten über ein eigenes Fenster, bis der Container eine weitere WM_SETCURSOR oder WM_MOUSEMOVE erhält. An diesem Punkt sollte der Container das Objekt deaktivieren.

Bei fensterlosen OLE-Objekten unterscheidet sich dieser Mechanismus geringfügig. Weitere Informationen zu Drag and Drop-Vorgängen für fensterlose Objekte finden Sie unter IOleInPlaceSiteWindowless .

Wenn das Objekt sowohl den POINTERINACTIVE_ACTIVATEONENTRY- als auch den POINTERINACTIVE_DEACTIVATEONLEAVE-Wert zurückgibt, wird das Objekt nur aktiviert, wenn die Maus über das Objekt ist. Wenn der POINTERINACTIVE_ACTIVATEONENTRY Wert allein festgelegt ist, wird das Objekt einmal aktiviert, wenn die Maus es zum ersten Mal eingibt, und es bleibt aktiv.

Hinweise für Anrufer

Die Aktivierungsrichtlinie sollte nicht zwischengespeichert werden. Der Container sollte diese Methode jedes Mal aufrufen, wenn die Maus ein inaktives Objekt eingibt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IOleInPlaceSiteWindowless

IPointerInactive