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

Article
03/04/2024

La méthode ITextStoreACP ::InsertEmbeddedAtSelection insère un objet IDataObject au niveau du point d’insertion ou de la sélection. Le client qui appelle cette méthode doit avoir 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 d’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 obligatoires.
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 réellement le texte, par exemple, pour prédire les résultats de la réduction 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 du caractère d’application de fin où l’insertion de l’objet se produira. Cette valeur de paramètre est 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 d’application de départ 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 au membre acpStart de la structure TS_TEXTCHANGE .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

Partager via