Buscar en este sitio


Manual de uso

Propiedades


 Width Ancho del control.
 Height Alto del control
 DisplayItemsExpanded Establece si los nodos del árbol se despliegan inicialmente expandidos
 ControlName Nombre del control
 Data Bindings 
 Data SDT conteniendo los datos que se desean cargar en el grid
 Columns SDT conteniendo la información de las columnas del grid
 KeyField Miembro del SDT de datos que identifica una fila. En tiempo de ejecución, la propiedad SelectedItem contendrá el valor del campo KeyField de la fila seleccionada

Propiedades solo de runtime

 SelectedItem Contiene el campo KeyField de la fila selccionada
 LeafIcon Establece el icono de las hojas del arbol. Por defecto es 
 FolderOpenIcon Establece el icono de un nodo abierto del arbol. Por defecto es 
 FolderClosedIcon Establece el icono de un nodo cerrado del arbol. Por defecto es 

Carga de información al grid

Datos

La información a desplegar en el grid se carga en una variable de tipo SDT (Datos) que luego se asocia al grid mediante la propiedad Data. La estrucura de éste SDT deberá ser definida por el usuario dependiendo de los datos que se deseen desplegar. Debe ser una estructura de colecciones anidadas y puede tener la cantidad de niveles de jerarquización y miembros que se desee. La única restricción es que el nombre de las colecciones debe ser “children”.



Para el caso del ejemplo, se definieron 3 niveles en la estructura (Agrupacion1, Agrupacion2, Cuenta).

Columnas

Por otra parte se debe definir de que manera se va a desplegar la información; para eso se debe cargar una variable del tipo ADGColumns (SDT que ya viene definido con el control) y su estructura es la siguiente:


En el miembro DataField se establece el mapeo con el miembro del SDT de datos de donde se obtendrá la información para la columna.

En el miembro Header se establece el título de la columna.

En el miembro Width se establece el ancho de la columna.

En el miembro DataType se estable el tipo de datos de la columna, donde los posibles valores son:
  • ADGDataType.Character. La información se desplegará alienada a la izquierda.
  • ADGDataType.Number. La información se desplegará alineada a la derecha y con formato 9.999,99
  • ADGDataType.ColoredNumber. La información se desplegará alineada a la derecha, con formato 9.999,99 y de color azul si es un valor mayor a 0 y de color rojo si es un valor menor a 0.
En el miembro Precision se establece la cantidad de cifras decimales que se desea mostrar para el caso de que la columna sea del tipo numérica.

En el miembro Align se estable la alineación del contenido que se desea para la columna. Los posibles valores son:
  • ADGColumnAlign.Center
  • ADGColumnAlign.Left
  • ADGColumnAlign.Right
El siguiente es un ejemplo de cómo sería un DataProvider de carga de columnas para un grid con cuatro columnas para el SDT de datos anterior:

ADGColumns
    {
        ADGColumn
            {
                DataField = "Nombre" // Miembro "Nombre" del SDT de datos
                Header = "Nombre"
                Width = 400
                DataType = ADGDataType.Character
                Align = ADGColumnAlign.Left
            }
        ADGColumn
            {
                DataField = "Comentario" // Miembro "Comentario" del SDT de datos
                Header = "Comentario"
                Width = 400
                DataType = ADGDataType.Character
                Align = ADGColumnAlign.Left
            }
        ADGColumn
            {
                DataField = "Conciliado" // Miembro "Conciliado" del SDT de datos
                Header = "Conciliado"
                Width = 200
                DataType = ADGDataType.ColoredNumber
                Align = ADGColumnAlign.Right
                Precision = 2
            }
        ADGColumn
            {
                DataField = "Balance" // Miembro "Balance" del SDT de datos
                Header = "Balance"
                Width = 200
                DataType = ADGDataType.ColoredNumber
                Align = ADGColumnAlign.Right
                Precision = 2
            }
    }

Actualización de la información cargada

El grid refleja automáticamente cualquier cambio que se haga desde un evento de usuario al SDT de datos. Por ej. si se desea eliminar todas las filas del grid basta con invocar al método Clear() del SDT.

Eventos

OnClick: Se ejecuta cuando el usuario hace click sobre una fila del grid.

OnDoubleClick: Se ejecuta cuando el usuario hace doble click sobre una fila del grid.