Méthode ITfUIElementSink ::BeginUIElement (msctf.h)

La méthode ITfUIElementSink ::BeginUIElement est appelée au démarrage de l’UIElement. Ce récepteur peut permettre au service text de dessiner ou de ne pas dessiner l’élément d’interface utilisateur.

Syntaxe

HRESULT BeginUIElement(
  [in] DWORD dwUIElementId,
       BOOL  *pbShow
);

Paramètres

[in] dwUIElementId

[in] ID de l’élément UIElement qui a été démarré.

pbShow

[in, out] Retourne true si l’application ne dessine pas le contenu UIElement et que le service de texte dessine son contenu d’interface utilisateur d’origine. Retourne false si l’application dessine le contenu de l’UIElement et empêche le service de texte de le dessiner. L’application peut obtenir l’interface ITfUIElement à l’aide de ITfUIElementMgr ::GetUIElement et évaluer si elle peut gérer l’interface UIElement par QI avec IID_ITfCandidateListUIElement ou avec d’autres interfaces UIElement. L’application peut toujours retourner la valeur FALSE si elle est inconnue ou si elle ne peut pas être gérée. Dans ce cas, le service de texte n’affiche aucune interface utilisateur supplémentaire à l’écran. Il s’agit d’un bon moyen pour certaines applications en plein écran. L’application peut également retourner TRUE pour utiliser l’interface utilisateur de TextService sur certaines interfaces utilisateur particulières ou inconnues.

Valeur retournée

Le gestionnaire TSF ignore la valeur de retour de cette méthode.

Configuration requise