Méthode ITextStoreAnchor ::GetEmbedded (textstor.h)

Article
03/02/2024

La méthode ITextStoreAnchor ::GetEmbedded obtient un objet incorporé à partir d’un flux de texte.

Syntaxe

HRESULT GetEmbedded(
  [in]  DWORD    dwFlags,
  [in]  IAnchor  *paPos,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Paramètres

[in] dwFlags

Champs de bits qui spécifient la façon dont la méthode traite le texte masqué. S’il est défini sur TS_GEA_HIDDEN, un objet incorporé peut se trouver dans du texte masqué. Sinon, le texte masqué est ignoré.

[in] paPos

Pointeur vers une ancre positionnée immédiatement devant l’objet incorporé, comme indiqué par un caractère TS_CHAR_EMBEDDED.

[in] rguidService

Contient une valeur GUID qui définit le format demandé de l’objet obtenu. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
GUID_TS_SERVICE_DATAOBJECT	L’objet doit être obtenu en tant qu’objet de données IDataObject .
GUID_TS_SERVICE_ACCESSIBLE	L’objet doit être obtenu en tant qu’objet Accessible.
GUID_TS_SERVICE_ACTIVEX	L’objet doit être obtenu en tant qu’objet ActiveX.

[in] riid

Spécifie le type d’interface demandé.

[out] ppunk

Pointeur vers un pointeur IUnknown qui reçoit l’interface demandée.

Valeur retournée

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

Valeur	Description
S_OK	La méthode a réussi.
E_FAIL	La méthode n’a pas pu obtenir l’objet demandé.
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_INVALIDPOS	L’ancre paPos demandée ne se trouve pas dans le document.
TS_E_NOINTERFACE	Le type d’interface demandé n’est pas pris en charge.
TS_E_NOLOCK	L’appelant n’a pas de verrou en lecture seule.
TS_E_NOOBJECT	Il n’y a pas d’ancre paPos immédiatement devant un caractère TS_CHAR_EMBEDDED.
TS_E_NOSERVICE	Le type de service spécifié dans rguidService n’est pas pris en charge.

Remarques

L’appelant doit utiliser QueryInterface pour rechercher les interfaces appropriées. Les interfaces prospectives incluent celles associées à des documents ou contrôles incorporés tels que IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache ou IDispatch.

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	textstor.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

Objets accessibles

Idataobject

ITextStoreAnchor

Partager via