CONTROL TREE VIEW

Un control TreeView es una visualización jerárquica de información. Cada elemento en un control

TreeView consiste en texto e imágenes, que pueden ser manipulados durante el tiempo de ejecución del
programa.

Propiedad TreeView Tipo de datos Descripción

Acelerador
Entero Especifica el valor ASCII de la tecla del acelerador que
desea usar para el control.

AccesibleDescripción
Cuerda Una descripción del control y / o su propósito para el uso
de herramientas de accesibilidad, como lectores para
usuarios con discapacidades visuales.

AccessibleName
Cuerda Una etiqueta que describe brevemente el control, como
el texto de un botón o el nombre de un elemento del
menú.

AccessibleRole
AccessibleRole Describe qué tipo de elemento de interfaz de usuario es
(enumerado) el control.

BackColor
Largo Especifica el valor numérico del color de fondo: de 2 a
16.777.215. Para obtener más información sobre el
color, consulte la función RGB en la Referencia de
PowerScript .

Frontera
Booleano Especifica si el control tiene un borde. Los valores son:
 TRUE - El control tiene un borde.
 FALSO - El control no tiene un borde.

Estilo de borde
BorderStyle Especifica el estilo de borde del control. Los valores son:
(enumerado)
 StyleBox!
 StyleLowered!
 StyleRaised!
 StyleShadowBox!

BringToTop
Booleano Especifica si PowerBuilder mueve el control a la parte
superior del orden de adelante hacia atrás. Los valores
son:
 TRUE - El control está encima de otros controles.
 FALSO - El control no está encima de otros controles.
Propiedad TreeView Tipo de datos Descripción

CheckBoxes Booleano Especifica si las imágenes de estado se reemplazan por

casillas de verificación. Las casillas de verificación están
desactivadas por defecto. El control TreeView procesa la
entrada del mouse y del teclado para alternar el estado
verificado. Los valores son:
 TRUE - Se muestran casillas de verificación.
 FALSO : no se muestran casillas de verificación.
El estado de la casilla de verificación de un elemento se
puede determinar al verificar el índice de imagen de
estado para el artículo:
 Desmarcado = 1
 Comprobado = 2

ClassDefinition PowerObject Un objeto de tipo PowerObject que contiene información

sobre la definición de clase del objeto o control.

Eliminar objetos
Booleano Especifica si el usuario puede eliminar un elemento
TreeView de un control TreeView utilizando la tecla
Eliminar. Los valores son:
 VERDADERO - El usuario puede eliminar elementos
del control.
 FALSE : el usuario no puede eliminar elementos del
control.

DisableDragDrop
Booleano Disable Drag Drop Drop determina si los eventos para
arrastrar, como BeginDrag, se desencadenan cuando el
usuario hace clic en un elemento y se arrastra. Los
valores son:
 TRUE - Los eventos de arrastre no se disparan.
 FALSE - Se activan los eventos de arrastre.

DragAuto
Booleano Especifica si PowerBuilder coloca el control
automáticamente en modo Arrastre. Los valores son:
 TRUE - Cuando se hace clic en el control, el control se
encuentra automáticamente en modo Arrastre.
 FALSO : cuando se hace clic en el control, el control
no está automáticamente en modo Arrastre. Tienes
que poner el control manualmente en modo Drag
usando la función de arrastre.
En cualquier caso, DisableDragDrop debe establecerse
en falso para que se produzca el arrastre.

DragIcon
Cuerda Especifica el nombre del icono de existencias o el
archivo que contiene el icono que desea mostrar cuando
Propiedad TreeView Tipo de datos Descripción

el usuario arrastra el control (el archivo ICO ). El icono

predeterminado es un cuadro del tamaño del control.
Cuando el usuario arrastra el control, el ícono se
muestra cuando el control está sobre un área en la que
se puede descartar el control (un área de descarte
válida). Cuando el control se encuentra sobre un área
que no es un área de caída válida, aparece el ícono de
No-Drop.

