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

Article
08/26/2023

Insère du texte au niveau du point d’insertion ou de la sélection.

Syntaxe

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

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. Le texte de longueur nulle peut être inséré.

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. Le texte de longueur nulle peut être inséré.

[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] ppaStart

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

[out] ppaEnd

Pointeur vers l’objet d’ancrage à la fin de l’insertion de texte. 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.
TS_E_NOLOCK	L’appelant n’a pas de verrou sur le document.

Configuration requise


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

Compositions

ITextStoreAnchor

ITextStoreAnchorsink::OnTextChange

constantes TF_IAS_*

TS_TEXTCHANGE

Partager via