Metodo ITfContext::SetSelection (msctf.h)

Imposta la selezione all'interno del documento.

Sintassi

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

Parametri

[in] ec

Contiene un cookie di modifica che identifica la sessione di modifica. Questo è il valore passato a ITfEditSession::D oEditSession.

[in] ulCount

Specifica il numero di selezioni nella matrice pSelection .

[in] pSelection

Matrice di strutture TF_SELECTION che contengono le informazioni per ogni selezione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Una selezione è un intervallo di testo evidenziato o un punto di inserimento se l'intervallo è vuoto, identificando l'area di interesse dell'utente all'interno di un documento. Alcuni documenti sono in grado di avere più selezioni. In pSelection può essere selezionata una sola lunghezza zero perché rappresenta la posizione del cursore del documento.

Se un'applicazione deve modificare il testo coperto da una selezione, deve attendere fino a quando il chiamante non rilascia il blocco. Tuttavia, le applicazioni possono modificare qualsiasi membro dello stile delle strutture di TF_SELECTION pur restituendo S_OK.

Il chiamante può impostare il flag fInterimChar solo se è impostata una selezione. In questo caso, la selezione deve estendersi esattamente su un carattere e il membro dell'ambiente del servizio app della struttura TF_SELECTION è impostato su TFAE_NONE.

Requisiti

Vedi anche

Interfaccia ITfContext, ITfEditSession::D oEditSession, struttura TF_SELECTION, ITfContext::GetSelection