TStringGrid
Previous  Top  Next

Descripción:

La clase TStringGrid maneja los controles de tipo rejilla para mostrar filas y columnas.  


Herencia:

Hereda de la clase TWinControl.  


Propiedades:

Las propiedades de la clase TWinControl.  
 
Alignments: Tipo array. Contiene las lista de los valores que definen las alineaciones de cada columna. Se pueden usar las constantes taLeftJustify, taCenter y taRightJustify.  
 
AllowEdit: Tipo lógico. Determina si se pueden editar las celdas.  
 
AllowSelect: Tipo lógico. Determina si se muestra la fila seleccionada o no.  
 
AutoExpand: Tipo lógico. Determina si la última columna se extenderá hasta el final del grid.  
 
BorderStyle: Tipo numérico. Contiene el estilo del borde de la etiqueta. Se pueden usar las constantes bsNone y bsSingle.  
 
Col: Tipo numérico. Contiene el valor de la columna seleccionada.  
 
FixedCols: Tipo lógico. Especifica si se puede cambiar el tamaño de las columnas en tiempo de ejecución.  
 
FocusStyle: Tipo numérico. Contiene el estilo de la celda seleccionada. Se pueden usar las constantes fsFlat, fsDotted, fs3D y fsAuto.  
 
Footer: Tipo array. Contiene la lista de los títulos del pie. Los valores del array deben ser de tipo cadena.  
 
FooterAlignments: Tipo array. Contiene las lista de los valores que definen las alineaciones de cada columna del pie. Se pueden usar las constantes taLeftJustify, taCenter y taRightJustify.  
 
FooterFont: Tipo TFont. Contiene la fuente que se usará para mostrar el texto del pie.  
 
FooterImageList: Tipo TImageList. Contiene las imágenes del pie.  
 
GridColor: Tipo numérico. Especifica el color de la rejilla del grid. Se pueden usar las constantes clAqua, claBlack, etc, o las constantes que representan los colores del sistema clActiveBorder, clBtnFace, etc o especificar un valor numérico que represente el color.  
 
GridHorizontal: Tipo lógico. Determina si se muestra la rejilla horizontal.  
 
GridVertical: Tipo lógico. Determina si se muestra la rejilla vertical.  
 
Header: Tipo array. Contiene la lista de los títulos de la cabecera. Los valores del array deben ser de tipo cadena.  
 
HeaderAlignments: Tipo array. Contiene las lista de los valores que definen las alineaciones de cada columna de la cabecera. Se pueden usar las constantes taLeftJustify, taCenter y taRightJustify.  
 
HeaderFont: Tipo TFont. Contiene la fuente que se usará para mostrar el texto de la cabecera.  
 
HeaderImageList: Tipo TImageList. Contiene las imágenes de la cabecera.  
 
Items: Tipo array. Contiene la lista de los valores de cada columna. El array debe ser multidimensional para mostrar varias columnas.  
 
LeftCol: Sólo lectura y tipo numérico. Contiene el valor de la primera columna visible.  
 
MoveCols: Tipo lógico. Especifica si se puede cambiar el orden de las columnas de la cabecera y del pie en tiempo de ejecución.  
 
MultiLine: Tipo lógico. Determina si el texto se visualizará en varias líneas. La división de las líneas se hace por cada par de caracteres Chr( 13 )+Chr( 10 ) contenido en las líneas.  
 
NormalColor: Tipo numérico. Especifica el color de las celdas sin seleccionar. Se pueden usar las constantes clAqua, claBlack, etc, o las constantes que representan los colores del sistema clActiveBorder, clBtnFace, etc o especificar un valor numérico que represente el color.  

Row: Tipo numérico. Contiene el valor de la fila seleccionada.  
 
RowHeight: Tipo numérico. Especifica la altura de las celdas.  
 
RowPos: Tipo numérico y sólo lectura. Contiene el número de orden de la fila seleccionada.  
 
RowSelect: Tipo lógico. Determina si se muestra la fila seleccionada o no.  
 
ScrollBars: Tipo numérico. Determina la visibilidad de las barras de scroll del control. Se pueden usar las constantes ssNone, ssHorizontal, ssVertical y ssBoth.  
 
SelectedFocusColor: Tipo numérico. Especifica el color de las celdas seleccionadas y con foco. Se pueden usar las constantes clAqua, claBlack, etc, o las constantes que representan los colores del sistema clActiveBorder, clBtnFace, etc o especificar un valor numérico que represente el color.  
 
SelectedFont: Tipo TFont. Contiene la fuente que se usará para mostrar el texto de las celdas seleccionadas.  
 
