Méthode ITfInsertAtSelection ::InsertTextAtSelection (msctf.h)

Article
02/29/2024

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

Syntaxe

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

Paramètres

[in] ec

Identifie le contexte de modification. Elle est obtenue à partir de ITfDocumentMgr ::CreateContext ou ITfEditSession ::D oEditSession.

[in] dwFlags

Champ bit avec l’une des valeurs suivantes.

Valeur	Signification
TF_IAS_NOQUERY	ppRange a la valeur NULL. Cet indicateur ne peut pas être combiné avec l’indicateur TF_IAS_QUERYONLY.
TF_IAS_QUERYONLY	Le contexte n’est pas modifié, mais ppRange est défini comme si l’insertion s’était produite. L’accès en lecture seule est suffisant. Si cet indicateur n’est pas défini, ec doit disposer d’un accès en lecture/écriture. Cet indicateur ne peut pas être combiné avec l’indicateur TF_IAS_NOQUERY.
TF_IAS_NO_DEFAULT_COMPOSITION	Le gestionnaire ne crée pas de composition par défaut si une composition est requise. L’appelant doit créer un objet de composition qui couvre le texte inséré avant de libérer le verrou contextuel.

[in] pchText

Spécifie le texte à insérer.

[in] cch

Spécifie le nombre de caractères du texte dans pchText.

[out] ppRange

Reçoit la position de l’objet inséré.

Valeur retournée

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

Valeur	Description
S_OK	La méthode a réussi.
TF_E_NOLOCK	Le service de texte n’a pas de verrou de document
TF_E_DISCONNECTED	L’objet de contexte ne se trouve pas sur une pile de documents.
TS_E_NOSELECTION	Le contexte n’est pas sélectionné.
TS_E_READONLY	La sélection est en lecture seule.

Remarques

Pour insérer un objet IDataObject au lieu du texte, utilisez ITfInsertAtSelection ::InsertEmbeddedAtSelection.

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	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel