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

Article
03/02/2024

La méthode ITextStoreACP ::InsertTextAtSelection insère du texte au point d’insertion ou à la sélection. Un appelant doit disposer d’un verrou en lecture/écriture sur le document avant d’insérer du texte.

Syntaxe

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [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 texte.

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 pour afficher les résultats de l’insertion de texte.
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. Si vous utilisez cet indicateur, vous n’avez pas besoin de remplir la structure TS_TEXTCHANGE .

[in] pchText

Pointeur vers la chaîne à insérer dans le document. La chaîne peut être terminée par NULL .

[in] cch

Spécifie la longueur du texte.

[out] pacpStart

Pointeur vers la position de caractère d’application de départ où l’insertion de texte a lieu.

[out] pacpEnd

Pointeur vers la position de caractère d’application de fin où l’insertion de texte se produit. 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 de début de l’application avant l’insertion du texte dans le document.
acpOldEnd	Position du caractère d’application de fin avant l’insertion du texte 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 texte.
acpNewEnd	Position de fin après l’insertion de texte.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
TS_E_NOLOCK	L’appelant n’a pas de verrou sur le document.
E_INVALIDARG	Le paramètre pchText n’est pas valide.

Remarques

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

Les applications ne doivent pas appeler la méthode ITextStoreACPSink ::OnTextChange en réponse à cette méthode.

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