Docs / Referencia / Propriedades A-Z

Referencia de Propriedades A-Z

Esta pagina documenta todas as propriedades disponiveis nos controles do HarbourBuilder. As propriedades sao agrupadas por categoria e incluem o tipo da propriedade (PT_STRING, PT_NUMBER, PT_LOGICAL, PT_COLOR, PT_FONT) e os controles que suportam cada uma.

Tipos de Propriedade

Cada propriedade no Inspetor de Objetos tem um tipo associado que determina como e editada e armazenada:

Tipo	Descricao	Exemplo
`PT_STRING`	String de texto	`"Ola"`
`PT_NUMBER`	Valor numerico (inteiro ou float)	`120`
`PT_LOGICAL`	Booleano (.T. / .F.)	`.T.`
`PT_COLOR`	Valor de cor RGB	`CLR_RED` ou `"#FF0000"`
`PT_FONT`	Descritor de fonte (nome, tamanho, estilo)	`"Segoe UI", 10`

Propriedades de Aparencia

Estas propriedades controlam a aparencia de um controle na tela — cores, bordas, estilos e estado visual.

Propriedade	Tipo	Descricao	Disponivel Para
`nBackColor`	PT_COLOR	Cor de fundo do controle	Todos os controles visuais
`nFontColor`	PT_COLOR	Cor do texto (primeiro plano)	Todos os controles com texto
`cCaption`	PT_STRING	Texto exibido no controle	Button, GroupBox, Label, CheckBox, Radio, TabControl, Form
`cValue`	PT_STRING	Valor atual / conteudo de texto	Edit, Memo, MaskEdit, StaticText, LabeledEdit
`nBorderStyle`	PT_NUMBER	Estilo de borda (0=nenhuma, 1=simples, 2=elevada, 3=rebaixada)	Edit, Memo, GroupBox, Panel, Bevel, ScrollBox
`lBorder`	PT_LOGICAL	Exibir uma borda visivel ao redor do controle	Form, Panel, ScrollBox, GroupBox
`nBevelWidth`	PT_NUMBER	Largura da borda chanfrada em pixels	Bevel, Panel, GroupBox
`nBevelStyle`	PT_NUMBER	Estilo do chanfro (0=nenhum, 1=elevado, 2=rebaixado)	Bevel, Panel
`lFlat`	PT_LOGICAL	Usar aparencia plana em vez de 3D	Button, SpeedBtn, BitBtn
`nAlignment`	PT_NUMBER	Alinhamento do texto (0=esquerda, 1=centro, 2=direita)	Label, Edit, Memo, Button, StaticText
`nTextAlignment`	PT_NUMBER	Alinhamento do texto dentro dos limites do controle	Label, StaticText
`nImageIndex`	PT_NUMBER	Indice da imagem na lista de imagens associada	Button, BitBtn, SpeedBtn, Image, TabControl, TreeView, ListView
`lTransparent`	PT_LOGICAL	Fundo do controle e transparente	Label, Image, Shape, StaticText, Panel
`nShapeType`	PT_NUMBER	Forma a desenhar (0=retangulo, 1=elipse, 2=retangulo arredondado, 3=triangulo)	Shape
`nPenColor`	PT_COLOR	Cor da borda/caneta para formas	Shape, PaintBox
`nBrushColor`	PT_COLOR	Cor de preenchimento para formas	Shape, PaintBox
`nPenWidth`	PT_NUMBER	Largura da caneta/traço em pixels	Shape, PaintBox
`nPenStyle`	PT_NUMBER	Estilo da caneta (0=solido, 1=tracejado, 2=pontilhado, 3=traco-ponto)	Shape, PaintBox
`cHint`	PT_STRING	Texto de dica exibido ao passar o mouse	Todos os controles visuais
`nProgress`	PT_NUMBER	Valor de progresso atual (0 ate nMax)	ProgressBar
`nMin`	PT_NUMBER	Valor minimo para controles baseados em faixa	ProgressBar, TrackBar, UpDown, ScrollBar
`nMax`	PT_NUMBER	Valor maximo para controles baseados em faixa	ProgressBar, TrackBar, UpDown, ScrollBar
`nPosition`	PT_NUMBER	Posicao atual do slider/thumb	TrackBar, ScrollBar

Posicao e Tamanho

Estas propriedades determinam onde um controle e posicionado e qual seu tamanho.

