MSFlexGrid (Control)

El control MSFlexGrid muestra datos de tablas y efectúa operaciones en

ellos. Proporciona una completa flexibilidad para ordenar, fusionar y dar
formato a tablas que contienen cadenas e imágenes. Cuando está enlazado a
un control Data, MSFlexGrid muestra únicamente datos de sólo lectura.

Sintaxis

MSFlexGrid

Comentarios

Puede introducir texto, un gráfico o ambos en cualquier celda de un

control MSFlexGrid. Las propiedades Row y Col especifican la celda actual
del control MSFlexGrid. Puede especificar la celda actual en el código o
el usuario puede cambiarla durante la ejecución del programa con el mouse
(ratón) o con las teclas de dirección. La propiedad Text hace referencia
al contenido de la celda actual.

Si el texto de una celda es demasiado grande para mostrarse en la celda y

la propiedad WordWrap está establecida a True, el texto se ajusta a la
siguiente línea de la misma celda. Para mostrar todo el texto, puede que
necesite aumentar el ancho de la columna (propiedad ColWidth) o el alto
de la fila (propiedad RowHeight).

Utilice las propiedades Cols y Rows para determinar el número de columnas

y filas del control MSFlexGrid.

Nota de distribución Antes de poder utilizar el control MSFlexGrid en

la aplicación, debe agregar el archivo MSFlxGrd.ocx al proyecto. Para
incluir el archivo en el proyecto automáticamente, colóquelo en el
archivo Autoload. Cuando distribuya la aplicación, debe instalar el
archivo MSFlxGrd.ocx en el directorio System de Microsoft Windows del
usuario. Para obtener más información acerca de cómo puede agregar un
control ActiveX a un proyecto, vea el Manual del programador.

AddItem (Método, control MSFlexGrid)

Agrega una fila a un control MSFlexGrid. No acepta argumentos con nombre.

Sintaxis

objeto.AddItem (elemento As String, índice)

La sintaxis del método AddItem tiene las partes siguientes:

Parte Descripción
objeto Expresión de objeto que da como resultado un objeto de la
lista Aplicable a.
elemento Requerido. Expresión de cadena que se muestra en la fila
recién agregada. Para agregar múltiples cadenas (en las diferentes
columnas de la fila), utilice el carácter de tabulación (vbTab) para
separar cada cadena.
índice Opcional. Dato de tipo Long que representa la ubicación del
control donde se ha colocado la fila. Para la primera fila, índice=0. Si
se omite índice, la nueva fila será la última.
Clear (Método, control MSFlexGrid)

Elimina el contenido del control MSFlexGrid. Esto incluye todo el texto,

imágenes y formato de celda. El método Clear no afecta al número de filas
y columnas del control MSFlexGrid.

Sintaxis

objeto.Clear

El marcador de posición objeto representa una expresión de objeto que da

como resultado un objeto de la lista Aplicable a.

Comentarios

Para eliminar celdas en lugar de eliminar sólo el contenido, utilice el

método RemoveItem en cada fila que desee eliminar.

Inicia, termina o cancela una operación de arrastre de cualquier control

excepto los controles Line, Menu, Shape, Timer o CommonDialog. No acepta
argumentos con nombre.

Sintaxis

objeto.Drag acción

La sintaxis del método Drag consta de las siguientes partes:

Parte Descripción

objeto Requerido. Una expresión de objeto que da como resultado un

objeto de la lista Aplicable a. Si se omite objeto, se supone que se
trata del objeto cuyo procedimiento de evento contiene el método Drag.

acción Opcional. Una constante o un valor que especifica la acción

que se va a efectuar, como se describe en Valores. Si se omite acción, la
acción predeterminada es iniciar el arrastre del objeto.
Valores

Los valores admitidos para acción son:

Constante Valor Descripción

vbCancel 0 Cancela la operación de arrastre
vbBeginDrag 1 Inicia el arrastre del objeto
vbEndDrag 2 Termina el arrastre y coloca el objeto
Comentarios

Estas constantes se enumeran en la biblioteca de objetos de Visual Basic

