Méthode ITfContext ::SetSelection (msctf.h)

Article
02/29/2024

Définit la sélection dans le document.

Syntaxe

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

Paramètres

[in] ec

Contient un cookie de modification qui identifie la session de modification. Il s’agit de la valeur passée à ITfEditSession ::D oEditSession.

[in] ulCount

Spécifie le nombre de sélections dans le tableau pSelection .

[in] pSelection

Tableau de structures TF_SELECTION qui contiennent les informations de chaque sélection.

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_NOSELECTION	Le document n’a pas de sélection.
TF_E_NOLOCK	Le cookie dans ec n’est pas valide.

Remarques

Une sélection est une étendue de texte en surbrillance, ou un point d’insertion si la plage est vide, identifiant la zone de focus utilisateur dans un document. Certains documents peuvent avoir plusieurs sélections. Il ne peut y avoir qu’une seule sélection de longueur nulle dans pSelection , car elle représente la position du caret de document.

Si une application doit ajuster le texte couvert par une sélection, elle doit attendre que l’appelant libère le verrou. Toutefois, les applications peuvent ajuster les membres de style des structures TF_SELECTION tout en retournant S_OK.

L’appelant peut définir l’indicateur fInterimChar uniquement si une sélection est définie. Dans ce cas, la sélection doit s’étendre exactement sur un caractère et le membre ase de la structure TF_SELECTION est défini sur TFAE_NONE.

Configuration requise

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

Voir aussi

Interface ITfContext, ITfEditSession ::D oEditSession, structure TF_SELECTION, ITfContext ::GetSelection

Partager via