Metodo IOleInPlaceSiteWindowless::SetFocus (ocidl.h)
Imposta lo stato attivo per un oggetto senza finestra attivo nell'interfaccia utente.
Sintassi
HRESULT SetFocus(
[in] BOOL fFocus
);
Parametri
[in] fFocus
Se TRUE, imposta lo stato attivo della tastiera sull'oggetto chiamante. Se FALSE, rimuove lo stato attivo della tastiera dall'oggetto chiamante, purché l'oggetto abbia lo stato attivo.
Valore restituito
Questo metodo restituisce S_OK se lo stato attivo della tastiera è stato assegnato correttamente all'oggetto . Se questo metodo viene chiamato per rilasciare lo stato attivo, non deve avere mai esito negativo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Lo stato attivo della tastiera è stato negato all'oggetto. |
Commenti
Un oggetto senza finestra chiama questo metodo ogni volta che un oggetto con finestra chiamerebbe la funzione SetFocus . Tramite questa chiamata, l'oggetto senza finestra ottiene lo stato attivo della tastiera e può rispondere ai messaggi della finestra. In genere, questa chiamata viene eseguita durante il processo di attivazione dell'interfaccia utente e nei metodi di notifica IOleInPlaceActiveObject::OnDocWindowActivate con TRUE e IOleInPlaceActiveObject::OnFrameWindowActivate con TRUE.
In risposta a questa chiamata, il contenitore imposta lo stato attivo di Windows sulla finestra usata per ottenere i messaggi della tastiera (in genere la finestra del contenitore) e reindirizza tutti i messaggi di tastiera successivi all'oggetto senza finestra che ha richiesto lo stato attivo.
Un oggetto senza finestra chiama anche il metodo IOleInPlaceSiteWindowless::SetFocus con il parametro fFocus impostato su FALSE per rilasciare lo stato attivo della tastiera senza assegnarlo ad altri oggetti. In questo caso, il contenitore deve chiamare la funzione SetFocus con un parametro NULL in modo che nessuna finestra abbia lo stato attivo.
Requisiti
| 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 |