(VB) en el Examinador de objetos.
Sólo se requiere el método Drag para controlar una operación de arrastre
y colocación cuando la propiedad DragMode del objeto tiene el valor
Manual (0). Sin embargo, Drag puede usarse con objetos cuya propiedad
DragMode tenga el valor Automatic (1 o vbAutomatic).
Si quiere que el puntero del mouse (ratón) cambie de forma mientras se
arrastra el objeto, use las propiedades DragIcon o MousePointer. La
propiedad MousePointer sólo se usa si no se especifica DragIcon.

En versiones anteriores de Visual Basic, Drag era un método asíncrono y

las instrucciones siguientes se ejecutaban incluso aunque la acción de
arrastre no hubiera terminado.

Drag (Método)

Estas constantes se enumeran en la biblioteca de objetos de Visual Basic

(VB) en el Examinador de objetos.
Sólo se requiere el método Drag para controlar una operación de arrastre
y colocación cuando la propiedad DragMode del objeto tiene el valor
Manual (0). Sin embargo, Drag puede usarse con objetos cuya propiedad
DragMode tenga el valor Automatic (1 o vbAutomatic).
Si quiere que el puntero del mouse (ratón) cambie de forma mientras se
arrastra el objeto, use las propiedades DragIcon o MousePointer. La
propiedad MousePointer sólo se usa si no se especifica DragIcon.

En versiones anteriores de Visual Basic, Drag era un método asíncrono y

las instrucciones siguientes se ejecutaban incluso aunque la acción de
arrastre no hubiera terminado.

RemoveItem (Método)

Quita un elemento de un control ListBox o ComboBox, o una fila de un

control MS Flex Grid. No acepta argumentos con nombre.

Sintaxis

objeto.RemoveItem índice

La sintaxis del método RemoveItem consta de las siguientes partes:

Parte Descripción
objeto Requerido. Una expresión de objeto que da como resultado un
objeto de la lista Aplicable a.
índice Requerido. Un entero que especifica la posición dentro del
objeto del elemento o la fila que se va a quitar. Para los primeros
elementos de los controles ListBox o ComboBox, o para la primera fila de
un control MS Flex Grid, índice es 0.
Comentarios

Los controles ListBox o ComboBox que están enlazados a un control Data no

aceptan el método RemoveItem

Devuelve o establece un valor que indica la alineación de los datos en

una celda o en un intervalo de celdas seleccionadas. No está disponible
en tiempo de diseño.
Sintaxis

objeto.CellAlignment [= valor ]
La sintaxis de la propiedad CellAlignment tiene las partes siguientes:

Parte Descripción
objeto Expresión de objeto que da como resultado un objeto de la
lista Aplicable a.
valor Entero o constante que especifican cómo debe alinearse el texto en
las celdas, como se describe en Valores.
Valores

Los valores de valor son:

Constante Valor Descripción

flexAlignLeftTop 0 Izquierda arriba
flexAlignLeftCenter 1 Izquierda centro (predeterminado para
cadenas)
flexAlignLeftBottom 2 Izquierda superior
flexAlignCenterTop 3 Centro arriba
flexAlignCenterCenter 4 Centrado centror
flexAlignCenterBottom 5 Centro abajo
flexAlignRightTop 6 Derecha arriba
flexAlignRightCenter 7 Derecha centro (predeterminado para numeros)
flexAlignRightBottom 8 Derecha abajo
flexAlignGeneral 9 General: Izquierda centro para cadenas,
Derecha centro para números
Comentarios

En el ejemplo siguiente se establece la alineación del texto para cada

celda a Izquierda centro con el valor de la constante.

Sub Form1_Load ()
MSFlexGrid1.CellAlignment = flexAlignLeftCenter
End Sub

CellHeight, CellLeft, CellTop, CellWidth (Propiedades, control

MSFlexGrid)

Devuelve la ubicación y el tamaño de la celda activa, en twips. No está

disponible en tiempo de diseño.

Sintaxis

objeto.CellHeight
objeto.CellLeft
objeto.CellTop
objeto.CellWidth

El marcador de posición objeto representa una expresión de objeto que da

como resultado un objeto de la lista Aplicable a.

Comentarios

Estas propiedades facilitan la emulación de la modificación de celdas. Si