EditLabels
Booleano Especifica si el usuario puede editar las etiquetas de los
elementos en un control haciendo clic en un elemento
seleccionado. Los valores son:
 VERDADERO - El usuario puede editar etiquetas de
elementos.
 FALSE : el usuario no puede editar las etiquetas de los
elementos.

Habilitado
Booleano Especifica si el control está habilitado (se puede hacer
clic en él). Los valores son:
 TRUE - Se puede hacer clic en Control.
 FALSE : no se puede hacer clic en Control.

FaceName
Cuerda Especifica el nombre del tipo de letra en el que se
muestra el texto del control (por ejemplo, arial o courier).

FontCharSet
FontCharSet Especifica el conjunto de caracteres de fuente utilizado
(enumerado) para el texto en el control. La aplicación debe ejecutarse
en una versión adecuada de PowerBuilder en un
sistema operativo que admita el juego de caracteres
seleccionado. Para obtener una lista completa de
valores posibles, consulte la lista de propiedades de la
variable FontCharSet en la pestaña Enumerated del
navegador.

Familia tipográfica
FontFamily Especifica la familia de fuentes (tipo de letra) utilizada
(enumerado) para el texto en el control. Los valores son:
 AnyFont!
 ¡Decorativo!
 ¡Moderno!
 ¡Romano!
 ¡Guión!
 ¡Suizo!
Propiedad TreeView Tipo de datos Descripción

FontPitch
FontPitch Especifica el paso de la fuente para el texto en el
(enumerado) control. Los valores son:
 ¡Defecto!
 ¡Fijo!
 ¡Variable!

FullRowSelect Booleano Especifica si la selección de fila completa está

habilitada. Los valores son:
 VERDADERO - Al hacer clic en cualquier lugar de una
fila, se selecciona toda la fila y al seleccionar cualquier
elemento en la fila, se resalta toda la fila.
 FALSO : al seleccionar un elemento en una fila, no se
resalta o selecciona toda la fila.
Esta propiedad no se puede usar junto con HasLines
= TRUE .

HasButtons
Booleano Especifica si los elementos primarios de TreeView
tienen los botones + y - asociados con ellos para indicar
si están expandidos (-) o colapsados (+). Los valores
son:
 VERDADERO - Los elementos principales tienen
botones.
 FALSO - Los artículos para padres no tienen botones.
Si SingleExpand se establece en verdadero para
especificar que solo se puede expandir un elemento, se
puede expandir más de un elemento haciendo clic en los
botones de elementos si HasButtons también
es verdadero .

HasLines
Booleano Especifica si los elementos TreeView están conectados
por líneas. Los valores son:
 VERDADERO - Los elementos están conectados por
líneas.
 FALSO : los elementos no están conectados por
líneas.

Altura
Entero Especifica la altura del control, en unidades
PowerBuilder.

Esconder selección
Booleano Especifica si el texto seleccionado permanece
seleccionado (resaltado) incluso cuando el control no
tiene foco. Los valores son
 VERDADERO - El texto no permanece resaltado.
Propiedad TreeView Tipo de datos Descripción

 FALSO - El texto permanece resaltado.

Modo IME Entero Especifica el modo de editor de método de entrada. Esta

propiedad solo es relevante para las aplicaciones que se
ejecutan en una versión japonesa de PowerBuilder.

Sangrar
Entero Especifica el tamaño, en unidades PowerBuilder, que los
elementos TreeView tienen sangría. Se aceptan valores
negativos, pero los elementos se superan más allá del
borde izquierdo del control.
La sala siempre está reservada para la imagen normal,
ya sea que se muestre o no. Una sangría de menos de
90 no tiene ningún efecto para el ancho de imagen
estándar. Establezca PictureWidth en 0 para eliminar
espacio adicional.

Itálico
Booleano Especifica si el texto en el control está en cursiva. Los
valores son:
 VERDADERO - El texto está en cursiva.
 FALSE - El texto no está en cursiva.

LayoutRTL
Booleano Especifica que el diseño del control debe ser una
imagen reflejada del diseño estándar. Los valores son:
 VERDADERO - Los elementos en el control están
