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.

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

Voir aussi

IOleInPlaceActiveObject

IOleInPlaceSiteWindowless