intercepta el evento KeyPress del control MSFlexGrid, puede colocar un
cuadro de texto o algún otro control sobre la celda actual para permitir
que el usuario edite su contenido.
Los valores devueltos siempre están en twips, independientemente del
valor de ScaleMode del formulario.

MSFlexGrid (Constantes del control)

Propiedad AllowUserResizing

Constante Valor Descripción

flexResizeNone 0 Predeterminado. No está permitido el cambio de
tamaño.
flexResizeColumns 1 El usuario puede cambiar el tamaño de columnas
individuales.
flexResizeRows 2 El usuario puede cambiar el tamaño de filas
individuales.
flexResizeBoth 3 El usuario puede cambiar el tamaño de columnas y
filas individuales.
Propiedad Appearance

Constante Valor Descripción

flexFlat 0 Establece la apariencia general del control
MSFlexGrid a normal.
flex3D 1 Establece la apariencia general del control
MSFlexGrid a tridimensional.
Propiedad BorderStyle

Constante Valor Descripción

flexBorderNone 0 Sin borde
flexBorderSingle 1 Borde simple
Propiedad CellAlignment

Constante Valor Descripción

flexAlignLeftTop 0 Izquierda arriba.
flexAlignLeftCenter 1 Izquierda centro. (Predeterminado para las
cadenas)
flexAlignLeftBottom 2 Izquierda abajo.
flexAlignCenterTop 3 Centro arriba.
flexAlignCenterCenter 4 Centrado centro.
flexAlignCenterBottom 5 Centro abajo.
flexAlignRightTop 6 Derecha arriba.
flexAlignRightCenter 7 Derecha centro. (Predeterminado para los
números)
flexAlignRightBottom 8 Derecha abajo.
flexAlignGeneral 9 General.
Propiedad CellPictureAlignment

Constante Valor Descripción

flexAlignLeftTop 0 Izquierda arriba.
flexAlignLeftCenter 1 Izquierda centro.
flexAlignLeftBottom 2 Izquierda abajo.
flexAlignCenterTop 3 Centro arriba.
flexAlignCenterCenter 4 Centro centro.
flexAlignCenterBottom 5 Centro abajo.
flexAlignRightTop 6 Derecha arriba.
flexAlignRightCenter 7 Derecha centro.
flexAlignRightBottom 8 Derecha abajo.
Propiedades CellTextStyle, TextStyle, TextStyleFixed
Constante Valor Descripción
flexTextFlat 0 Texto normal.
flexTextRaised 1 El texto aparece en relieve.
flexTextInset 2 El texto aparece incrustado.
flexTextRaisedLight 3 El texto aparece ligeramente en relieve.
flexTextInsetLight 4 El texto aparece ligeramente incrustado.
Propiedad ColAlignment

Constante Valor Descripción

flexAlignLeft 0 Alinear los datos a la izquierda de la
columna.
flexAlignRight 1 Alinear los datos a la derecha de la
columna.
flexAlignCenter 2 Centrar datos en la columna.
Propiedad FillStyle

Constante Valor Descripción

flexFillSingle 0 Cambiar el valor de la propiedad Text afecta
únicamente a la celda activa.
flexFillRepeat 1 Cambiar el valor de la propiedad Text afecta
a todas las celdas seleccionadas.
Propiedad FocusRect

Constante Valor Descripción

flexFocusNone 0 Ningún rectángulo de enfoque alrededor de la
celda actual.
flexFocusLight 1 Predeterminado. Rectángulo sombreado de
enfoque alrededor de la celda actual.
flexFocusHeavy 2 Rectángulo grueso de enfoque alrededor de la
celda actual.
Propiedades GridLines, GridLinesFixed

Constante Valor Descripción

flexGridNone 0 Predeterminado para GridLines. No hay líneas
entre las celdas.
flexGridFlat 1 Establece el estilo de línea entre las
celdas a líneas normales.
flexGridInset 2 Establece el estilo de línea entre las
celdas a líneas incrustadas.
flexGridRaised 3 Predeterminado para GridLinesFixed.
Establece el estilo de línea entre las celdas a líneas con relieve.
Propiedad HighLight

Constante Valor Descripción

