Méthode ITfRange ::GetEmbedded (msctf.h)

Article
02/29/2024

La méthode ITfRange ::GetEmbedded obtient le contenu qui correspond à un caractère TS_CHAR_EMBEDDED dans le flux de texte. L’ancre de début de la plage de texte est positionnée juste avant le caractère qui vous intéresse.

Syntaxe

HRESULT GetEmbedded(
  [in]  TfEditCookie ec,
  [in]  REFGUID      rguidService,
  [in]  REFIID       riid,
  [out] IUnknown     **ppunk
);

Paramètres

[in] ec

Modifier le cookie obtenu à partir de ITfDocumentMgr ::CreateContext ou ITfEditSession ::D oEditSession.

[in] rguidService

Identificateur qui spécifie comment le contenu incorporé est obtenu.

Valeur	Signification
GUID_TS_SERVICE_ACCESSIBLE	La sortie doit être un objet Accessible.
GUID_TS_SERVICE_ACTIVEX	L’appelant nécessite un pointeur direct vers l’objet qui prend en charge l’interface spécifiée par riid.
GUID_TS_SERVICE_DATAOBJECT	Le contenu doit être obtenu en tant qu’objet de transfert de données IDataObject , avec riid IID_IDataObject. Les clients doivent spécifier cette option lorsqu’une copie du contenu est requise.
Défini par l’appelant	Les services de texte et les propriétaires de contexte peuvent définir des GUID personnalisés.

[in] riid

UUID de l’interface de l’objet demandé.

[out] ppunk

Pointeur vers l’objet . Il peut être converti pour correspondre à riid.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_NOTIMPL	L’application d’implémentation n’expose pas d’objets incorporés dans son flux de texte.
TF_E_NOINTERFACE	L’objet ne prend pas en charge l’interface demandée.
TF_E_NOLOCK	La valeur dans le paramètre ec est un cookie non valide, ou l’appelant n’a pas de verrou en lecture seule.
TF_E_NOOBJECT	L’ancre de début de la plage n’est pas positionnée avant un caractère TF_CHAR_EMBEDDED.
TF_E_NOSERVICE	Le contenu ne peut pas être retourné pour correspondre à rguidService.

Remarques

Bien que l’objet obtenu ne puisse pas prendre en charge certaines interfaces, il est probable que l’objet prendra en charge les interfaces associées aux documents incorporés ou aux contrôles tels que IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache ou IDispatch. L’appelant doit utiliser QueryInterface pour rechercher toute interface intéressante. Si la méthode réussit mais que riid a la valeur NULL, l’application indique la présence d’un objet incorporé, mais n’expose pas l’objet lui-même. Les processeurs de texte peuvent toujours bénéficier d’une notification concernant le saut de mot potentiel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel