4D v15

Toolbar form windows

Página Inicial

 
4D v15
Toolbar form windows

Toolbar form windows  


 

 

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.

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:

ConstanteTipoValor
Toolbar form windowInteiro longo35

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).

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

 

Tool bar height -> Resultado

ParâmetroTipoDescrição
ResultadoInteiro 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.

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

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Language

 
HISTÓRIA 

 
ARTICLE USAGE

4D v15 - Update (edição standard) ( 4D v15)