Controles Padrao

A aba Padrao contem os controles mais comumente utilizados. Estes sao os blocos de construcao de cada formulario.

TLabel CT_LABEL = 1

Exibe texto estatico em um formulario. Nao editavel, usado para legendas, descricoes e rotulos.

Propriedade	Tipo	Padrao	Descricao
cText	String	""	Texto de exibicao
nLeft, nTop	Numerico	0	Posicao (pixels)
nWidth	Numerico	80	Largura em pixels
oFont	Fonte	herdado	Fonte e tamanho
nClrPane	Cor	transparente	Cor de fundo

Evento	Categoria	Descricao
OnClick	Acao	Usuario clicou no rotulo
OnDblClick	Acao	Usuario clicou duas vezes
OnMouseDown	Mouse	Botao do mouse pressionado

Plataforma	Widget Nativo
Windows	STATIC (SS_LEFT)
macOS	NSTextField (nao editavel)
Linux	GtkLabel

// sintaxe de comando xBase
@ 10, 20 SAY oLabel PROMPT "Nome:" OF oForm SIZE 80

TEdit CT_EDIT = 2

Campo de entrada de texto de linha unica. O principal controle de formularios de entrada de dados.

Propriedade	Tipo	Padrao	Descricao
cText	String	""	Conteudo do texto atual
lReadOnly	Logico	.F.	Impede edicao do usuario
lPassword	Logico	.F.	Mascara entrada com pontos
nWidth, nHeight	Numerico	120, 24	Tamanho

Evento	Categoria	Descricao
OnChange	Acao	Conteudo do texto alterado
OnClick	Acao	Controle clicado
OnEnter	Foco	Controle recebeu foco
OnExit	Foco	Controle perdeu foco
OnKeyDown	Teclado	Tecla pressionada

Plataforma	Widget Nativo
Windows	EDIT (ES_AUTOHSCROLL)
macOS	NSTextField
Linux	GtkEntry

// sintaxe de comando xBase
@ 10, 100 GET oEdit VAR "John Doe" OF oForm SIZE 200, 24

TMemo CT_MEMO = 24

Editor de texto multi-linha. Suporta quebra de linha e barras de rolagem.

Propriedade	Tipo	Padrao	Descricao
cText	String	""	Conteudo de texto multi-linha
lReadOnly	Logico	.F.	Impede edicao
lWordWrap	Logico	.T.	Quebra linhas longas

Plataforma	Widget Nativo
Windows	EDIT (ES_MULTILINE | WS_VSCROLL)
macOS	NSScrollView + NSTextView
Linux	GtkScrolledWindow + GtkTextView

TButton CT_BUTTON = 3

Botao de acao padrao. O controle interativo mais fundamental.

Propriedade	Tipo	Padrao	Descricao
cText	String	"Button"	Legenda do botao
lDefault	Logico	.F.	Botao padrao (Enter ativa)
lCancel	Logico	.F.	Botao cancelar (Escape ativa)
nWidth, nHeight	Numerico	88, 26	Tamanho

Evento	Categoria	Descricao
OnClick	Acao	Botao clicado
OnEnter	Foco	Botao recebeu foco
OnKeyDown	Teclado	Tecla pressionada enquanto focado

Plataforma	Widget Nativo
Windows	BUTTON (BS_PUSHBUTTON)
macOS	NSButton (NSRoundedBezelStyle)
Linux	GtkButton

// sintaxe de comando xBase
@ 240, 120 BUTTON oBtn PROMPT "&OK" OF oForm SIZE 88, 26
oBtn:OnClick := { || MsgInfo( "Clicado!" ) }

TCheckBox CT_CHECKBOX = 4

Controle de alternancia. Pode estar marcado ou desmarcado.

Propriedade	Tipo	Padrao	Descricao
cText	String	"CheckBox"	Texto do rotulo
lChecked	Logico	.F.	Estado atual da marcacao

// sintaxe de comando xBase
@ 50, 20 CHECKBOX oChk PROMPT "Ativo" OF oForm SIZE 120 CHECKED

TRadioButton CT_RADIO = 8

Seletor de exclusao mutua. Apenas um botao de radio em um grupo pode estar selecionado.

Plataforma	Widget Nativo
Windows	BUTTON (BS_AUTORADIOBUTTON)
macOS	NSButton (NSRadioButton)
Linux	GtkRadioButton

TListBox CT_LISTBOX = 7

Lista rolavel de itens selecionaveis.

Plataforma	Widget Nativo
Windows	LISTBOX (WS_VSCROLL | LBS_NOTIFY)
macOS	NSScrollView + NSTableView
Linux	GtkScrolledWindow + GtkTreeView

TComboBox CT_COMBOBOX = 5

Seletor suspenso com opcao de entrada de texto.

Propriedade	Tipo	Padrao	Descricao
nItemIndex	Numerico	-1	Indice do item selecionado (base 0)
nItemCount	Numerico	0	Numero de itens (somente leitura)

// sintaxe de comando xBase
@ 50, 20 COMBOBOX oCbx OF oForm ITEMS { "Usuario", "Administrador" } SIZE 150

TGroupBox CT_GROUPBOX = 6

Conteiner visual que agrupa controles relacionados com uma moldura rotulada.

// sintaxe de comando xBase
@ 10, 10 GROUPBOX "Opcoes" OF oForm SIZE 300, 100

TPanel CT_PANEL = 25

Painel conteiner plano. Use como fundo ou para agrupar controles sem uma borda visivel.

Plataforma	Widget Nativo
Windows	STATIC (SS_SUNKEN)
macOS	NSBox (NSBoxPrimary)
Linux	GtkFrame

TScrollBar CT_SCROLLBAR = 26

Controle de barra de rolagem horizontal ou vertical.

Propriedade	Tipo	Padrao	Descricao
nMin	Numerico	0	Valor minimo
nMax	Numerico	100	Valor maximo
nPosition	Numerico	0	Posicao atual
lHorizontal	Logico	.T.	Horizontal (ou vertical)