Partager via

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

  • Article

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