Metodo IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)
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 |