Comando

Descrição do comando

Sintaxe do comando

Dialog

Inicia a definição de uma Caixa de Diálogo, informando se a posição e o tamanho da mesma estão especificados em caracteres ("chars") ou em unidades de diálogo ("units").

DIALOG <xy, yi, xl, yl>
[chars | units]

Caption

especifica o título, ou "rótulo" para o Quadro de Diálogo que está sendo definido.

CAPTION <texto>

Style

especifica os estilos da janela da Caixa de Diálogo que está sendo definida.

STYLE <dialog_style>

Help

informa o arquivo de Help associado aos controles da Caixa de diálogo, permitindo a utilização do recurso "Help in Context". Consulte os manuais específicos do software utilizado para a elaboração do Help.

HELP <arqhelp>

Font

informa o tipo e tamanho da fonte a serem utilizados na Caixa de diálogo. O tipo e o tamanho da fonte escolhida determinam as dimensões da Caixa de Diálogo assim como o número de colunas e linhas.

FONT <nome> [<tam>]

Start

Permite especificar o número seqüencial (a partir de 01) do controle, dentro da Caixa de diálogo, que, inicialmente, irá receber o foco. (Qualquer controle pode ser focalizado, dinamicamente, através do comando FocusControl).

Start <numc>

Verify

Invoca uma função lógica, passando, como parâmetros, variáveis existentes dentro e fora do Quadro de Diálogo. A função invocada retorna um valor lógico (.t. ou .f.). O comando Verify está associado a uma Caixa de diálogo como um todo, diferente do comando Valid, associado a um controle específico.
O comando Verify é codificado, geralmente, antes do EndDialog e serve para fazer uma validação global de todas as informações da Caixa de Diálogo em questão.

VERIFY <func>(<parm1>, ... <parmn>)

Init

Especifica uma função que será invocada na inicialização da Caixa de diálogo, permitindo, assim, agrupar procedimentos a serem executados automaticamente sobre quaisquer dos controles da mesma.

INIT <func>(<parm1>, ... <parmn>)

Cancel

Especifica uma função que será invocada quando for acionada a tecla ESC ou quando for fechada a janela do diálogo teclando o ícone X que aparece no canto superior direito.

CANCEL <func>(<parm1>, ... <parmn>)

CheckBox

apresenta uma lista de itens, precedidos por um pequeno quadrado ("Check Box"), permitindo "checar", ou seja, marcar uma ou mais opções da lista.

CheckBox <nome> <varl> <xi>,<yi>,<xl>,<yl> [<comum>]

ListBox

Exibe uma lista com um ou mais itens a serem selecionados pelo usuário. A opção <vetmsg> especifica um vetor, cujos elementos são as mensagens associadas aos elementos correspondentes no vetor da ListBox. Essas mensagens serão exibidas na barra de status quando o elemento correspondente na ListBox for selecionado com um "click" do mouse.

• Um "click" permite acionar a função associada com a opção Select, se existir.
• Dois "clicks" invocam a função associada com a opção DblClk, se existir..

ListBox <vetc> <varn> <xi>,<yi>,<xl>,<yl> [<estilo>] [<comum>]

EditText

mostra uma área onde o usuário pode codificar uma nova informação ou modificar uma informação existente. Os estilos e as Pictures, associados a este controle, permitem um bom gerenciamento do seu conteúdo.

EditText NULL <varc> <xi>,<yi>,<xl>,<yl> [<comum>]

RichEdit

Permite a visualização e impressão de arquivos .TXT e .RTF. O parâmetro <arq> é a variável que contém o nome do arquivo. Os comandos PrintControl ou PrintControlId são utilizados para imprimir o arquivo visualizado pelo controle RichEdit.

RichEdit NULL <arq> <xi>,<yi>,<xl>,<yl> [<comum>]

ComboBox

Através da combinação de ListBox e EditBox, o controle ComboBox apresenta uma lista de itens, sendo permitido selecionar, modificar um dos itens assim como incluir novas informações. A opção <vetmsg> permite associar uma mensagem para a cada elemento da ComboBox, a ser exibida na linha de status.

• Um "click" permite acionar a função associada com a opção Select, se existir.
• Dois "clicks" invocam a função associada com a opção DblClk, se existir..

ComboBox <vetc> <varc> <xi>,<yi>,<xl>,<yl> [<comum>]

GroupBox

Serve para agrupar vários controles numa DialogBox. A área que contém esse grupo de controles fica cercada por uma borda, sendo mostrado, na parte superior esquerda da GroupBox , o texto especificado em <nome>.

GroupBox <nome> <varl> <xi>,<yi>,<xl>,<yl> [<comum>]

RadioButton

exibe uma lista de itens, precedidos de pequenos círculos, para permitir marcar uma, e apenas uma, das opções da lista, que são mutuamente exclusivas. Os "RadioButtons" são agrupados em controles GroupBox.

RadioButton <nome> NULL <xi>,<yi>,<xl>,<yl> [<comum>]

Ctext

exibe o texto <texto> centralizado no retângulo <xi,yi,xl,yl>

[ID <expc>] [ENABLE|DISABLE] [CONTEXTid(<num>)]
[font (<font>,<tam>)]

Ltext

exibe o texto <texto> alinhado à esquerda no retângulo <xi,yi,xl,yl>

[ID <expc>] [ENABLE|DISABLE] [CONTEXTid(<num>)]
[font (<font>,<tam>)]

Rtext

exibe o texto <texto> alinhado à direita no retângulo <xi,yi,xl,yl>

[CONTEXTid(<num>)]
[font (<font>,<tam>)]

VarText

