Méthode IOleInPlaceSiteWindowless::SetFocus (ocidl.h)
Définit le focus clavier pour un objet d'interface utilisateur actif et sans fenêtre.
Syntaxe
HRESULT SetFocus(
[in] BOOL fFocus
);
Paramètres
[in] fFocus
Si la valeur est TRUE, définit le focus clavier sur l’objet appelant. Si la valeur est FALSE, supprime le focus clavier de l’objet appelant, à condition que l’objet ait le focus.
Valeur retournée
Cette méthode retourne S_OK si le focus clavier a été correctement attribué à l’objet . Si cette méthode est appelée pour libérer le focus, elle ne doit jamais échouer. Les autres valeurs de retour possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Le focus clavier a été refusé à l'objet. |
Notes
Un objet sans fenêtre appelle cette méthode chaque fois qu’un objet fenêtré appelle la fonction SetFocus . Grâce à cet appel, l’objet sans fenêtre obtient le focus clavier et peut répondre aux messages de fenêtre. Normalement, cet appel est effectué pendant le processus d’activation de l’interface utilisateur et dans les méthodes de notification IOleInPlaceActiveObject::OnDocWindowActivate avec TRUE et IOleInPlaceActiveObject::OnFrameWindowActivate avec TRUE.
En réponse à cet appel, le conteneur définit le focus Windows sur la fenêtre utilisée pour obtenir les messages clavier (généralement la fenêtre conteneur) et redirige tous les messages clavier suivants vers l’objet sans fenêtre qui a demandé le focus.
Un objet sans fenêtre appelle également la méthode IOleInPlaceSiteWindowless::SetFocus avec le paramètre fFocus défini sur FALSE pour libérer le focus clavier sans l’affecter à un autre objet. Dans ce cas, le conteneur doit appeler la fonction SetFocus avec un paramètre NULL afin qu’aucune fenêtre n’ait le focus.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ocidl.h |