Partager via


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

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

Voir aussi

Objets accessibles

Idataobject

ITfDocumentMgr ::CreateContext

ITfEditSession ::D oEditSession

ITfRange

ITfRange ::InsertEmbedded

Constantes d’infrastructure diverses

Magasins de texte