Méthode ITextServices::OnTxInPlaceActivate (textserv.h)

Article
08/26/2023

Avertit l’objet de services de texte que ce contrôle est actif sur place.

Syntaxe

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

Paramètres

[in] prcClient

Type : const RECT*

Rectangle client du contrôle.

Valeur retournée

Type : HRESULT

Si l’objet est correctement activé, la valeur de retour est S_OK.

Si l’objet n’a pas pu être activé en raison d’une erreur, la valeur de retour est E_FAIL. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Remarques

Actif sur place signifie qu’un objet incorporé s’exécute sur place (par exemple, pour les contrôles et les incorporations standard, il aurait une fenêtre à dessiner). En revanche, l’interface utilisateur active signifie qu’un objet a actuellement le focus d’édition. Par exemple, des éléments tels que des menus et des barres d’outils sur le conteneur peuvent également contenir des éléments du contrôle/incorporation actif de l’interface utilisateur. Il n’existe qu’un seul contrôle actif de l’interface utilisateur à un moment donné, alors qu’il peut y avoir de nombreux contrôles actifs sur place.

Notez que l’activation de l’interface utilisateur est différente de l’obtention du focus. Pour signaler à l’objet de services de texte que le contrôle obtient ou perd le focus, l’hôte envoie des messages WM_SETFOCUS et WM_KILLFOCUS . Notez également qu’un hôte sans fenêtre transmet NULL comme wParam (fenêtre qui a perdu le focus) pour ces messages.

Lorsque vous effectuez la transition directement d’un état non actif vers l’état actif de l’interface utilisateur, l’hôte doit appeler D’abord ITextServices::OnTxInPlaceActivate , puis ITextServices::OnTxUIActivate.

ITextServices::OnTxInPlaceActivate prend comme paramètre le rectangle client de la vue en cours d’activation. Ce rectangle est indiqué dans les coordonnées client de la fenêtre conteneur. Il est identique à ce qui serait obtenu en appelant TxGetClientRect sur l’hôte.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	textserv.h
DLL	Msftedit.dll