Partager via

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

La méthode ITextStoreAnchor ::InsertEmbeddedAtSelection insère un objet IDataObject au point d’insertion ou à la sélection. Le client qui appelle cette méthode doit avoir un verrou en lecture/écriture avant d’insérer un IDataObject dans le flux de texte.

Syntaxe

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Paramètres

[in] dwFlags

Spécifie si les paramètres paStart et paEnd contiennent les résultats de l’insertion d’objet.

Les indicateurs TF_IAS_NOQUERY et TF_IAS_QUERYONLY ne peuvent pas être combinés.

Valeur Signification
TF_IAS_NOQUERY
 Le texte est inséré et les valeurs des paramètres ppaStart et ppaEnd peuvent être NULL. Utilisez cet indicateur si les résultats de l’insertion de texte ne sont pas obligatoires.
TF_IAS_QUERYONLY
 Le texte n’est pas inséré et les ancres ppaStart et ppaEnd contiennent les résultats de l’insertion de texte. Les valeurs de ces paramètres dépendent de la façon dont l’application implémente l’insertion de texte dans un document.

Utilisez cet indicateur pour afficher les résultats de l’insertion de texte sans insérer réellement le texte, par exemple, pour prédire les résultats de la réduction ou de l’ajustement d’une sélection.

[in] pDataObject

Pointeur vers l’objet IDataObject à insérer.

[out] ppaStart

Pointeur vers l’objet d’ancrage au début de l’insertion de l’objet.

[out] ppaEnd

Pointeur vers l’objet d’ancrage à la fin de l’insertion de l’objet. Pour un point d’insertion, cette valeur de paramètre est identique à la valeur du paramètre ppaStart .

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 instancier l’une des ancres paStart ou paEnd.
E_INVALIDARG
 Le paramètre pchText n’est pas valide.
E_OUTOFMEMORY
 La méthode n’a pas pu instancier l’une des ancres paStart ou paEnd.
TS_E_NOLOCK
 L’appelant n’a pas de verrou sur le document.

Remarques

Les clients doivent utiliser cette méthode pour insérer un objet dans un flux de texte, car une constante TS_CHAR_EMBEDDED ne peut pas être passée dans ITextStoreAnchor ::SetText.

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

Idataobject

ITextStoreAnchor

ITextStoreAnchor ::QueryInsertEmbedded

ITextStoreAnchor ::SetText

constantes TF_IAS_*

TS_CHAR_EMBEDDED

  • Last updated on