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

Article
08/26/2023

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.

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