Método ITextSelection::EndKey (tom.h)

Artículo
08/26/2023

Imita la funcionalidad de la clave End.

Sintaxis

HRESULT EndKey(
  long Unit,
  long Extend,
  long *pDelta
);

Parámetros

Unit

Tipo: long

Unidad que se va a usar. Puede ser uno de los siguientes.

Value	Significado
tomLine	Dependiendo de Extender, mueve el punto de inserción o el extremo activo hasta el final de la última línea de la selección. Este es el valor predeterminado.
tomStory	Dependiendo de Extend, mueve el punto de inserción o el extremo activo hasta el final de la última línea del artículo.
tomColumn	Dependiendo de Extender, mueve el punto de inserción o el extremo activo hasta el final de la última columna de la selección. Esto solo está disponible si el motor de TOM admite tablas.
tomRow	Dependiendo de Extender, mueve el punto de inserción o el extremo activo al final de la última fila de la selección. Esto solo está disponible si el motor de TOM admite tablas.

Extend

Tipo: long

Marca que indica cómo cambiar la selección. Si Extend es cero (o tomMove), el método contrae la selección en un punto de inserción. Si Extend es 1 (o tomExtend), el método mueve el extremo activo y deja solo el otro extremo. El valor predeterminado es cero.

pDelta

Tipo: long*

Puntero a una variable que recibe el recuento de caracteres que se mueve el punto de inserción o el extremo activo. Este parámetro puede ser NULL.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT . Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_INVALIDARG	Unit no es tomLine ni tomStory.
S_FALSE	Error por algún otro motivo.

Comentarios

Establecer Extender en tomExtend (o distinto de cero) corresponde a la tecla Mayús que se está presionando. Establecer Unit en tomLine corresponde a la tecla Ctrl que no se está presionando. Establecer Unidad en tomStory en Ctrl que se está presionando. Los parámetros pDelta reciben el número de caracteres que se mueve el punto de inserción o el extremo activo.

Los métodos ITextSelection::HomeKey e ITextSelection::EndKey se usan para imitar el comportamiento estándar de la clave Inicio/Fin.

El valor tomLine imita el comportamiento de la tecla Inicio o Fin sin presionar la tecla Ctrl, mientras que tomStory imita el comportamiento con la tecla Ctrl presionada. De forma similar, tomMove imita el comportamiento de la tecla Inicio o Fin sin presionar la tecla Mayús, mientras que tomExtend imita el comportamiento con la tecla Mayús presionada. Por lo tanto EndKey(tomStory) , convierte la selección en un punto de inserción al final del artículo asociado, mientras EndKey(tomStory, tomExtend) que mueve el final activo de la selección al final de la historia y deja el otro extremo donde estaba.

Los métodos HomeKey y EndKey son métodos lógicos como los métodos Move* , en lugar de métodos direccionales. Por lo tanto, dependen del idioma implicado. Por ejemplo, en texto árabe, HomeKey se mueve al final derecho de una línea, mientras que en texto en inglés, se mueve a la izquierda. Por lo tanto, HomeKey y EndKey son diferentes de los métodos MoveLeft y MoveRight . Además, tenga en cuenta que el método EndKey es bastante diferente de la propiedad End , que es el cp al final de la selección. HomeKey y EndKey también difieren de los métodos StartOf y EndOf en que se extienden desde el final activo, mientras que StartOf se extiende desde Start y EndOf se extiende desde End.

Requisitos


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
Archivo DLL	Msftedit.dll