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.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TF_E_NOSELECTION	Il documento non ha alcuna selezione.
TF_E_NOLOCK	Il cookie in ec non è valido.

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

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