justificados a la derecha
 FALSO : los elementos en el control quedan
justificados a la izquierda (predeterminado).

LinesAtRoot
Booleano Especifica si PowerBuilder conectará elementos de raíz
de TreeView con líneas. Los valores son:
 VERDADERO - El control TreeView conecta
elementos raíz con líneas cuando HasLines también
es verdadero .
 FALSO : el control no conecta elementos raíz con
líneas.

PictureHeight
Entero Especifica el tamaño, en píxeles, del alto de la imagen
del elemento TreeView.
En una secuencia de comandos, este valor solo se
puede establecer antes de agregar una imagen a la lista
de índice de la imagen.
Si la altura de la imagen es 0, PowerBuilder usa la altura
de la primera imagen agregada a la lista de índice de la
imagen.
Propiedad TreeView Tipo de datos Descripción

PictureMaskColor
Largo Especifica que el color sea transparente cuando se
utiliza en una imagen de elemento TreeView. Se usa
cuando la imagen se agrega en la inicialización o con la
función AddPicture , y se puede cambiar entre las
adiciones.

PictureName []
Cuerda Especifica los nombres de los archivos que contienen
las imágenes agregadas durante la inicialización. Se
requiere la extensión de
archivo BMP , ICO , GIF , JPG o JPEG .
No actualizado después de la inicialización.

PictureWidth
Entero Especifica el tamaño, en píxeles, del ancho de la imagen
del elemento TreeView.
En una secuencia de comandos, este valor solo se
puede establecer antes de agregar una imagen a la lista
de índice de la imagen.
Si el ancho de la imagen es 0, PowerBuilder usa el
ancho de la primera imagen agregada a la lista de índice
de la imagen.

Puntero
Cuerda Especifica el nombre del puntero de stock o el archivo
que contiene el puntero utilizado para el control.

De derecha a izquierda
Booleano Especifica que los caracteres se deben mostrar en
orden de derecha a izquierda. La aplicación debe
ejecutarse en un sistema operativo que admita la
visualización de derecha a izquierda.Los valores son:
 VERDADERO - Los caracteres se muestran en orden
de derecha a izquierda.
 FALSO : los caracteres se muestran en orden de
izquierda a derecha (valor predeterminado).

SingleExpand Booleano Especifica si solo se permite expandir el elemento

TreeView seleccionado. Un solo clic del mouse
selecciona un elemento.
 VERDADERO : cuando se selecciona un elemento, se
expande automáticamente y el elemento seleccionado
previamente se contrae automáticamente.
 FALSO : se puede expandir más de un elemento a la
vez.
Tenga en cuenta que si HasButtons = true , más de un
elemento se puede expandir a la vez haciendo clic en
los botones del elemento.
Propiedad TreeView Tipo de datos Descripción

SortType
grSortType Selecciona el método de clasificación. Los valores son:
 Ascendente! - Alfabético por etiqueta.
 ¡Descendiendo! - Inverso alfabético por etiqueta.
 UserDefinedSort! - Según el script en el evento Sort.
 Sin clasificar! - No ordenado
Cuando SortType especifica la clasificación, la
clasificación se realiza automáticamente. ¡Para Unsorted
!, puede llamar a funciones para ordenar
alfabéticamente.

StatePictureHeight
Entero Especifica el tamaño, en píxeles, para la altura de la
imagen de estado.
En una secuencia de comandos, este valor solo se
puede establecer antes de que se agregue una imagen
de estado a la lista de imágenes de estado.
Si la altura de la imagen de estado es 0, PowerBuilder
usa la altura de la primera imagen agregada a la lista de
índice de imágenes de estado.

StatePictureMaskColor
Largo Especifica que el color sea transparente cuando se
utiliza en una imagen de estado. Se usa cuando la
imagen se agrega en la inicialización o con la función
AddStatePicture, y se puede cambiar entre las
adiciones.

