Toolbar form windows

4D v15

Originalmente introduzido em 4D v14 R5

4D v14 R5 inclui uma série de implementações destinadas a ajudar aos desenvolvedores a projetar e administrar barras de ferramentas personalizadas. As barras de ferramentas são janelas com propriedades específicas em quanto a sua posição e tamanho.

Os seguintes comandos suportam a criação e a gestão de barras de ferramentas:

Open form window: aceita o novo tipo Toolbar form window
Tool bar height: devolve a altura da barra de ferramentas personalizada
HIDE TOOL BAR y SHOW TOOL BAR: anteriormente obsoletos, estes comandos foram reativados para a gestão de barras de ferramentas personalizadas.

Open form window

Tema: Janelas



	Open form window ( {aTable ;} formName {; type {; hPos {; vPos {; *}}}} ) -> Resultado

O comando Open form window agora pode criar janelas formulário de tipo Barra de ferramentas.

Uma nova constante foi adicionada ao tema "Criar janela formulário" e utilizada no parâmetro type:

Constante	Tipo	Valor
Toolbar form window	Inteiro longo	35

Quando passar a constante Toolbar form window, a janela é criada com a localização, o tamanho e as propriedades gráficas de uma barra de ferramentas, ou seja:

A janela será mostrada sempre justo debaixo da barra de menus
O tamanho horizontal da janela será ajustado automaticamente para encher todo o espaço disponível horizontal no escritório (em OS X) ou dentro da janela principal de 4D (em Windows). O tamanho vertical da janela se baseia nas propriedades do formulário, como todos os outros tipos de janelas formulário.
A janela não tem bordes, não pode se mover e não pode ser redimensionada manualmente, e HPOS, os parâmetros posH, PosV e * se ignoram se passarem.

Não é possível criar ao mesmo tempo duas janelas de barra de ferramentas diferentes. Se Criar janela formulário é chamada com o tipo Formulário janela barra de ferramentas enquanto já existe uma janela de barra de ferramentas, é gerado um erro -10613 ("Não pode criar duas janelas formulários de tipo barra de ferramentas").

Nota sobre as janelas formulário barra de ferramentas e modo tela completa OS X: se sua aplicação mostrar ao mesmo tempo uma janela barra de ferramentas e uma janela estandarte que suporta o modo tela completa (opção Com modo tela completa Mac), as regras de interface requerem que se oculte a barra de ferramentas quando uma janela estandarte entra em modo tela completa. Para saber se uma janela mudou ao modo de tela completa, simplesmente prove se seu tamanho vertical é exatamente o mesmo que a altura da tela (ver abaixo).

Altura barra de ferramentas

Tema: Windows (comando deslocado desde o tema "Interface de usuário")

Tool bar height -> Resultado

Parâmetro	Tipo		Descrição
Resultado	Inteiro longo	<-	Altura (expressada em pixels) da barra de ferramentas ou 0 se a barra de ferramentas está oculta

Este comando também funciona com as barras de ferramentas personalizadas criadas pelo comando Open form window utilizando o tipo Toolbar form window.

Este comando devolve a altura da barra de ferramentas visível atual, expressada em pixels. Pode ser a barra de ferramentas do modo Desenho de 4D, ou uma barra de ferramentas criada por Open form window, dependendo do contexto (a barra de ferramentas do modo Desenho se oculta automaticamente se mostra uma barra de ferramentas personalizada criada por Open form window).

Se a barra de ferramentas está oculta, o comando devolve 0.

HIDE TOOL BAR e SHOW TOOL BAR

Tema: Janelas (comandos deslocados desde o tema "User interface")



	SHOW TOOL BAR Não requer nenhum parâmetro HIDE TOOL BAR Não requer nenhum parâmetro

Estes comandos já não são obsoletos em 4D: agora podem ser usados para gerenciar as janelas formulário de barras de ferramentas personalizadas criadas com o comando Open form window para o processo atual.

SHOW TOOL BAR: se for aberta uma janela barra de ferramentas (chamando Open form window com a opção Toolbar form window), o comando faz com que esta janela seja visível. Se a janela barra de ferramentas já era visível ou não existe, este comando não faz nada.
HIDE TOOL BAR: se for aberta uma janela da barra de ferramentas (chamando Open form window com a opção Toolbar form window), o comando oculta esta janela. Se a janela barra de ferramentas já estava oculta ou não existe, este comando não faz nada.

Exemplo

Em OS X, que foi definido uma barra de ferramentas personalizadas uma janela estandarte com a opção Has full screen mode Mac. Quando uma janela estandarte é maximizada por um usuário enquanto é mostrada a janela de barra de ferramentas, você não deseja que a janela maximizada seja solapada pela barra de ferramentas.

Para evitar isto, no evento "On Resize" do formulário da janela estandarte, é necessário detectar quando a janela está em modo de tela completa e logo chamar a HIDE TOOL BAR:

 Case of

    :(Form event=On Resize)

       GET WINDOW RECT($left;$top;$right;$bottom)

       If(Screen height=($bottom-$top))

          HIDE TOOL BAR

       Else

          SHOW TOOL BAR

       End if

 End case

Constante Has toobar button Mac em desuso

As constantes relacionadas ao suporte ao botão barra de ferramentas do Mac OS agora são prefixadas com _O_, já que a opção correspondente entrou em desuso por Apple desde OS X 10.6:

Has toolbar button Mac (temas "Open Form Window" e "Open Window") foram renomeadas _O_Has toolbar button Mac.
On Mac Toolbar Button (temas "Form Events") foi renomeada _O_On Mac Toolbar Button.