Metodo IOleInPlaceSiteEx::OnInPlaceActivateEx (ocidl.h)

Articolo
02/29/2024

Chiamato dall'oggetto incorporato per determinare se deve ridisegnarsi al momento dell'attivazione.

Sintassi

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

Parametri

[out] pfNoRedraw

Puntatore a una variabile che riceve lo stato di ridisegno corrente. Lo stato è TRUE se l'oggetto non deve essere ridisegnato all'attivazione e FALSE in caso contrario. Gli oggetti senza finestra in genere non necessitano del valore restituito da questo parametro e possono passare un puntatore NULL per salvare il contenitore il carico di lavoro di calcolo di questo valore.

[in] dwFlags

Indica se l'oggetto viene attivato come oggetto senza finestra. Questo parametro accetta i valori dall'enumerazione ACTIVATEFLAGS . Per altre informazioni sugli oggetti senza finestra, vedere IOleInPlaceSiteWindowless .

Valore restituito

Questo metodo restituisce S_OK se il contenitore consente l'attivazione sul posto. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

Questo metodo sostituisce IOleInPlaceSite::OnInPlaceActivate. Se viene usato il metodo precedente, l'oggetto deve sempre ridisegnarsi all'attivazione.

Gli oggetti senza finestra devono usare questo metodo anziché IOleInPlaceSite::OnInPlaceActivate per notificare al contenitore se stanno attivando o meno la finestra.

Note per gli implementatori

Il contenitore deve controllare attentamente lo stato di invalidazione dell'oggetto, il relativo ordine z, ritaglio ed eventuali altri parametri pertinenti per determinare il valore appropriato da restituire in pfNoRedraw.

Un contenitore può memorizzare nella cache il valore dell'enumerazione ACTIVATEFLAGS anziché chiamare ripetutamente il metodo GetWindow nell'interfaccia IOleInPlaceObjectWindowless .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h