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