Proc code - Solutions - TOOLBAR

$language

Toolbar

The file toolbar.zip contains :

• The component toolbar.frm
• A toolbar use sample "application" with :
• Start-Up Shell HG (start first form)
• Forms : HANG and HANG2 (the hangman -?- game)
• Library : BLAS (with 25 glyphs and 12 missages of the game) with $language = USA
• F1cars.txt : a sample file for the "Open" option

Is a "Non-Modal, Attached" form with only one "non-database" entity (TOOLBAR.DUMMY) with an CommandButton image field (OPT). Any button represents one option in the toolbar.

When the main form starts we must create a new instance of the toolbar form. This form wil sent a message to the main form when a option is pressed. The main form must manage this in the "ASYNCHRONOUS INTERRUPT" trigger.
 

Button Properties 

ID	Option identification
TYPE	Option type  (see table about button types and mesages)
GROUP	Group name (only for type "Group")
CLICK	Pressed or not (only for "Group" and "Check" types) On/off
STATUS	Enable/Disable

The message sent to the main form depends of the button type:
 

Available operations are:

• CreateButton(ID, image, TYPE, GROUP)
• ChangeImage(ID, image)
• ToggleButton(ID)
• EnableButton(ID)
• DisableButton(ID)
• EnableToolbar()Enable all the options excepts disable with the operation DisableButton
• DisableToolbar(). Disable all the options.
• ChangeDst(dst)
• ButtonInfo(ID)

• CLICK "On" is represented with field_video opt, "INV"
• STATUS "Disabled" is represented with field_syntax opt, "DIM"
• "Void" is reprenseted with field_syntax opt, "NED,NPR,NDI"
• Images can be a "glyph" or a file.
• If the images are "glyph", a "tip" is showed (message with the same name as the glyph).

    Is a sample of the use of the toolbar.

   When installed remember:

• Compile the Start-Up Shell
• Compile the Forms
• Compiler the Library (glyph and messages)
• Generate the .dol and .urr files (if needed...)
• It can not be tested from the IDF environment.
• Check your asn.

Toolbar

    1. 100% Uniface
    2. Criação e configuração dinâmica (não é necessário compilar como nos panels)
    3. Tipos diferentes de botões (comando, grupo e check)

O arquivo toolbar.zip contém:

• O componente toolbar.frm
• Um exemplo de aplicação usando o toolbar com:
• Start-Up Shell HG ("chama" o primeiro form)
• Forms : HANG e HANG2 (o jogo de forca)
• Library : BLAS (com 25 glyphs e 12 palavras do jogo)  com $language = USA
• F1cars.txt : um arquivo de exemplo para a opção "Open"

toolbar.frm

É um form "Non-Modal, Attached" com somente uma "non-database" entidade (TOOLBAR.DUMMY) com um CommandButton(OPT). Qualquer botão representa uma opção na barra de ferramentas.

Quando o form principal é iniciado deve ser criada uma nova instance do form da barra de ferramentas. Esse form irá mandar uma mensagem para o form principal quando uma opção for clicada. O form principal deve gerenciar isso como um trigger "ASYNCHRONOUS INTERRUPT".
 

  Botão     Propriedades 