Propriedade	Tipo	Descricao	Disponivel Para
`nLeft`	PT_NUMBER	Coordenada X da borda esquerda do controle (pixels a partir da borda esquerda do pai)	Todos os controles visuais
`nTop`	PT_NUMBER	Coordenada Y da borda superior do controle (pixels a partir do topo do pai)	Todos os controles visuais
`nWidth`	PT_NUMBER	Largura do controle em pixels	Todos os controles visuais
`nHeight`	PT_NUMBER	Altura do controle em pixels	Todos os controles visuais
`lCentered`	PT_LOGICAL	Centralizar o formulario na tela na ativacao	Form, Dialog
`nClientWidth`	PT_NUMBER	Largura da area cliente do formulario (excluindo bordas/barra de titulo)	Form
`nClientHeight`	PT_NUMBER	Altura da area cliente do formulario	Form
`lResizable`	PT_LOGICAL	Se o formulario pode ser redimensionado pelo usuario	Form, Dialog
`nMinWidth`	PT_NUMBER	Largura minima permitida ao redimensionar	Form
`nMinHeight`	PT_NUMBER	Altura minima permitida ao redimensionar	Form

Propriedades de Comportamento

Estas propriedades afetam como um controle se comporta e responde a interacao do usuario.

Propriedade	Tipo	Descricao	Disponivel Para
`lVisible`	PT_LOGICAL	Se o controle esta visivel na tela	Todos os controles visuais
`lEnabled`	PT_LOGICAL	Se o controle responde a entrada do usuario	Todos os controles visuais
`lReadOnly`	PT_LOGICAL	Conteudo nao pode ser editado pelo usuario (somente exibicao)	Edit, Memo, MaskEdit, StringGrid, DBEdit, DBMemo
`lWordWrap`	PT_LOGICAL	Quebrar texto na proxima linha quando excede a largura do controle	Label, Memo, Edit, StaticText, DBMemo
`lMultiLine`	PT_LOGICAL	Permitir multiplas linhas de texto	Edit, Button
`lPassword`	PT_LOGICAL	Mascarar caracteres de entrada (campo de senha)	Edit
`lCheck`	PT_LOGICAL	Estado marcado do controle	CheckBox, Radio
`lChecked`	PT_LOGICAL	Estado marcado (alias para lCheck em alguns controles)	CheckBox
`lSelected`	PT_LOGICAL	Se um item da lista esta selecionado	ListBox, ComboBox, TreeView, ListView, StringGrid
`nTabIndex`	PT_NUMBER	Indice de ordem de tab (determina ordem de traversia de foco)	Todos os controles focaveis
`lTabStop`	PT_LOGICAL	Se o controle pode receber foco via tecla Tab	Todos os controles focaveis
`cMask`	PT_STRING	Padrao de mascara de entrada (ex: "99/99/9999" para datas)	MaskEdit
`nInterval`	PT_NUMBER	Intervalo do timer em milissegundos	Timer
`lRunning`	PT_LOGICAL	Se o timer esta atualmente ativo	Timer
`nScrollBars`	PT_NUMBER	Estilo de barras de rolagem (0=nenhuma, 1=horizontal, 2=vertical, 3=ambas)	Edit, Memo, ScrollBox, StringGrid, DBGrid, Browse
`lAutoSize`	PT_LOGICAL	Redimensionar automaticamente o controle para caber no conteudo	Label, Image, StaticText
`lModal`	PT_LOGICAL	Se o formulario bloqueia interacao com outras janelas	Form, Dialog

Propriedades de Fonte

Propriedades relacionadas a fonte controlam a tipografia do texto exibido nos controles.

Propriedade	Tipo	Descricao	Disponivel Para
`cFontName`	PT_FONT	Nome da familia da fonte (ex: "Segoe UI", "Arial")	Todos os controles com texto
`nFontSize`	PT_NUMBER	Tamanho da fonte em pontos	Todos os controles com texto
`lFontBold`	PT_LOGICAL	Estilo de texto em negrito	Todos os controles com texto
`lFontItalic`	PT_LOGICAL	Estilo de texto em italico	Todos os controles com texto
`lFontUnderline`	PT_LOGICAL	Estilo de texto sublinhado	Todos os controles com texto
`lFontStrikeout`	PT_LOGICAL	Estilo de texto tachado	Todos os controles com texto
`oFont`	PT_FONT	Objeto de fonte completo (envolve todas as propriedades de fonte)	Todos os controles com texto

Fontes herdadas

Os controles herdam a fonte do pai por padrao. Defina oFont em um formulario para alterar a fonte de todos os controles filhos de uma vez, a menos que um filho a substitua com suas proprias configuracoes.

Propriedades de Dados

Propriedades relacionadas a vinculacao de dados, conteudo e controles conscientes de dados.