flexHighlightNever 0 Las celdas seleccionadas nunca se resaltan.
flexHighlightAlways 1 Predeterminado. Las celdas seleccionadas
siempre se resaltan.
flexHighlightWithFocus 2 Las celdas seleccionadas se resaltan sólo
cuando tienen el enfoque.
Propiedad MergeCells

Constante Valor Descripción

flexMergeNever 0 Predeterminado. No se efectúa ninguna
combinación.
flexMergeFree 1 Todas las filas y columnas establecidas a
MergeRow (o MergeCol) = True son libres para combinarse en cualquier
dirección.
flexMergeRestrictRows 2 Igual que combinación libre excepto que las
filas pueden combinarse sólo con las celdas de la izquierda.
flexMergeRestrict-Columns 3 Igual que combinación libre excepto
que las columnas pueden combinarse sólo con las celdas superiores.
flexMergeRestrictAll 4 Todas las filas y columnas
establecidas a MergeRow (o MergeCol) = True pueden combinarse hacia la
izquierda o hacia arriba.
Propiedad MousePointer

Constante Valor Descripción

FlexDefault 0 Contorno del control MSFlexGrid.
flexArrow 1 Puntero de flecha.
flexCross 2 Cruz.
flexIBeam 3 Forma de "I" para permitir la entrada de
texto.
flexIcon 4 Icono (un pequeño cuadrado dentro de otro).
flexSize 5 Tamaño (flecha de cuatro puntas: norte, sur,
este y oeste).
flexSizeNESW 6 Tamaño NE SO (flecha doble que apunta al
nordeste y al sudoeste).
flexSizeNS 7 Tamaño N S (flecha doble que apunta al norte
y al sur).
flexSizeNWSE 8 Tamaño NO SE (flecha doble que apunta al
noroeste y al sudeste.
flexSizeEW 9 Tamaño O E (flecha doble que apunta al oeste
y al este).
flexUpArrow 10 Flecha hacia arriba.
flexHourGlass 11 Reloj de arena (espera).
flexNoDrop 12 No colocar.
flexArrowHourglass 13 Flecha y reloj de arena.
flexArrowQuestion 14 Flecha y signo de interrogación.
flexSizeAll 15 Ajustar todo.
flexCustom 99 Puntero de estilo personalizado.
Propiedad PictureType

Constante Valor Descripción

flexPictureColor 0 Permite todo color.
flexPictureMonochrome 1 Sólo monocromo.
Propiedad SelectionMode

Constante Valor Descripción

flexSelectionFree 0 Predeterminado. Pueden seleccionarse celdas
individuales en el control MSFlexGrid.
flexSelectionByRow 1 Pueden seleccionarse filas completas de una
vez en el control MSFlexGrid.
flexSelectionByColumn 2 Pueden seleccionarse columnas completas de
una vez en el control MSFlexGrid.
Propiedad ScrollBars

Constante Valor Descripción

flexScrollBarNone 0 El control MSFlexGrid no tiene barras de
desplazamiento.
flexScrollBarHorizontal 1 MSFlexGrid tiene una barra de desplazamiento
horizontal.
flexScrollBarVertical 2 MSFlexGrid tiene una barra de desplazamiento
vertical.
flexScrollBarBoth 3 Predeterminado. MSFlexGrid barras de
desplazamiento horizontal y vertical.
Propiedad Sort

Constante Valor Descripción

flexSortNone 0 Sin ordenación.
flexSortGenenericAscending 1 Ordenación ascendente que intenta
adivinar si el texto es una cadena o un número.
flexSortGenericDescending 2 Ordenación descendente que intenta
adivinar si el texto es una cadena o un número.
flexSortNumericAscending 3 Ordenación ascendente que convierte
cadenas a números.
flexSortNumericDescending 4 Ordenación descendente que convierte
cadenas a números.
flexSortStringNoCaseAscending 5 Ordenación ascendente sin distinguir
mayúsculas y minúsculas.
flexSortStringNoCaseDescending 6 Ordenación descendente sin
distinguir mayúsculas y minúsculas.
flexSortStringAscending 7 Ordenación ascendente con distinción
de mayúsculas y minúsculas.
flexSortStringDescending 8 Ordenación descendente con distinción
de mayúsculas de minúsculas.