AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / Desarrollar una aplicación o un sitio web / Controles, ventanas y páginas / Controles: tipos disponibles / Control Tabla TreeView
  • Presentación
  • Inicializar un control Tabla TreeView
  • Agregar o modificar filas en un control Tabla TreeView
  • Agregar filas a un control Tabla TreeView
  • Modificar una fila o columna
  • Gestión de columnas calculadas
  • Operaciones en las filas y celdas
  • Eliminar una fila
  • Seleccionar una fila
  • Obtener el contenido de una fila o celda
  • Valor de la celda en la fila actual
  • Valor de una celda en una fila específica
  • Contenido de la fila actual
  • Contenido de una fila específica
  • Operaciones en la estructura jerárquica
  • Contraer todos los nodos de un control Tabla TreeView
  • Expandir todos los nodos de un control Tabla TreeView
  • Obtener el número de la fila contraída/expandida
  • Definir el estado de las nuevas filas
  • Obtener y establecer las imágenes de las filas
  • Obtener el padre o los hijos de un elemento
  • Propiedades específicas de los controles Tabla TreeView
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
Esta página explica cómo programar controles Tabla TreeView. Existen varias funciones WLanguage para manipular controles Tabla TreeView mediante programación.
Para saber más sobre estas funciones, consulte la documentación. Para obtener más información, consulte lista de funciones específicas de los controles Tabla TreeView.
Inicializar un control Tabla TreeView
Para rellenar un control Tabla TreeView mediante programación, utilice las siguientes funciones:
  • <Tabla>.AddLine, <Tabla TreeView>.AddChild, <Tabla>.InsertLine y <Tabla TreeView Table>.InsertChild: en cada fila, el valor de cada columna está separado por comas.
  • <Table>.Add y .Insert: en cada fila, el valor de cada columna está separado por TAB..Insert, <Tabla>.AddLine, <Tabla TreeView>.AddChild, <Tabla>.InsertLine o <Tabla TreeView Table>.InsertChild, la propiedad New se establece en True (de lo contrario se establece en False).
    Agregar o modificar filas en un control Tabla TreeView

    Agregar filas a un control Tabla TreeView

    Las filas no se crean automáticamente en los controles Tabla TreeView. Se debe especificar llamando a las siguientes funciones:
    .Insert, <Tabla>.InsertLine o <Tabla TreeView Table>.InsertChild: agrega una fila en el índice especificado o en el índice actual.

    Modificar una fila o columna

    El contenido de las filas y columnas de un control Tabla TreeView puede ser modificado:
    • por el usuario, introduciendo los datos directamente en las columnas. Los cambios se guardan automáticamente en el control Tabla TreeView (no se requiere ningún código adicional). La propiedad Modified se establece en True.
    • mediante programación:
      • con la función <Tabla>.Modify o <Tabla>.ModifyLine para modificar el contenido de la fila actual o de una fila determinada.
        Por ejemplo:
        TVT_CUSTOMER.Modify("MOORE" + TAB + "Vince" + TAB + "Miami")

        Observación: También puede utilizar directamente el nombre del control Tabla TreeView:
        // Modify the current row
        TVT_CUSTOMER = "MOORE" + TAB + "Vince" + TAB + "Miami"
        // Modify the COL_DAY coloumn of row 3
        COL_DAY.Modify("Wednesday" + TAB + "Off", 3)
      • especificando directamente el nombre de la columna para cambiar el contenido (como para un control Campo de entrada). Para modificar la columna de una fila determinada, se debe especificar el número de fila (índice).
        Por ejemplo:
        COL_NAME[Index] = CustomerName

        Para modificar la columna de la fila actual, no es necesario especificar el índice.
        Por ejemplo:
        COL_NAME = CustomerName

        La propiedad Modified se establece en False (se establece en True solo cuando se introducen datos en el control Tabla TreeView).

    Gestión de columnas calculadas

    La fórmula de cálculo de una columna calculada debe definirse en el evento "Visualización de una fila" de un control Tabla. Por ejemplo:
    // COL_PBT: calculated column
    // COL_UPBT and COL_QTY: columns linked to memory areas
    COL_PBT = COL_UPBT * COL_QTY
    Operaciones en las filas y celdas

    Eliminar una fila

    Para eliminar una fila, debe llamar a la función
    .Delete o .DeleteChild.
    • La sintaxis para la función
    .Delete es la siguiente:
    <TreeView Table control>.Delete([<Index>])

    Si se especifica el índice, la función
    .Delete elimina la fila que corresponde al índice. De lo contrario, se elimina la fila actual.
    Al eliminar una fila del control Tabla TreeView también se eliminan todos los valores de las columnas de esa fila.
  • La sintaxis para la función .DeleteChild es la siguiente:
    <TreeView Table control>.DeleteChild(<Parent element index>)

    Se eliminarán todos los elementos hijos de la fila que corresponde al índice especificado.
  • Seleccionar una fila

    Una fila se puede seleccionar con la función <Tabla>.SelectPlus.
    La sintaxis utilizada es la siguiente:
    <TreeView Table control>.SelectPlus([, <Index>])

    Obtener el contenido de una fila o celda

    El contenido de un control Tabla TreeView puede obtenerse:
    • para toda la fila.
    • celda por celda.

    Valor de la celda en la fila actual

    Para obtener el valor de una columna (o celda) de la fila actual, la sintaxis es la misma que la de un control Campo de entrada simple:
    <Value> = <Column_Name>
    Por ejemplo:
    // COL_QTY is a column of a TreeView Table control
    IF COL_QTY < 10 THEN
    Info("Insufficient quantity")
    END

    Valor de una celda en una fila específica

    Para obtener el valor de una columna que no se encuentra en la fila actual, se debe especificar el índice de la fila:
    <Value> = <Column name>[<Index>]
    Por ejemplo:
    // Add the total price before tax (PBT) for all the order lines
    TotalPrice = 0
    FOR Index = 1 TO TVT_ORDER.Count
    TotalPrice = TotalPrice + COL_PBT[Index]
    END

    Contenido de la fila actual

    Para obtener el contenido de la fila actual:
    <Value> = <TreeView Table control>

    Contenido de una fila específica

    Para obtener el contenido de la fila cuyo índice es <Index>, utilice la siguiente sintaxis:
    <Value> = <TreeView Table control>[<Index>]

    Observación: <Tabla>.Select devuelve el índice de la fila actual. Por ejemplo:
    // Retrieve the contents of row 10 in the TVT_CUSTOMER TreeView Table control
    CurrentRow = TVT_CUSTOMER[10]
    // Name of the selected customer
    CustomerName = COL_NAME[TVT_CUSTOMER.Select()]
    // Retrieve the contents of the current row in the TVT_CUSTOMER TreeView Table control
    CurrentRow = TVT_CUSTOMER
    Operaciones en la estructura jerárquica

    Contraer todos los nodos de un control Tabla TreeView

    Para contraer todos los nodos de un control Tabla TreeView, utilice la función <Tabla>.CollapseAll. La sintaxis es la siguiente:
    <TreeView Table control>.CollapseAll()

    Expandir todos los nodos de un control Tabla TreeView

    Para expandir todos los nodos de un control Tabla TreeView, utilice la función
    .ExpandAll. La sintaxis utilizada es la siguiente:
    <TreeView Table control>.ExpandAll()

    Obtener el número de la fila contraída/expandida

    Para obtener el número de la fila expandida o contraída, simplemente utilice el evento "Contracción/Expansión de un nodo" en el control Tabla TreeView:
    // Which row is used?
    Info(TVT_TreeViewTable[TVT_TreeViewTable])

    Definir el estado de las nuevas filas

    Puede definir el estado de la siguiente fila que se agregará a un control Tabla TreeView (contraída o expandida). Para ello, utilice la propiedad Collapsed.
    // The next added rows will be automatically collapsed
    TVT_TreeViewTable.Collapsed = True

    Obtener y establecer las imágenes de las filas

    Para obtener y establecer las imágenes de las filas de un control Tabla TreeView, utilice las siguientes propiedades:
    // Modify the images of rows in a TreeView Table control
    TVT_TreeViewTable.ExpandedImage = "OpenFolder.gif"
    TVT_TreeViewTable.CollapsedImage = "ClosedFolder.gif"

    Obtener el padre o los hijos de un elemento

    Las siguientes funciones pueden utilizarse para obtener el padre o los hijos de un elemento:
    • .GiveParent: Devuelve el "padre" de un elemento, es decir, el elemento del nivel superior.
    • .GiveChild: Devuelve los "hijos" de un elemento, es decir, los elementos del nivel inferior.
    Propiedades específicas de los controles Tabla TreeView
    Las siguientes propiedades permiten definir las características de los controles Tabla TreeView.
    AddChildDelayedDefine el procedimiento al que se llamará para rellenar una rama dinámicamente.
    CollapsedObtiene y establece el estado (contraído o expandido) de las nuevas filas agregadas a un control Tabla TreeView.
    MergeDetermina si las celdas (o títulos de las columnas) de un control Tabla TreeView están combinados y los combina si es necesario.
    ExpandedImageObtiene y establece la imagen predeterminada de una fila expandida en un control Tabla TreeView.
    CollapsedImageObtiene y establece la imagen predeterminada de una fila contraída en un control Tabla TreeView.
    MultiselectionObtiene y establece el modo de selección en un control Tabla TreeView.
    TotalNbChildrenDevuelve el número total de hijos de una rama en un control Tabla TreeView.
    SortOptionObtiene y establece las opciones para ordenar una columna en un control Tabla TreeView.
    LeftIndentObtiene y establece el espacio a la izquierda del texto en las columnas de un control Tabla TreeView.
    BrowsedItemObtiene y establece el campo utilizado para recorrer los controles Tabla TreeView automáticamente.
    SizeObtiene y establece el número de columnas de un control Tabla TreeView.
    TotalsEnabledDetermina cómo se realizan los cálculos automáticos en un control Tabla TreeView y desactiva o fuerza los cálculos automáticos en el control.

    Para ver la lista completa de las propiedades WLanguage que se pueden utilizar:
Versión mínima requerida
  • Versión 23
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 29/09/2022

Señalar un error o enviar una sugerencia | Ayuda local