exibe o conteúdo da variável cadeia <varc> no retângulo <xi,yi,xl,yl>. O gerenciamento da variável <varc> é dinâmico, podendo seu conteúdo ser "refrescado" a qualquer momento enquanto estiver ativa sua caixa de diálogo. Esta característica dinâmica constitui a diferença deste comando em relação aos comandos Ctext, Ltext e Rtext.

VarText NULL <varc> <xi>,<yi>,<xl>,<yl> [<comum>]

Icon

exibe o ícone contido no arquivo <icon> na posição indicada pelas coordenadas <xi,yi>, que será identificado pelo número <num>. Cada comando icon, dentro de um mesmo programa OpusWin, deve especificar um <num> diferente. A largura e altura devem ser especificadas com o valor zero. O controle <icon> deve ser especificado por último, após os comandos PushButton.

Icon <icon> <num> <xi>,<yi>,0,0

Image

exibe a imagem especificada através da variável <varc> na posição indicada pelas coordenadas <xi,yi,xl,yl>, dentro de uma caixa de diálogo.

[ID <expc>] [ENABLE|DISABLE]

DefPushButton

exibe um botão de comando com o status de "pressionado". O usuário pode selecioná-lo pressionando ENTER, mesmo que esse botão não esteja "focalizado".

PushButton

exibe um botão de comando a ser pressionado pelo usuário

PUSHBUTTON
<nome> | BITMAP("<bitmap>")
NULL <xi,yi,xl,yl> [<comum>]

Valid

Invoca uma função, passando como parâmetros variáveis existentes dentro e fora do ambiente do Quadro de Diálogo. A função retorna um valor lógico (.t. ou .f.). O comando Valid é associado aos controles do tipo EditText, PushButton, ListBox e ComboBox. As funções associadas a esses controles, através do comando valid, são executadas quando os controles são acionados para processamento.

VALID <func>(<parm1>, ... <parmn>)

When

A opção when <func> (<p1>, ... <pn>), associada aos controles do tipo EditText e ListBox, permite disponibilizar, condicionalmente, um controle do tipo EditBox, dependendo do valor retornado pela função lógica <func>, que poderá retornar um valor lógico (.t. ou .f.). A função associada com o comando when é executada quando o controle correspondente obtém o focus, ou seja, antes mesmo dele ser processado.

When <func>(<parm1>, ... <parmn>)

DblClk

A opção DblClk <func> (<p1>, ... <pn>), associada aos comandos ListBox e ComboBox, permite executar uma determinada função quando um dos elementos desses controles forem acionados com duplo click do mouse.

A função lógica <func> pode retornar um valor lógico .t. ou .f., permitindo terminar ou não os controles ListBox ou ComboBox associados.

DblClk <func> (<p1>, ... ,<pn>)]

Select

A opção Select <func> (<p1>, ... <pn>), associada aos comandos ListBox e ComboBox, permite executar uma determinada função quando um dos elementos desses controles forem selecionados (um click do mouse). A função lógica <func> pode retornar um valor lógico .t. ou .f., permitindo terminar ou não os controles ListBox ou ComboBox associados.

Select <func> (<p1>, ... ,<pn>)

ProgressBar

O controle ProgressBar cria uma Barra de Progressão dentro de uma Janela de diálogo. Na definição do controle ProgressBar informamos:

• limite a ser atingido (<varn1>)
• valor da progressão (<varn2>)
• As coordenadas do controle

Veja mais adiante maiores detalhes deste controle.

ProgressBar <varn1> <varn2> <xi>,<yi>,<xl>,<yl> [<observ1>]

MonthCalendar

O controle MonthCalendar permite mostrar um calendário, por mês, iniciando pela data informada no parâmetro <var>.

Veja mais adiante maiores detalhes deste controle.

MonthCalendar <expc> <var> <xi>,<yi>,<xl>,<yl> [<observ1>]

Histogram

O controle Histogram constrói uma Barra Progressiva, chamada Gauge, dentro de uma DialogBox.

<varn1> especifica o limite máximo para o Histograma. Este limite pode ser inicializado ou "resetado" através dos comandos InitControl ou InitControlId.

<varn2> estabelece um valor de incremento para o Histograma, ou seja, a maneira como o Histograma vai progredir a partir de sua posição corrente até atingir o valor especificado.

<xi,yi,xl,yl> Informa as coordenadas e tamanhos da janela (retângulo) do Histograma, especificadas em unidades de diálogo, ou seja Units.

Veja mais adiante maiores detalhes deste controle.

Histogram <varn1> <varn2> <xi>,<yi>,<xl>,<yl> [<osbserv>]

Animation

O controle Animation serve para apresentar animações, executando arquivos do tipo .AVI, dentro de uma Caixa de diálogo, onde o início e término de uma animação são controlados através do comando InitControl, geralmente codificado numa função que foi acionada através da cláusula valid. Veja exemplo a seguir.

<expc> é utilizado como título ("caption") do controle Animation.

Especifica o nome do arquivo .AVI que contém a animação a ser apresentada.

Informa as coordenadas para posicionar e dimensionar a animação a ser apresentada.

Veja mais adiante maiores detalhes deste controle.

Animation <expc> <var> <xi>,<yi>,<xl>,<yl> [<observ1>]

Grid

Especifica uma GRID para exibir e controlar:

• Elementos de vetores
• Arquivos de Bancos OpenBASE
• Arquivos externos

Veja neste manual maiores detalhes a respeito deste controle.

Grid EXTERN <num> <xi>,<yi>,<xl>,<yl> [<observ1>]

Column

Especifica as colunas de uma GRID que irão conter:

• elementos de vetores
• itens de arquivos OpenBASE
• campos de arquivos externos

Veja neste manual maiores detalhes a respeito deste controle.

Column <cabn> <campon> 0,0,<xl>,<yl> [<observ1]

EndDialog

Finaliza a definição de um Quadro de Diálogo

EndDialog