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 |