StatePictureName []
Cuerda Especifica el nombre de la imagen utilizada como
imagen de estado. La imagen de estado se muestra a la
izquierda de la imagen normal. El elemento se desplaza
hacia la derecha para hacer espacio para ello.
La imagen puede ser un icono, cursor o mapa de bits
proporcionado por el usuario o una imagen de stock de
la biblioteca de PowerBuilder. No actualizado después
de la inicialización.

StatePictureWidth
Entero Especifica el tamaño en píxeles para el ancho de la
imagen de estado.
En una secuencia de comandos, este valor solo se
puede establecer antes de que se agregue una imagen
de estado a la lista de imágenes de estado.
Si el ancho de la imagen de estado es 0, PowerBuilder
usa el ancho de la primera imagen agregada a la lista de
índice de imágenes de estado.
Propiedad TreeView Tipo de datos Descripción

TabOrder
Entero Especifica el valor de tabulación del control dentro de la
ventana (0 significa que el usuario no puede tabular el
control).

Etiqueta
Cuerda Especifica el valor de etiqueta asignado al control.

Color de texto
Largo Especifica el valor numérico del color utilizado para el
texto: de -2 a 16.777.215.

Tamano del texto

Entero Especifica el tamaño del texto en el control, en puntos.
Para compatibilidad con versiones anteriores, el tamaño
se almacena como un número negativo; por ejemplo, el
tamaño de texto de 10 puntos se almacena como -10.

Información sobre Booleano Especifica si la etiqueta de un elemento se debe mostrar

herramientas en una información sobre herramientas si la etiqueta
está cortada por el borde derecho del control. Los
valores son:
 TRUE - La información sobre herramientas que
muestra el texto de la etiqueta se muestra cuando la
etiqueta está cortada en el lado derecho. Este es el
predeterminado.
 FALSE : la información sobre herramientas no se
muestra.

TrackSelect Booleano Especifica si los elementos aparecen en un color

diferente cuando el mouse se mueve sobre ellos
(seguimiento en caliente). Los valores son:
 TRUE - Un elemento cambia de color cuando el mouse
se mueve sobre él.
 FALSO : un elemento no cambia de color cuando el
mouse se mueve o hace una pausa sobre él.

Subrayar
Booleano Especifica si el texto en el control está subrayado. Los
valores son:
 VERDADERO - El texto está subrayado.
 FALSO - El texto no está subrayado.

Visible
Booleano Especifica si el control es visible. Los valores son:
 TRUE - El control está visible.
 FALSO - El control no está visible.
Propiedad TreeView Tipo de datos Descripción

Peso
Entero Especifica el peso del trazo del texto en el control; por
ejemplo, 400 para normal o 700 para negrita.

Anchura
Entero Especifica el ancho del control, en unidades
PowerBuilder.

X
Entero Especifica la posición X (la distancia desde el borde
izquierdo de la ventana), en unidades PowerBuilder.

Y
Entero Especifica la posición Y (la distancia desde la parte
superior de la ventana), en unidades PowerBuilder.
EJEMPLO DE UN TREE VIEW
Para este ejemplo se utilizó una base de datos de empleados, como también el
Control TreeView y un DataWindow
Workspace
 Work_1

Window
 W_treeview

DataWindow de tipo Grid

 Dw_empleado
 Dw_emplvstra
 Dw_location
 Dw_pais
 Dw_region
 Dw_trabajo

Control TreeView
 Tv_1

DataWindow
 Dw_1
Evento open() de la ventana w_treeview

Se declaran dos variables de instancia de tipo integer: Fila1,fila2.

La función “InsertItemLast( ‘ubicación’ , ‘ label ‘ , ‘ posicion’ )
El número “0” nos indica que son los padres.
El script tv_1.insertItemLast(fila,1”empleado”,2), nos indica que se va insertar Empleado
en la fila1 y como su hijo. Lo mismo sucede con los demás a diferencia que en “fila2” que
sería el padre de “Region,Pais y Locación”
Eveneto selectionchanged() del control TreeView
VENTANA DW_TREEVIEW

Seleccionando el subItem de Empleado y ocupación.

Seleccionando el subItem de Ubicación