TGridContainer

Cria um objeto do tipo grade, que permite a insero de outros objetos visuais em suas clulas.
Este componente no deve ser utilizado para edio de informaes.
Este componente esta disponivel em build superior a 131227A.

Hierarquia
TSrvObject -> TControl -> TGridContainer

Construtor
Sintaxe
TGridContainer():New( < anRow>, <anCol> , <anWidth> , <anHeigth> , <anRows> , <anCols>
, <aoWnd> , <alShowGrid> , <alShowHeader> , <abKeyBlock> ) --> oObjeto

Parametros
Nome

Tipo

Descrio

Obrigatrio

anRow

Numerico

Coordenada Vertical

anCol

Numerico

Coordenada Horizontal

anWidth

Numerico

Largura

anHeigth

Numerico

Altura

anRows

Numerico

Numero de linhas

anCols

Numerico

Numero de colunas

aoWnd

Objeto

Indica o controle visual

onde o componente ser
criado.

alShowGrid

Lgico

Se .T. exibe as linhas

divisrias entre as clulas

alShowHeader

Lgico

Se .T. exibe o cabealho

da Grade

abKeyBlock

Bloco de cdigo

Indica o bloco de cdigo

que ser disparado ao
pressionar apenas o
Enter e o Return

Retorno
oObjeto (objeto)
Retorna o objeto.

Exemplo

Referncia

nLines := 10
nCols := 5
oBrowse := TGridContainer():New( 01, 01, 260, 156, nLines, nCols, oPanel1, lShowGrid,
lShowHeader, {|o,nKey| pressedKey(o, nKey)} )

Mtodos
setRowsHeight
Define altura de todas as linhas da Grade.

Sintaxe
TGridContainer:setRowsHeight ( < nHeight> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nHeight

Numerico

Altura de todas as linhas

da Grade

Referncia

Exemplo
oBrowse:setRowsHeight(45) --> Nil

setRowHeight
Define altura da linha desejada.

Sintaxe
TGridContainer:setRowHeight( < nRow>, < nHeight> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nRow

Numerico

Linha a ser ajustada

nHeight

Numerico

Altura da linha

Exemplo
oBrowse:setRowHeight(2, 45) --> Nil

setColWidth

Referncia

Define a largura da coluna desejada.

Sintaxe
TGridContainer:setColWidth( < nCol>, < nWidth> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nCol

Numerico

Coluna a ser ajustada

nWidth

Numerico

Largura da coluna

Referncia

Exemplo
oBrowse:setColWidth(2, 100) --> Nil

setSpan
Aglutina linhas e colunas a fim de criar clulas compostas.

Sintaxe
TGridContainer:setSpan( < nRow>, < nCol>, < nRowSpan>, < nColSpan> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nRow

Numerico

Linha inicial a ser

aglutinada

nCol

Numerico

Coluna inicial a ser

aglutinada

nRowSpan

Numerico

Numero de Linhas para

aglutinar

nColSpan

Numerico

Numero de Colunas para

aglutinar

Exemplo
oBrowse:setSpan(3,4,3,4) --> Nil

setCellWidget
Define um objeto visual que ser inserido em determinada clula.

Sintaxe

Referncia

TGridContainer:setCellWidget( < nRow>, < nCol>, < oObjeto> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nRow

Numerico

Linha

nCol

Numerico

Coluna

oObjeto

Objeto

Objeto visual

Referncia

Exemplo
@ 029, 021 MSPANEL frameNew SIZE 143, 040 OF oDlg
@ 005, 004 SAY oSay PROMPT "TPANEL - SetCellWidget" SIZE 063, 007 OF frameNew COLORS
8421376, 16777215 PIXEL
frameNew:blClicked := {|| oBrowse:SetCurrentCell(nRow, nCol) }
oBrowse:setCellWidget(2, 2, frameNew)

setTitle
Define o titulo de determinada coluna.

Sintaxe
TGridContainer:setTitle( < nCol>, < cTitle> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nCol

Numerico

Coluna a ser ajustada

cTitle

Caracter

Titulo a ser definido para

a coluna

Exemplo
oBrowse:setTitle(2, "Novo titulo")

setCurrentCell
Posiciona o cursor na linha/coluna desejada.

Sintaxe
TGridContainer:setCurrentCell( < nRow>, < nCol> ) --> Nil

Referncia

Parametros
Nome

Tipo

Descrio

Obrigatrio

nRow

Numerico

Linha a ser posicionada

nCol

Numerico

Coluna a ser posicionada

Referncia

Exemplo
oBrowse:setCurrentCell(2, 2)

getPos
Recupera a linha/coluna selecionada.

Sintaxe
TGridContainer:getPos( < aPos> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

Referncia

aPos

Vetor

Vetor que recebera a

linha/coluna posicionada

Exemplo
aGridPos := {}
oBrowse:getPos(aGridPos)
msgAlert('Linha: ' + cValTochar(aGridPos[1])+ ' - 'Coluna: ' + cValToChar(aGridPos[2])
)

item
Insere valor em uma determinada clula.

Sintaxe
TGridContainer:item( < nRow>, < nCol>, < cText>, < nRowSpan>, < nColSpan>, < nAlign> )
--> NIL

Parametros
Nome

Tipo

Descrio

Obrigatrio

nRow

Numerico

Linha a ser utilizada

nCol

Numerico

Coluna a ser utilizada

Referncia

cText

Caracter

Texto a ser exibido na

clula

nRowSpan

Numerico

Numero de Linhas para

aglutinar

nColSpan

Numerico

Numero de Colunas para

aglutinar

nAlign

Numerico

Alinhamento para
exibio do texto da
clula

Exemplo
#define
#define
#define
#define
#define
#define

ALIGN_LEFT
1
ALIGN_LEFT_VC
2 // VC = Vertical Centered
ALIGN_CENTER
3
ALIGN_CENTER_VC 4
ALIGN_RIGHT
5
ALIGN_RIGHT_VC 6

oBrowse:item(2,2,strZero(2,3),,,ALIGN_LEFT_VC)

setAlterColor
Se definifido .T. habilita cor alternada da Grade.

Sintaxe
TGridContainer:setAlterColor( < lAlterColor> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

lAlterColor

Lgico

Se definifido .T. habilita

cor alternada da Grade

Exemplo
oBrowse:setAlterColor(.T.)

setBehavior
Define comportamento de seleo das clulas da Grade.

Sintaxe
TGridContainer:setBehavior( nComportamento )

Parametros

Referncia

Nome

Tipo

Descrio

Obrigatrio

nComportamento

Numerico

Define comportamento de
seleo de clulas

Referncia

Exemplo
oBrowse:setBehavior( 1 ) // Seleciona clula
oBrowse:setBehavior( 2 ) // Seleciona toda a linha
oBrowse:setBehavior( 3 ) // Seleciona toda a coluna

removeRow
Remove a linha desejada.

Sintaxe
TGridContainer:removeRow( < nRow> ) --> Nil

Parametros
Nome

Tipo

Descrio

Obrigatrio

nRow

Numerico

Linha a ser removida

Exemplo
oBrowse:removeRow(2)

Referncia