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

Article
08/26/2023

Insère un objet IDataObject au point d’insertion ou à la sélection. Le client qui appelle cette méthode doit disposer d’un verrou en lecture/écriture avant d’insérer un objet IDataObject dans le document.

Syntaxe

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Paramètres

[in] dwFlags

Spécifie si les paramètres pacpStart et pacpEnd et la structure TS_TEXTCHANGE contiennent les résultats de l’insertion de l’objet.

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

Valeur	Signification
0	L’insertion de texte se produit et les paramètres pacpStart et pacpEnd contiennent les résultats de l’insertion de texte. La structure TS_TEXTCHANGE doit être remplie avec cet indicateur.
TF_IAS_NOQUERY	Le texte est inséré, les valeurs des paramètres pacpStart et pacpEnd peuvent être NULL et la structure TS_TEXTCHANGE doit être remplie. Utilisez cet indicateur si les résultats de l’insertion de texte ne sont pas requis.
TF_IAS_QUERYONLY	Le texte n’est pas inséré et les valeurs des paramètres pacpStart et pacpEnd 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. Pour plus d'informations, consultez la section Notes. Utilisez cet indicateur pour afficher les résultats de l’insertion de texte sans insérer le texte, par exemple, pour prédire les résultats de l’effondrement ou de l’ajustement d’une sélection. Il n’est pas nécessaire de remplir la structure TS_TEXTCHANGE avec cet indicateur.

[in] pDataObject

Pointeur vers l’objet IDataObject à insérer.

[out] pacpStart

Pointeur vers la position du caractère d’application de départ où l’insertion de l’objet se produira.

[out] pacpEnd

Pointeur vers la position de caractère d’application de fin où l’insertion de l’objet se produira. Cette valeur de paramètre sera identique à la valeur du paramètre pacpStart pour un point d’insertion.

[out] pChange

Pointeur vers une structure TS_TEXTCHANGE avec les membres suivants.

Valeur	Signification
acpStart	Position du caractère de début de l’application avant l’insertion de l’objet dans le document.
acpOldEnd	Position du caractère d’application de fin avant l’insertion de l’objet dans le document. Cette valeur est identique à acpStart pour un point d’insertion. Si cette valeur est différente de acpStart, le texte a été sélectionné avant l’insertion de l’objet.
acpNewEnd	Position du caractère d’application de fin après l’insertion de l’objet.

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	Le paramètre pchText n’est pas valide.
TS_E_NOLOCK	L’appelant n’a pas de verrou sur le document.

Remarques

Les valeurs des paramètres pacpStart et pacpEnd dépendent de la façon dont l’application cliente insère un objet dans un document. Par exemple, si l’application définit le curseur au début de l’objet après l’insertion de l’objet, la valeur des paramètres pacpStart et pacpEnd est identique à celle du membre acpStart de la structure TS_TEXTCHANGE .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll

Voir aussi

Partager via