Propriedade	Tipo	Descricao	Disponivel Para
`cDataSource`	PT_STRING	Nome ou referencia ao objeto de fonte de dados	DBEdit, DBMemo, DBComboBox, DBCheckBox, DBText, DBGrid, DBNavigator, Browse
`cDataField`	PT_STRING	Nome do campo na fonte de dados para vincular	DBEdit, DBMemo, DBComboBox, DBCheckBox, DBText
`cItems`	PT_STRING	Array ou lista de itens (para controles baseados em lista)	ListBox, ComboBox, StringGrid, TreeView, ListView, TabControl
`nColCount`	PT_NUMBER	Numero de colunas em um controle de grade ou tabela	StringGrid, DBGrid, Browse
`nRowCount`	PT_NUMBER	Numero de linhas em um controle de grade ou tabela	StringGrid, DBGrid, Browse
`nCol`	PT_NUMBER	Indice da coluna selecionada atual	StringGrid, DBGrid, Browse
`nRow`	PT_NUMBER	Indice da linha selecionada atual	StringGrid, DBGrid, Browse
`nItemIndex`	PT_NUMBER	Indice do item atualmente selecionado	ListBox, ComboBox, ListView, TreeView, TabControl
`cText`	PT_STRING	Conteudo de texto do controle	Edit, Memo, Label, StaticText, LabeledEdit
`cPrompt`	PT_STRING	Texto de rotulo exibido no controle	Button, CheckBox, Radio, GroupBox
`lHeader`	PT_LOGICAL	Exibir cabecalhos de coluna em controles de grade	StringGrid, DBGrid, Browse
`cAlias`	PT_STRING	Nome do alias da tabela de banco de dados	DbfTable, MySQL, MariaDB, PostgreSQL, SQLite, Firebird, SQLServer, Oracle, MongoDB
`cTableName`	PT_STRING	Nome da tabela de banco de dados	DbfTable, MySQL, MariaDB, PostgreSQL, SQLite, Firebird, SQLServer, Oracle, MongoDB

Propriedades Especificas de Controle

Estas propriedades sao unicas para tipos de controle especificos e nao sao compartilhadas amplamente.

Propriedade	Tipo	Descricao	Disponivel Para
`nWindowState`	PT_NUMBER	Estado da janela (0=normal, 1=minimizada, 2=maximizada)	Form
`cIcon`	PT_STRING	Caminho para o arquivo de icone da janela	Form
`lMaxButton`	PT_LOGICAL	Exibir o botao de maximizar na barra de titulo	Form
`lMinButton`	PT_LOGICAL	Exibir o botao de minimizar na barra de titulo	Form
`lCloseButton`	PT_LOGICAL	Exibir o botao de fechar na barra de titulo	Form
`lSysMenu`	PT_LOGICAL	Exibir o menu do sistema (clique direito na barra de titulo)	Form
`nToolBar`	PT_NUMBER	Referencia ao objeto de barra de ferramentas associado	ToolBar
`nStatusBar`	PT_NUMBER	Referencia ao objeto de barra de status associado	StatusBar
`nTabPos`	PT_NUMBER	Posicao dos rotulos de aba (0=topo, 1=base, 2=esquerda, 3=direita)	TabControl
`lHotTrack`	PT_LOGICAL	Destacar abas ao passar o mouse	TabControl
`nStyle`	PT_NUMBER	Flags de estilo do controle (bitmask)	Todos os controles nativos
`nExStyle`	PT_NUMBER	Flags de estilo estendido (bitmask)	Todos os controles nativos
`lDoubleBuffered`	PT_LOGICAL	Usar double buffering para reduzir cintilacao	PaintBox, StringGrid, ScrollBox
`cFileName`	PT_STRING	Caminho do arquivo selecionado (para controles de dialogo)	OpenDialog, SaveDialog
`cFilter`	PT_STRING	Filtro de tipo de arquivo para dialogos (ex: "Arquivos texto\|*.txt")	OpenDialog, SaveDialog
`cApiKey`	PT_STRING	Chave de API para autenticacao do servico de IA	OpenAI, Gemini, Claude, DeepSeek, Grok
`cModel`	PT_STRING	Identificador do modelo de IA (ex: "gpt-4", "claude-3")	OpenAI, Gemini, Claude, DeepSeek, Grok
`nTimeout`	PT_NUMBER	Timeout da requisicao em milissegundos	OpenAI, Gemini, Claude, DeepSeek, Grok, HttpClient, WebSocket
`cHost`	PT_STRING	Hostname ou endereco IP do servidor	MySQL, MariaDB, PostgreSQL, SQLite, HttpClient, FtpClient, TcpServer, TcpClient, WebServer
`nPort`	PT_NUMBER	Numero da porta de rede	MySQL, MariaDB, PostgreSQL, HttpClient, FtpClient, TcpServer, TcpClient, WebServer, WebSocket
`cUserName`	PT_STRING	Nome de usuario para autenticacao	MySQL, MariaDB, PostgreSQL, FtpClient, SMTPClient
`cPassword`	PT_STRING	Senha para autenticacao	MySQL, MariaDB, PostgreSQL, FtpClient, SMTPClient
`cDatabase`	PT_STRING	Nome do banco de dados	MySQL, MariaDB, PostgreSQL, SQLite, Firebird, SQLServer, Oracle, MongoDB

