Metodo IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)

Articolo
03/01/2024

Notifica all'oggetto attivo sul posto quando la finestra del documento del contenitore viene attivata o disattivata.

Sintassi

HRESULT OnDocWindowActivate(
  [in] BOOL fActivate
);

Parametri

[in] fActivate

Stato della finestra del documento figlio MDI. Se questo parametro è TRUE, la finestra si trova nell'atto di attivazione; se è FALSE, è nell'atto di disattivazione.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo.

Commenti

Note ai chiamanti

Chiamare IOleInPlaceActiveObject::OnDocWindowActivate quando la finestra del documento figlio MDI viene attivata o disattivata e l'oggetto è attualmente l'oggetto attivo per il documento.

Note per gli implementatori

È consigliabile includere codice in questo metodo che installa gli strumenti a livello di frame durante l'attivazione dell'oggetto. Questi strumenti includono il menu composito condiviso e/o le barre degli strumenti facoltative e gli oggetti di cornice. Dovresti quindi prendere lo stato attivo. Quando si disattiva, l'oggetto deve rimuovere gli strumenti a livello di frame. Si noti che se non si chiama IOleInPlaceUIWindow::SetBorderSpace con pborderwidths impostato su NULL, è possibile evitare di dover rinegoziare lo spazio del bordo.

Durante l'esecuzione di IOleInPlaceActiveObject::OnDocWindowActivate, non effettuare chiamate alle funzioni PeekMessage o GetMessage o a una finestra di dialogo. In questo modo può causare il deadlock del sistema. Esistono ulteriori restrizioni per cui è possibile chiamare metodi e funzioni dell'interfaccia OLE all'interno di IOleInPlaceActiveObject::OnDocWindowActivate.

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	oleidl.h