Compartir a través de

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

  • Artículo

Establece la selección dentro del documento.

Sintaxis

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

Parámetros

[in] ec

Contiene una cookie de edición que identifica la sesión de edición. Este es el valor pasado a ITfEditSession::D oEditSession.

[in] ulCount

Especifica el número de selecciones de la matriz pSelection .

[in] pSelection

Matriz de estructuras TF_SELECTION que contienen la información de cada selección.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 Método realizado correctamente.
TF_E_NOSELECTION
 El documento no tiene ninguna selección.
TF_E_NOLOCK
 La cookie en ec no es válida.

Comentarios

Una selección es un intervalo de texto resaltado o un punto de inserción si el intervalo está vacío, lo que identifica el área de enfoque del usuario dentro de un documento. Algunos documentos son capaces de tener varias selecciones. Solo puede haber una selección de longitud cero en pSelection , ya que representa la posición del símbolo de intercalación del documento.

Si una aplicación debe ajustar el texto cubierto por una selección, debe esperar hasta que el autor de la llamada libere el bloqueo. Sin embargo, las aplicaciones pueden ajustar cualquiera de los miembros de estilo de las estructuras de TF_SELECTION a la vez que devuelven S_OK.

El autor de la llamada solo puede establecer la marca fInterimChar si se establece una selección. En este caso, la selección debe abarcar exactamente un carácter y el miembro ase de la estructura TF_SELECTION se establece en TFAE_NONE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msctf.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

Interfaz ITfContext, ITfEditSession::D oEditSession, TF_SELECTION estructura, ITfContext::GetSelection