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

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.

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

Voir aussi

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