IOleInPlaceSiteEx::OnInPlaceActivateEx-Methode (ocidl.h)

Artikel
03/04/2024

Wird vom eingebetteten Objekt aufgerufen, um zu bestimmen, ob es sich bei der Aktivierung neu zeichnen muss.

Syntax

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

Parameter

[out] pfNoRedraw

Ein Zeiger auf eine Variable, die die aktuelle neu gezeichnete status empfängt. Die status ist TRUE, wenn sich das Objekt bei der Aktivierung nicht neu zeichnen muss, andernfalls FALSE. Fensterlose Objekte benötigen in der Regel nicht den von diesem Parameter zurückgegebenen Wert und übergeben möglicherweise einen NULL-Zeiger , um dem Container den Aufwand beim Berechnen dieses Werts zu sparen.

[in] dwFlags

Gibt an, ob das Objekt als fensterloses Objekt aktiviert wird. Dieser Parameter akzeptiert Werte aus der ACTIVATEFLAGS-Enumeration . Weitere Informationen zu fensterlosen Objekten finden Sie unter IOleInPlaceSiteWindowless .

Rückgabewert

Diese Methode gibt S_OK zurück, wenn der Container die direkte Aktivierung zulässt. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Diese Methode ersetzt IOleInPlaceSite::OnInPlaceActivate. Wenn die ältere Methode verwendet wird, muss sich das Objekt bei der Aktivierung immer neu zeichnen.

Fensterlose Objekte müssen diese Methode anstelle von IOleInPlaceSite::OnInPlaceActivate verwenden, um den Container darüber zu informieren, ob sie fensterlos aktivieren oder nicht.

Hinweise für Implementierer

Der Container sollte die ungültige status des Objekts, dessen Z-Reihenfolge, Clipping und alle anderen relevanten Parameter sorgfältig überprüfen, um den geeigneten Wert zu bestimmen, der in pfNoRedraw zurückgegeben werden soll.

Ein Container kann den Wert der ACTIVATEFLAGS-Enumeration zwischenspeichern, anstatt die GetWindow-Methode in der IOleInPlaceObjectWindowless-Schnittstelle wiederholt aufzurufen.

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