SelectedUnfocusColor: Tipo numérico. Especifica el color de las celdas seleccionadas y sin foco. Se pueden usar las constantes clAqua, claBlack, etc, o las constantes que representan los colores del sistema clActiveBorder, clBtnFace, etc o especificar un valor numérico que represente el color.  
 
ShowFooter: Tipo lógico. Determina si se muestra el pie.  
 
ShowHeader: Tipo lógico. Determina si se muestra la cabecera.  
 
ShowSearch: Tipo lógico. Determina si se muestra la etiqueta de los caracteres pulsados al tomar el foco.  
 
Sizes: Tipo array. Contiene la lista de las anchuras de las columnas expresadas en puntos. Los valores del array deben ser de tipo numérico.  

TopRow: Sólo lectura y tipo numérico. Contiene el valor de la primera fila visible.  
 
WordWrap: Tipo lógico. Determina si el texto se visualizará en varias líneas. La división de las líneas se hace en función de la anchura de la columna.  


Métodos:

Los métodos de la clase TWinControl.  
 
DataEof(): Devuelve .T. si se ha llegado al final de la fuente de datos y .F. en caso contrario.  
 
DataFirst(): Posiciona la fuente de datos en la primera fila. Devuelve el valor de la primera fila.  
 
DataLast(): Posiciona la fuente de datos en la última fila. Devuelve el valor de la última fila.  
 
DataMoveBy( <nDistance> ): Mueve la fila al valor especificado por nDistance. Si nDistance es positivo se avanza hacia adelante en la fuente de datos y si es negativo se avanza hacia atrás. Devuelve NIL.  
 
DataMoveTo( <nPosition> ): Posiciona la fuente de datos en la posición especificada por nPosition. Devuelve NIL.  
 
DataNext(): Desplaza la fila activa una posición hacia adelante. Devuelve NIL.  
 
DataPrev(): Desplaza la fila activa una posición hacia atrás. Devuelve NIL.  
 
DataRecordCount(): Obtiene el número total de filas para la fuente de datos.  
 
FitToCol( <oControl>, <nCol>, <lStretch> ): Ajusta la posición del control oControl a la columna nCol. Si bStretch es .T. el control modifica sus dimensiones para ajustarse a la columna.  
 
GetBookmark(): Obtiene el valor de la fila actual.  
 
GetData( <nCol> ): Obtiene el valor de la columna especificada por nCol. Si el tipo de datos no es de tipo carácter hay que usar las funciones de conversión a tipo carácter.  
 
HideEditor(): Oculta el editor de celdas.  
 
SetBookmark( <nRow> ): Asigna la fila actual.  
 
ShowEditor(): Muestra el editor de celdas.  


Eventos:

Los eventos de la clase TWinControl.  

OnChange: Se lanza cuando cambia la fila o la columna seleccionada.  
 
OnColMove: Se lanza cuando cambia el orden de alguna de las columnas de la cabecera o del pie. Recibe dos parámetros, nOldPos y nNewPos que especifican la antigua y la nueva posición de la columna que ha cambiado.  
 
OnColResize: Se lanza cuando cambia la anchura de alguna de las columnas de la cabecera o del pie. Recibe dos parámetros: nCol que indica la columna que ha cambiando y nWidth que indica la nueva anchura de la columna.  
 
OnDrawCell: Se lanza cada vez que se va a dibujar una celda. Recibe seis parámetros: nRow indica la fila actual, nCol indica la columna actual, nTextColor especifica el color del texto para la celda y nBkColor el color de fondo para la celda. Los parámetros nTextColor y nBkColor se pasan por referencia, permitiendo así su modificación en el propio evento. El quinto parámetro es oGraphic y permite especificar el icono o el bitmap de la celda. El sexto parámetro es oFont y permite cambiar el estilo de la fuente.  
 
OnEnterEditor: Se lanza cuando se muestra el editor de celdas. Recibe oEditor como parámetro.  
 
OnExitEditor: Se lanza cuando se oculta el editor de celdas. Recibe oEditor como parámetro.  
 
OnFooterClick: Se lanza cuando se hace click sobre el pie. Recibe nCol como parámetro indicando la columna sobre la que se ha hecho el click.  

OnHeaderClick: Se lanza cuando se hace click sobre la cabecera. Recibe nCol como parámetro indicando la columna sobre la que se ha hecho el click.  
 
OnSearch: Se lanza cuando se pulsan caracteres alfanuméricos. Recibe cBuffer como parámetro indicando la cadena que se va formando con las sucesivas pulsaciones hasta que se produzca una pérdida de foco. Su uso más frecuente es la implementación de búsquedas incrementales.