4D Doc Center : PV SET AREA PROPERTY

4D View v14

PV SET AREA PROPERTY


PV SET AREA PROPERTY ( area ; propiedad ; valor )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D View
propiedad	Entero largo	Número de la propiedad
valor	Entero largo	Valor de la propiedad

Descripción

El comando PV SET AREA PROPERTY define el valor de la propiedad indicada para el area 4D View.

Sólo se guardan las preferencias de propiedades de las áreas mostradas en la pantalla, presentes en un formulario, asociadas o no a un campo:

Se cargan cada vez que se abre un formulario que contiene el área,
Se guardan cada vez que el área se cierra.
Se pueden ubicar en el cliente o en el servidor.

Si area vale 0, el comando PV SET AREA PROPERTY se aplicará a todas las nuevas áreas 4D View. En este caso, es mejor llamarlo utilizando el Método base On Startup, ejecutado al abrir la base.

Las constantes del tema PV Propiedades área se utilizan para definir el parámetro propiedad. Para definir el parámetro valor, utilice las constantes de los temas asociados o pase un valor específico. La siguiente tabla detalla las constantes del tema PV Propiedades área y los posibles valores:

Constante	Tipo	Valor	Comentario
pv allow undo redo	Entero largo	39	Permite autorizar o no la anulación de una acción. Valores asociados: pv value on: es posible utilizar deshacer (comportamiento por defecto). pv value off: no es posible utilizar deshacer (el comando Deshacer del menú Edición está inactivo).
pv arrow keys	Entero largo	9	Permite autorizar o no el uso de las teclas de flecha para la validación de la entrada (validación y selección de la siguiente celda). La validación se efectúa sólo cuando el cursor se ubica al comienzo o al final del contenido de la celda. Valores asociados: constantes del tema PV Flechas. pv arrow keys allowed: autoriza la utilización de todas las teclas de flechas. pv top and bottom arrow keys: autoriza únicamente el uso de las teclas de flechas hacia arriba y hacia abajo. pv right and left arrow keys: permite únicamente la utilización de las teclas de flecha hacia la derecha y a la izquierda. pv arrow keys not allowed: no permite la utilización de las teclas de flechas para la validación.
pv carriage return	Entero largo	8	Permite crear una nueva línea en una misma celda (celdas multilíneas). Valores asociados: constantes del tema PV Retorno de carro. pv cr not allowed: no es posible efectuar una entrada multilíneas en el área. pv cr allowed: presionando la tecla Retorno de carro se creará una nueva línea en la celda. pv cr allowed with ctrl: presionando Ctrl+Retorno de carro (Comando+Retorno de carro en Mac OS) se crea una nueva línea en la celda. pv cr allowed with shift: presionando Mayús+Retorno de carro se creará una nueva línea en la celda.
pv column headers height	Entero largo	21	Permite leer o definir el alto de los encabezados en las columnas en el área. Valores asociados: alto de los encabezados expresado en píxeles.
pv copy hidden	Entero largo	19	Permite indicar si los elementos escondidos en el área deben tenerse en cuenta cuando se copian las celdas. Valores asociados: pv value on: los elementos ocultos (si los hay) se tienen en cuenta cuando se copian las celdas. pv value off: los elementos ocultos (si los hay) no se tienen en cuenta cuando se copian las celdas.
pv current cell highlight	Entero largo	3	Permite definir el resaltado de la celda actual en el área. Valores asociados: pv value on: la celda actual se resalta en el área, por lo tanto es visible en pantalla. pv value off: la celda actual no se resalta en el área, por lo tanto es invisible en pantalla. Por defecto, la celda activa se resalta.
pv drag allowed	Entero largo	13	Permite definir el tipo de selección que puede arrastrarse. Valores asociados: constantes del tema PV Arrastrar soltar autorizado. pv DD not allowed: ninguna selección puede arrastrarse en el área, incluso si está autorizado arrastrar y soltar. pv DD single cell: es posible arrastrar una selección con una celda única. pv DD adjacent cells: es posible arrastrar una selección con varias celdas adyacentes o una celda única. pv DD multiple cells: es posible arrastrar una selección de varias celdas (adyacentes o no) o una celda única. pv DD single row: es posible arrastrar una selección con una línea única. pv DD adjacent rows: es posible arrastrar una selección con varias líneas adyacentes o una celda única. pv DD multiple rows: es posible arrastrar una selección de varias líneas (adyacentes o no) o una línea única. pv DD single column: es posible arrastrar una selección con una columna única. pv DD adjacent columns: es posible arrastrar una selección con varias columnas adyacentes o una columna única. pv DD multiple columns: es posible arrastrar una selección con varias columnas (adyacentes o no) o una columna única. Nota: puede añadir varias constantes a la misma área. Por ejemplo, PV SET AREA PROPERTY(area; pv drag allowed; pv DD multiple cells + pv DD single column + pv DD adjacent rows) permite arrastrar una selección compuesta de celdas múltiples o una columna única o líneas adyacentes.
pv drag trigger	Entero largo	12	Permite definir el mecanismo que desencadena el arrastrar en el área. No hay un trigger específico para soltar. Valores asociados: constantes del tema PV Triggers. pv trigger none: no es posible efectuar un arrastrar en el área. pv trigger on click: la selección puede arrastrarse utilizando con un clic. pv trigger on double click: la selección puede arrastrarse utilizando con un doble clic. pv trigger on alt click: la selección puede arrastrarse utilizando una combinación Alt+clic. pv trigger on alt double click: la selección puede arrastrarse utilizando una combinación Alt+doble-clic. pv trigger on ctrl click: la selección puede arrastrarse utilizando la combinación Ctrl+clic (Comando+clic en Mac OS). pv trigger on ctrl double click: la selección puede arrastrarse utilizando la combinación Ctrl+doble-clic (Comando+doble-clic en Mac OS). pv trigger on shift click: la selección puede arrastrarse utilizando la combinación Mayús+clic. pv trigger on shift double clic: la selección puede arrastrarse utilizando la combinación Mayús+doble-clic. Nota: cuando un mismo trigger se define para arrastrar y para la selección, el trigger de arrastrar es prioritario.
pv drop allowed	Entero largo	33	Permite definir el tipo de selección que es posible soltar en el área. Valores asociados: constantes del tema PV Arrastrar soltar autorizado. pv DD not allowed: ninguna selección puede soltarse en el área, incluso si está autorizado arrastrar y soltar. pv DD single cell: es posible soltar una selección que contenga una celda única. pv DD adjacent cells: es posible soltar una selección que contenga varias celdas adyacentes o una celda única. pv DD multiple cells: es posible soltar una selección que contenga varias celdas (adyacentes o no) o una celda única. pv DD single row: es posible soltar una selección que contenga una línea única. pv DD adjacent rows: es posible soltar una selección que contenga varias líneas adyacentes o una línea única. pv DD multiple rows: es posible soltar una selección que contenga varias líneas (adyacentes o no) o una línea única. pv DD single column: es posible soltar una selección que contenga una columna única. pv DD adjacent columns: es posible soltar una selección que contenga varias columnas adyacentes o una columna única. pv DD multiple columns: es posible soltar columnas múltiples (adyacentes o no) o una columna única. pv DD 4D objects: es posible soltar un objeto 4D. Todos los tipos de campos y de variables 4D (excepto los BLOBs y las sub-tablas) pueden soltarse. Nota: es posible añadir varias constantes para una misma área. Por ejemplo, PV SET AREA PROPERTY(area; pv drop allowed;pv DD multiple cells + pv DD single column + pv DD adjacent rows) permite soltar una selección compuesta por de celdas múltiples o de una columna única o de líneas adyacentes.
pv drop mode	Entero largo	14	Permite definir la manera como la selección puede soltarse en el área. Note que esta propiedad define únicamente los modos de soltar valores en el área; la copia de los valores arrastrados (si los hay) debe manejarse por separado. Valores asociados: constantes del tema PV Modo de soltar. pv drop insert or replace: los valores soltados pueden insertarse o remplazar los valores existentes en el área. pv drop insert only: los valores soltados sólo se pueden insertar en el área. pv drop replace only: los valores soltados sólo pueden remplazar los valores existentes en el área.
pv field tag	Entero largo	17	Permite definir el separador de campo. Esta propiedad es útil únicamente durante la importación/exportación de datos. Valores asociados: código ASCII del carácter. Ejemplo: "E1Campo1", "E1Campo2", "E1Campo3"; "E2Campo4", "E2Campo5"; La coma es el separador de campo.
pv field wrapper	Entero largo	18	Permite definir el carácter de sobre de campo. Esta propiedad es útil para únicamente durante la importación/exportación de datos. Valores asociados: código ASCII del carácter. Ejemplo: "E1Campo1", "E1Campo2", "E1Campo3"; "E2Campo4", "E2Campo5"; Las comillas son los sobres de campos.
pv headers sort	Entero largo	20	Permite autorizar o prohibir la ordenación estándar de los datos cuando se hace clic en el encabezado de una columna (datos dinámicos o estáticos). Valores asociados: las siguientes constantes del tema PV Ordenar encabezados. pv sort not allowed (valor por defecto): 4D View no efectúa una ordenación estándar cuando el usuario hace clic en un encabezado de columna (la ordenación puede sin embargo ser manejada de manera personalizada por el desarrollador). pv sort allowed: 4D View efectúa una ordenación estándar cuando el usuario hace clic en un encabezado de columna. En este caso, aparece un símbolo en el encabezado para indicar el criterio de ordenación. Los clics sucesivos provocan alternamente una ordenación ascendente y descendente. Una ordenación en una columna dinámica produce una ordenación sincronizada de los otras columnas de manera que los registros conservan si estado inicial. Una ordenación de una columna estática sólo ordena esa columna.
pv hor pane count	Entero largo	11	Permite leer el número de paneles horizontales presentes en el área. Este constante sólo puede utilizarse con el comando PV Get area property. Valores devueltos: número de paneles.
pv input enter key mode	Entero largo	15	Permite definir la acción de la tecla Intro (teclado numérico) utilizada durante la entrada de datos. Valores asociados: constantes del tema PV Modo tecla intro en entrada. pv enter key standard: la tecla Intro valida la celda actual luego cambia entre selección/entrada datos en la misma celda (la celda actual no cambia). pv enter key as tab: la tecla Intro valida la celda actual luego cambia entre selección/entrada datos en la siguiente celda a la derecha. La combinación Mayús+Intro cambia entre selección/entrada datos en la siguiente celda a la izquierda. pv enter key as return: la tecla Intro valida la celda actual luego cambia entre selección/entrada datos en la siguiente celda debajo. La combinación Mayús+Intro cambia entre selección/entrada datos en la siguiente celda arriba. Nota: a diferencia de la tecla Intro, las teclas Tab y Retorno de carro provocan únicamente la selección de las celdas.
pv input trigger	Entero largo	6	Permite definir el modo de desencadenamiento de la entrada en el área. La entrada de datos sólo puede efectuarse en la celda activa. Valores asociados: constantes del tema PV Triggers: pv trigger none: la entrado de datos está inactiva (ningún evento puede activar la entrada), incluso si una tecla es permitida en el modo entrada de datos (ver la constante pv input enter key mode). La entrada de datos es, sin embargo, posible utilizando la barra del editor de fórmulas y también es posible cambiar la selección. pv trigger input key: la entrada de datos es activada por una tecla. En este caso, la navegación entre celdas sólo es posible utilizando el teclado (Tab y Mayús+Tab para moverse horizontalmente, Retorno de carro y Mayús+Retorno de carro para moverse verticalmente, o la teclas de flechas). pv trigger input on enter: la entrada de datos es activada por la tecla Intro (teclado numérico). pv trigger input on gain sel: la entrada de datos se activa en la celda que tiene el foco. En este modo, tan pronto como se selecciona la celda, toma el foco y el cursor se convierte en un cursor de entrada. pv trigger on click: la entrada de datos se activa por un clic en una celda. A diferencia de la constante pv trigger input on gain sel, no se muestra un cursor de entrada. pv trigger on double click: la entrada de datos es activada por un doble clic en una celda. Un solo clic no permite la entrada. pv trigger on alt click: la entrada de datos es activada por la combinación Alt+clic en una celda. pv trigger on alt double click: la entrada de datos es activada por la combinación Alt+doble-clic en una celda. pv trigger on ctrl click: la entrada de datos es activada por la combinación Ctrl+clic (Comando+clic en Mac OS) en una celda. pv trigger on ctrl double click: la entrada de datos es activada por la combinación Ctrl+doble-clic (Comando+doble-clic en Mac OS) en una celda. pv trigger on shift click: la entrada de datos es activada por la combinación Mayús+clic en una celda. pv trigger on shift double clic: la entrada de datos es activada por la combinación Mayús+doble-clic en una celda. Notas: Puede añadir varias constantes para el mismo trigger. Por ejemplo, PV SET AREA PROPERTY(area; pv input trigger;pv trigger on click + pv trigger on alt click) permite el uso de un clic O de Alt+clic para la entrada de datos. Cuando el mismo trigger está definido para la entrada y para la selección, el trigger de entrada es prioritario.
pv record tag	Entero largo	16	Permite definir el carácter delimitador del registro. Esta propiedad es útil únicamente durante la importación/exportación de datos. Valores asociados: código ASCII del carácter. Ejemplo : "E1Campo1", "E1Campo2", "E1Campo3"; "E2Campo4", "E2Campo5"; El punto y coma es el separador del registro (2 registros: E1 y E2).
pv resizable columns	Entero largo	4	Permite autorizar o no el redimensionamiento de la columna. Valores asociados: pv value on: las columnas en el área son redimensionables. pv value off: el tamaño de las columnas en el área no es redimensionable.
pv resizable rows	Entero largo	5	Permite autorizar o no el redimensionamiento de las líneas. Valores asociados: pv value on: las líneas en el área son redimensionables. pv value off: las líneas en el área no son redimensionables.
pv row headers width	Entero largo	22	Permite leer o fijar el ancho de los encabezados de líneas. Valores asociados: ancho de los encabezados (en píxeles).
pv saving dialog	Entero largo	37	Permite mostrar o no el mensaje de confirmación del registro del documento 4D View si ha sido modificado. Esta alerta se muestra cuando se sale de un área incluida en 4D View, no asociada a un campo de la base, (el formulario se valida o cancela). Esta propiedad no es válida para ventanas externas 4D View. Valores asociados: pv value on: se muestra el mensaje de confirmación (valor por defecto). pv value off: no se muestra el mensaje de confirmación
pv select highlight	Entero largo	1	Permite definir el resaltado de una selección de celdas en el área. Valores asociados: pv value on: las selecciones se resaltan en el área. pv value off: las selecciones no se resaltan, son invisibles en pantalla.
pv select mode	Entero largo	0	Permite definir el modo de selección permitido par el área. Valores asociados: constantes del tema PV Select mode. pv select not allowed: no es posible hacer una selección en el área (todas las celdas están deseleccionadas). La entrada de datos tampoco es permitida (el editor de fórmulas se bloquea). Sólo se pueden ver los datos. pv select single row: sólo es posible seleccionar una línea a la vez en el área. pv select adjacent rows: sólo las líneas adyacentes pueden seleccionarse en el área. pv select multiple rows: es posible seleccionar varias líneas, adyacentes o no, en el área. pv select single column: sólo una columna a la vez puede seleccionarse en el área. pv select adjacent columns: sólo es posible seleccionar columnas adyacentes en el área. pv select multiple columns: es posible seleccionar varias columnas, adyacentes o no, en el área. pv select single cell: sólo es posible seleccionar una celda a la vez en el área. pv select adjacent cells: sólo las celdas adyacentes pueden seleccionarse en el área. pv select multiple cells: es posible seleccionar varias celdas, adyacentes o no, en el área. Nota: la entrada de datos aún es posible en la selección (excepto durante el uso de la constante pv select not allowed). Si prefiere no permitir la entrada de datos en el área, debe ejecutar la instrucción PV SET AREA PROPERTY(area;pv input trigger;pv trigger none).
pv select null	Entero largo	2	Permite autorizar o no las áreas sin selección actual. Valores asociados: pv value on: no es obligatorio tener una selección en el área. Por ejemplo, si la columna o la línea contiene la celda activa se elimina, ya no hay más selección en el área. pv value off: es obligatorio tener una selección en el área.
pv select trigger	Entero largo	7	Permite definir el modo de desencadenamiento de la selección en el área. Valores asociados: constantes del tema PV Triggers: pv trigger none: no es posible definir una selección en el área. Es posible introducir datos en la selección que estaba activa antes de la ejecución del comando. Las teclas Tab y Retorno de carro modifican la posición de la celda activa en la selección. pv trigger select on arrow: permite definir una selección (celda activa únicamente) utilizando las teclas flechas. No es posible extender o reducir una selección. pv trigger select on tab: permite definir una selección (celda activa únicamente) utilizando la tecla Tab o la combinación Mayús+Tab. No es posible extender o reducir una selección. pv trigger select on return: permite definir una selección (celda activa únicamente) utilizando la tecla Retorno de carro. No es posible extender o reducir una selección. pv trigger on click: permite definir una selección vía un clic. pv trigger on double click: permite definir una selección (celda activa únicamente) vía un doble-clic. No es posible extender o reducir una selección. pv trigger on alt click: permite definir una selección utilizando la combinación Alt+clic. pv trigger on alt double click: permite definir una selección utilizando la combinación Alt+doble-clic pv trigger on ctrl click: permite definir una selección utilizando la combinación Ctrl+clic (Comando+clic on Mac OS). pv trigger on ctrl double click: permite definir una selección utilizando la combinación Ctrl+doble-clic (Comando+doble-clic en Mac OS). pv trigger on shift click: permite definir una selección utilizando la combinación Mayús+clic. pv trigger on shift double clic: permite definir una selección utilizando la combinación Mayús+doble-clic. Notas: Puede añadir varias constantes para un mismo trigger. Por ejemplo, PV SET AREA PROPERTY(area; pv select trigger;pv trigger on click + pv trigger on alt click) permite el uso de un clic O un Alt+clic para la selección. Cuando un mismo trigger se define para la entrada y para la selección, el trigger de entrada es prioritario. Cuando el mismo trigger se define para arrastrar y para la selección, el trigger de arrastrar es prioritario.
pv show borders toolbar	Entero largo	29	Permite mostrar u ocultar la barra de herramientas Bordes de 4D View en el área. Valores asociados: pv value on: se muestra la barra de herramientas Bordes. pv value off: se oculta la barra de herramientas Bordes.
pv show column headers	Entero largo	23	Permite mostrar u ocultar los encabezados de columnas en el área. Valores asociados: pv value on: se muestran los encabezados de las columnas. pv value off: se ocultan los encabezados de las columnas.
pv show formula toolbar	Entero largo	30	Permite mostrar u ocultar la barra de herramientas Fórmulas de 4D View en el área. Valores asociados: pv value on: la barra de herramientas Fórmulas se muestra. pv value off: la barra de herramientas Fórmulas se oculta.
pv show hor grid	Entero largo	31	Permite mostrar u ocultar la rejilla horizontal de 4D View en el área. Valores asociados: pv value on: se muestra la rejilla horizontal. pv value off: se oculta la rejilla horizontal.
pv show hor scrollbar	Entero largo	34	Permite mostrar u ocultar la barra de desplazamiento horizontal del área. Valores asociados: pv value on: se muestra la barra de desplazamiento horizontal. pv value off: se oculta la barra de desplazamiento horizontal.
pv show menu bar	Entero largo	25	Permite mostrar y ocultar la barra de menús de 4D View en el área. Valores asociados: pv value on: se muestra la barra de menús. pv value off: se oculta la barra de menús.
pv show numbers toolbar	Entero largo	27	Permite mostrar u ocultar la barra de herramientas Números 4D View en el área. Valores asociados: pv value on: se muestra la barra de herramientas Números. pv value off: se oculta la barra de herramientas Números.
pv show row headers	Entero largo	24	Permite mostrar u ocultar los encabezados de líneas en el área. Valores asociados: pv value on: se muestran los encabezados de líneas. pv value off: se ocultan los encabezados de líneas.
pv show selection	Entero largo	40	Permite fijar o leer el modo de visualización de la selección en un área 4D View que no tiene el foco. Valores asociados: pv value on: la selección del área siempre permanece visible (resaltada) sin importar si el área 4D View tiene el foco. pv value off: cuando el área 4D View pierde el foco, la selección ya no es visible.
pv show standard toolbar	Entero largo	26	Permite mostrar u ocultar la barra de herramientas estándar de 4D View en el área. Valores asociados: pv value on: se muestra la barra de herramientas estándar. pv value off: se oculta la barra de herramientas estándar.
pv show style toolbar	Entero largo	28	Permite mostrar u ocultar la barra de herramientas estilo de 4D View en el área. Valores asociados: pv value on: se muestra la barra de herramientas estilo. pv value off: se oculta la barra de herramientas estilo.
pv show vert grid	Entero largo	32	Permite mostrar u ocultar la rejilla vertical de 4D View en el área. Valores asociados: pv value on: se muestra la rejilla vertical. pv value off: se oculta la rejilla vertical.
pv show vert scrollbar	Entero largo	35	Permite mostrar u oculta la barra de desplazamiento vertical 4D View del área. Valores asociados: pv value on: se muestra la barra de desplazamiento vertical. pv value off: se oculta la barra de desplazamiento vertical.
pv vert pane count	Entero largo	10	Permite leer el número de paneles verticales en el área. Esta constante sólo puede leerse utilizando el comando PV Get area property. Valores devueltos: número de paneles. Recordatorio: un panel es el área ubicada entre dos separadores (horizontal o vertical).
pv zoom factor	Entero largo	36	Permite leer o definir el valor del zoom (en porcentaje) para el área. Valores asociados: tasa de compresión entre 25 y 1000.

Ejemplo

Para congelar el tamaño de la columna en un área 4D View o para autorizar el redimensionamiento si esta función está congelada, vamos a escribir el siguiente método, que llevará a cabo esta operación "switch":

 C_INTEGER($Value) `Valor de la propiedad

 

  `Valor actual (0: congelado, 1 = autorizado)

 $Value:=PV Get area property(Area;pv resizable columns)

  `Comando en "switch": 0 <-> 1

 PV SET AREA PROPERTY(Area;pv resizable columns;Num($Value=0))