Función CVDOCPOS
La función CVDOCPOS devuelve información sobre la posición del cursor en el documento. Esta información puede utilizarse para crear eventos o añadir nuevas opciones de menú en la zona de congelación que requieran la posición del cursor para funcionar.
Sintaxis
CVDOCPOS("prop", <"type">)
El argumento «prop» define el nombre de la propiedad que se va a recuperar.
El argumento también puede especificar una de las siguientes propiedades predeterminadas para devolver información sobre el objeto CaseView:
|
#CN |
Número de móvil |
|
#CT |
La posición del cursor dentro de una tabla se devuelve como un número de celda de la tabla. Fuera de una tabla, este parámetro devuelve «». El número se calcula como si existiera una celda en los párrafos de esa celda de la tabla, incluso cuando no hay ninguna celda presente. |
|
#TN |
Nombre de la tabla |
|
#TR |
Número de fila de la tabla |
|
#TC |
Número de columna de la tabla |
Si nada cumple los criterios, se devuelve una cadena vacía.
El argumento «type» es un argumento opcional que permite limitar el ámbito de los objetos en los que se busca la propiedad indicada. Úselo para aclarar cualquier ambigüedad. Por ejemplo, si el cursor se encuentra en una tabla y tanto la tabla como la columna y la fila de la tabla tienen una propiedad «Eliminar», la función no puede determinar qué valor de la propiedad debe utilizar. Este tipo permite utilizar comandos como «utilizar la propiedad Fila de tabla » o «utilizar la propiedad Sección ».
Los tipos que se pueden utilizar en el cálculo son:
|
P |
Párrafo |
|
T |
Tabla |
|
TR |
Fila |
|
TC |
Columna |
|
S |
Sección |
|
D |
Configuración del documento |
La función CVDOCPOS() solo funciona en las siguientes áreas.
-
En el panel «Congelar»: Información sobre herramientas, cálculos de imágenes, menús del botón izquierdo o derecho del ratón y cálculos de selección emergentes;
-
A lo largo de todo el documento: Menús del botón izquierdo o derecho
Siempre se vuelve a calcular en último lugar, por lo que no forma parte del orden de recálculo.
Nota
- Si hay varios objetos que tienen una propiedad específica, el orden en el que se devuelve el valor de dicha propiedad no está definido. Esto significa que un valor podría devolverse en una ocasión y otro podría devolverse en otra. Además, es posible que, en futuras versiones, CaseView no analice el documento siguiendo el mismo orden, lo que significa que los resultados podrían ser diferentes.
-
Intente no meterse en situaciones en las que el orden sea importante. Si el orden es importante, encadene varias funciones CVDOCPOS solicitando el valor en el orden que se requiera.
Ejemplo 1
Si se ha utilizado una función de edición de tabla, pero era necesario garantizar que no se ejecutara cuando el cursor no se encontrara en una fila de la tabla, introduzca una condición de desactivación.
Desactivar si: CVDOCPOS("#TR") = ""
Si se configura esta opción como una función desactivada, significa que, cuando el cursor no se encuentre en una fila de la tabla (la posición del cursor en la tabla es nula), la función no se ejecutará.
Ejemplo 2
Si se ha creado una barra de herramientas para eliminar filas, pero existen filas de encabezado y filas de subtotal/total cuya eliminación provocaría errores en otras partes del documento CaseView, entonces deberá desactivarse dicha función en esas filas especiales.
Vaya a Inicio | Tabla | Propiedades | Fila | Propiedades personalizadas y añada una propiedad personalizada de fila de tabla denominada «Eliminar» con el valor «No». De este modo, es posible desactivar la función de eliminación de filas cuando el cursor no se encuentre en una tabla O cuando el cursor se encuentre en una fila cuya propiedad «Eliminar» tenga el valor «No». Esta es la sintaxis que debe introducir en el campo «Desactivar si »:
CVDocPos("#TN") = "" | CVDocPos("Eliminar", "TR") = "No"
Temas relacionados