Compartir a través de


Interfaz ITextSelection (tom.h)

Una selección de texto es un intervalo de texto con resaltado de selección.

Herencia

La interfaz ITextSelection hereda de ITextRange. ITextSelection también tiene estos tipos de miembros:

Métodos

La interfaz ITextSelection tiene estos métodos.

 
ITextSelection::EndKey

Imita la funcionalidad de la clave End.
ITextSelection::GetFlags

Obtiene las marcas de selección de texto.
ITextSelection::GetType

Obtiene el tipo de selección de texto.
ITextSelection::HomeKey

Generaliza la funcionalidad de la clave Inicio.
ITextSelection::MoveDown

Imita la funcionalidad de las teclas Flecha abajo y Flecha abajo Hacia abajo.
ITextSelection::MoveLeft

Generaliza la funcionalidad de la tecla flecha izquierda.
ITextSelection::MoveRight

Generaliza la funcionalidad de la tecla flecha derecha.
ITextSelection::MoveUp

Imita la funcionalidad de las teclas Flecha arriba y Arriba arriba.
ITextSelection::SetFlags

Establece las marcas de selección de texto.
ITextSelection::TypeText

Escribe la cadena dada por bstr en esta selección como si alguien lo hubiera escrito. Esto es similar al método SetText subyacente, pero es sensible al estado de clave Insert/Overtype y a la configuración de la interfaz de usuario, como Autocorrección y comillas inteligentes.

Comentarios

La selección está asociada a algún tipo de vista y tiene algunos métodos orientados a la interfaz de usuario que permiten emular la entrada del teclado. Por lo tanto, una aplicación puede usar los métodos ITextRange en una selección de texto, así como los métodos ITextSelection .

En el caso de la emulación de entrada del teclado, los intervalos usados en las selecciones usan el concepto del extremo activo, que suele ser el final que se movió por última vez. Por ejemplo, si un método ITextRange::Move* funciona en un intervalo que es realmente una selección de texto, el extremo movido más recientemente es el activo. Los ejemplos más conocidos del extremo activo son los que implican el control de teclas mayús+flecha, donde el extremo activo es el que se mueve. En consecuencia, los métodos ITextSelection incluyen métodos de movimiento para el extremo activo, como MoveLeft o MoveRight, y métodos para obtener y establecer el estado de extremo activo. Estos métodos manipulan las selecciones de maneras similares a las operaciones estándar del teclado del cursor. Esto le permite implementar, por ejemplo, una instalación de grabadora de macros.

Para ver cómo funcionan los métodos del teclado de cursor, consulte la tabla siguiente. Un método determinado corresponde a una tecla cursor-teclado con las teclas Ctrl y Mayús. El parámetro Unit se selecciona presionando o no presionando la tecla Ctrl, mientras que el parámetro Extend está seleccionado presionando o no presionando la tecla Mayús. Tenga en cuenta que MoveUp y MoveDown corresponden a más de una tecla del teclado. Para obtener más información, consulte las descripciones de los métodos.

Método Tecla del teclado del cursor Unidad dada por CTRL presionada (no presionada) Extensión dada por MAYÚS presionada (no presionada)
EndKey End tomStory (tomLine) tomExtend (tomMove)
Homekey Página principal tomStory (tomLine) tomExtend (tomMove)
MoveLeft Flecha izquierda tomWord (tomCharacter) tomExtend (tomMove)
MoveRight Flecha derecha tomWord (tomCharacter) tomExtend (tomMove)
MoveUp Flecha arriba tomParagraph (tomLine) tomExtend (tomMove)
MoveDown Flecha abajo tomParagraph (tomLine) tomExtend (tomMove)
MoveUp Re Pág tomWindow (tomScreen) tomExtend (tomMove)
MoveDown Av Pág tomWindow (tomScreen) tomExtend (tomMove)
 

Normalmente, las aplicaciones no implementan la interfaz ITextSelection . En su lugar, las soluciones de texto de Microsoft, como los controles de edición enriquecidos, implementan ITextSelection como parte de su implementación del Modelo de objetos de texto (TOM).

Las aplicaciones pueden recuperar un puntero ITextSelection llamando al método GetSelection .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tom.h