Definindo Propriedades em Codigo

Propriedades podem ser definidas em codigo apos a criacao de um controle:

local oForm, oBtn, oLabel

DEFINE FORM oForm TITLE "Demo de Propriedades" ;
   SIZE 500, 350 FONT "Segoe UI", 10

--- Definir propriedades no formulario ---
oForm:lResizable     := .T.
oForm:lCentered      := .T.
oForm:nBackColor     := CLR_WHITE
oForm:lMaxButton     := .T.
oForm:lMinButton     := .T.

@ 30, 40 LABEL oLabel VALUE "Hello World" ;
   OF oForm SIZE 200, 28

--- Definir propriedades do label ---
oLabel:nFontColor   := CLR_BLUE
oLabel:lFontBold     := .T.
oLabel:nAlignment    := 1     /// centro
oLabel:cHint         := "Isto e um label"

@ 70, 40 BUTTON oBtn PROMPT "Clique Aqui" ;
   OF oForm SIZE 130, 32

--- Definir propriedades do botao ---
oBtn:nBackColor     := CLR_GREEN
oBtn:nFontColor     := CLR_WHITE
oBtn:lFlat          := .T.
oBtn:lTabStop       := .T.
oBtn:nTabIndex      := 0

ACTIVATE FORM oForm CENTERED

Definindo Propriedades no Inspetor de Objetos

No IDE HarbourBuilder, selecione qualquer controle no Designer de Formularios e alterne para a aba Propriedades no Inspetor de Objetos. As propriedades sao agrupadas por categoria:

Aparencia — Cores, bordas, legendas, imagens, dicas
Posicao — Esquerda, Topo, Largura, Altura
Comportamento — Visivel, Habilitado, SomenteLeitura, TabStop
Fonte — FontName, FontSize, Bold, Italic, Underline
Dados — Itens, DataSource, DataField (para controles conscientes de dados)
Layout — Ancoragem, alinhamento, docking

Duplo clique em um valor de propriedade para edita-lo inline. Propriedades de cor mostram um seletor de cores; fontes abrem um dialogo de fonte; propriedades logicas alternam entre .T. e .F..

Preview ao vivo

Alteracoes feitas no Inspetor de Objetos sao aplicadas a tela do Designer de Formularios em tempo real. Voce pode ver o efeito de cada alteracao de propriedade imediatamente sem recompilar.

Heranca de Propriedades

Controles herdam certas propriedades do seu container pai. A cadeia de heranca e:

graph TD A["Padroes da aplicacao"] --> B["TForm / Formulario Pai"] B --> C["Container (Panel, ScrollBox, GroupBox)"] C --> D["Controle Filho (Button, Edit, Label, etc.)"] style A fill:#58a6ff,stroke:#388bfd,color:#0d1117 style B fill:#8b5cf6,stroke:#7c3aed,color:#fff style C fill:#f59e0b,stroke:#d97706,color:#0d1117 style D fill:#3fb950,stroke:#2ea043,color:#0d1117

Propriedades que sao herdadas incluem:

cFontName, nFontSize, lFontBold, lFontItalic — Propriedades de fonte sao cascata
nBackColor — Se nao definida explicitamente, o controle usa o fundo do pai
lEnabled — Desabilitar um container pai desabilita todos os filhos
lVisible — Ocultar um pai oculta todos os filhos

Um controle filho pode substituir qualquer propriedade herdada definindo-a explicitamente.

Nesta Página

Primeiros Passos Paleta de Componentes Recursos do IDE Tutoriais Referencia Plataformas Propriedades de Aparencia Posicao e Tamanho Propriedades de Comportamento Propriedades de Fonte Propriedades de Dados Propriedades Especificas de Controle Definindo Propriedades em Codigo Definindo Propriedades no Inspetor de Objetos Heranca de Propriedades