ID	Identificação da opção
TYPE	Tipo da opção   (veja a tabela sobre tipos de botões e mensagens)
GROUP	Nome do grupo  (somente para o tipo "Group")
CLICK	Pressionado ou não (somente para os tipos "Group" e "Check) On/Off
STATUS	Enable/Disable

A mensagem enviada para o form principal depende do tipo de botão:
 

Descrição das operações disponíveis:

• CreateButton(ID, image, TYPE, GROUP) - Cria um botão na barra de ferramentas
• ChangeImage(ID, image) - Altera uma imagem associada a uma opção
• ToggleButton(ID) - Pressiona um botão
• EnableButton(ID) - Habilita um botão
• DisableButton(ID) - Desabilita um botão
• EnableToolbar() - Habilita todos os botões da barra de ferramentas(respeitando os botões desabilitados com DisableButton)
• DisableToolbar() - Disabilita todas as opções da barra de ferramentas
• ChangeDst(dst)  - Troca os destinos das mensagens
• ButtonInfo(ID) - Retorna todas as propriedades de um botão

    CLICK "On" é representado por field_video opt,"INV"
    STATUS "Disabled" é representado por field_syntax opt,"DIM"
    "Void" é representado por field_syntax opt,"NED,NPR,NDI"
    Images podem ser  um "glyph" ou um arquivo.
    Se as imagens forem "glyph", uma "dica"(tip) é exibida(mensagem com o mesmo nome do "glyph")

A "Aplicação"

    É um exemplo de uso da barra de ferramentas

    Depois de instalar lembre-se de:

• Compilar a Start-Up Shell
• Compilar os Forms
• Compilar a Library (glyph e mensagens)
• Gerar os arquivos .dol e .urr (se necessário...)
• Não pode ser testado no ambiente de desenvolvimento(IDF)
• Verifique seu asn

• A opção "Open" é desabilitada quando o jogo for iniciado. Permite trocar o conjunto de palavras.
• A opção "Start" inicia o jogo (o sistema escolhe uma palavra) que deve ser adivinhada clicando nas letras.
• Os botões "Good" e "Bad" permitem ver os acertos e erros. São um exemplo de como alterar a imagem e do uso de botões do tipo "Check".
• Os botões do "método" de pontuação são um exemplo do uso do tipo "Group".

Toolbar

    1. 100% Uniface
    2. Creació i configuració dinàmica (no és compilat com els "panels")
    3. Permet diferents tipus de butons (excluients, comandes i opcions)

    El fitxer toolbar.zip conté :

• El component toolbar.frm
• Una "aplicació" exemple d'utilització que es composa (a més del component anterior) de :
• Start-Up Shell HG (posa en marxa l'aplicació)
• Forms : HANG i HANG2 (joc)
• Library : BLAS (amb 25 glyphs i 12 missatges del joc) amb el $language = USA
• F1cars.txt : Fitxer exemple per l'opció "Open" del joc.

toolbar.frm

És un form "Non-Modal, Attached" amb una única entitat "non-database" (TOOLBAR.DUMMY) que alhora conté un únic camp (OPT) del tipus "image" representat com un "CommandButton". Cada botó representa una opció de la barra d'eines.

Al començar el programa principal al que volem assignar-li una toolbar, es crearà una nova instància d'aquest form i quan l'usuari premi cadascun d'ells s'envia un missatge al form principal que l'ha de gestionar al trigger "ASYNCHRONOUS INTERRUPT".
 

Propietats dels botons

ID	Identificació del botó
TYPE	Tipus de botó (ver taula de tipus de botons i missatges)
GROUP	Nom del grup al que pertany (només pel tipus "Group")
CLICK	Indica si està polsat o no (només per tipus "Group" i "Check") On/Off
STATUS	Indica si està habilitat (Enable) o no (Disable) (una opció deshabilitada no pot ser seleccionada)

El missatge que s'envia al form principal depén del tipus de botó segons la següent taula:
 

Descripció de les operacions disponibles

• CreateButton(ID, image, TYPE, GROUP). Crea un botó a la barra d'eines.
• ChangeImage(ID, image). Canvia la imatge associada a una opció
• ToggleButton(ID). "Prem" un botó
• EnableButton(ID). Habilita una opció
• DisableButton(ID). Deshabilita una opció
• EnableToolbar(). Habilita tota la barra d'eines (respetando los botones deshabilitados con DisableButton)
• DisableToolbar(). Deshabilita tota la barra d'eines.
• ChangeDst(dst). Canvia el destí dels missatges a la instància dst
• ButtonInfo(ID). Retorna totes les propietats d'una opció.

• Els botons amb CLICK "On" es representen amb field_video opt, "INV"
• Els botons amb STATUS "Disabled" es representen amb field_syntax opt, "DIM"
• Els botons tipus "Void" es reprenseten amb field_syntax opt, "NED,NPR,NDI"
• Les imatges dels botons poden ser un "glyph" o un fitxers.
• Si les imatges són "glyph", apareix el "tip" que té el mateix nom del glyph.

L' "aplicació".

    L'aplicació és el joc del forcat i està desenvolupat per demostrar l'ús de la barra d'eines.

    Per instalar-la recordeu de :

• Compilar el Start-Up Shell
• Compilar els Forms
• Compilar la Library (glyph i missatges)
• Generar els fitxers .dol i .urr (si cal)
• No pot provar-se des de l' IDF, sino com aplicació.
• Teniu en compte el fitxer asn utilitzat.

• L'opció "Open" es deshabilita quan comença el joc. Permet canviar el joc de paraules.
• L'opción "Start" comença el joc (el sistema selecciona una paraulra) que s'ha d'endevinar amb les alternatives...
• Els botons "Good" i "Bad" permeten veure els encerts i errades. Són un exemple de com canviar imatges i utilització dels tipus "Check"
• Els botons del "mètode" de puntuació són un exemple dels tipus "Group"

Toolbar

    1. 100% Uniface
    2. Creación y configuración dinámica (no versión compilada como los "panels").
    3. Diferentes tipos de botones (opciones, opciones excluyentes y "comando").

El fichero toolbar.zip contiene :
 

• El componente toolbar.frm.
• Una "aplicación" ejemplo de utilización que se compone de (además del componente anterior) :
• Start-Up Shell HG (que pone en marcha la aplicación)
• Forms : HANG y HANG2 (juego del ahorcado).
• Library : BLAS (con los glyphs -25- y mensajes -12-  del juego) con $language = USA
• F1cars.txt : Fichero ejemplo para la opción "Open" del juego.

toolbar.frm

Es un form "Non-Modal Attached" que contiene una única entidad "non-database" (TOOLBAR.DUMMY) que a su vez se compone de un único campo (OPT) del tipo "image" representada cómo "CommandButton". Cada botón representa una opción de la barra de herramientas.

Al iniciar el programa (principal) al que le queremos asignar una barra de herramientas, se creará una nueva instancia de éste form y cuando el usuario presione cada uno de ellos se le enviará un mensaje al form principal que lo gentionará en el trigger "ASYNCHRONOUS INTERRUPT".
 
 

Propiedades de los botones

ID	Identificación del botón
TYPE	Tipo de botón (ver tabla de tipos de botones y mensajes)
GROUP	Nombre del grupo al que pertenece (sólo para tipo "Group")
CLICK	Indica si está presionado o no (sólo para tipo "Group" y "Check") On/Off
STATUS	Indica si está habilitado (Enable) o no (Disable) (una opción deshabilitada no puede ser seleccionada)

El mensaje que se envia al form principal depende de tipo de botón según la siguiente tabla:
 

Descripción de las operaciones disponibles

• CreateButton(ID, image, TYPE, GROUP). Crea un botón en la barra de herramientas.
• ChangeImage(ID, image). Cambia la image asociada a una opción
• ToggleButton(ID). "Pressiona" un botón
• EnableButton(ID). Habilita una opción
• DisableButton(ID). Deshabilita una opción
• EnableToolbar(). Habilita toda la barra de herramientas (respetando los botones deshabilitados con DisableButton)
• DisableToolbar(). Deshabilita toda la barra de herramientas.
• ChangeDst(dst). Cambia el destino de los mensajes a la instancia dst
• ButtonInfo(ID). Retorna todas las propiedades de una opción.

• Los botones con CLICK "On" se representan con field_video opt, "INV"
• Los botones con STATUS "Disabled" se representan con field_syntax opt, "DIM"
• Los botones tipo "Void" se reprensetan con field_syntax opt, "NED,NPR,NDI"
• Las imágenes de los botones pueden ser un "glyph" o un fichero.
• En caso de que las imágenes sean "glyph", aparecerá el "tip" que tenga el mismo nombre del glyph.

    La aplicación es el juego del ahorcado y está desarrollada para demostrar el uso de la barra de herramientas.

    Para instalarla recordad de :

• Compilar el Start-Up Shell
• Compilar los Forms
• Compilar la Library (glyph y mensajes)
• Generar los ficheros .dol y .urr (si fuese necesario)
• No puede ser probado desde el IDF, sino como aplicación.
• Tener en cuenta el fichero asn utilizado.

• La opción "Open" se deshabilita cuando se inicia el juego. Permite cambiar el juego de palabras
• La opción "Start" comienza el juego (el sistema escoge una palabra) que debe ser adivinada pulsando la letra seleccionada.
• Los botones "Good" y "Bad" permiten ver los aciertos y fallos. Son un ejemplo de cómo cambiar la imagen y el uso de botones tipo "Check"
• Los botones del "método" de puntuación son un ejemplo de uso del tipo "Group"