4D v14.3

Pop up menu

Página Inicial

 
4D v14.3
Pop up menu

Pop up menu 


 

Pop up menu ( conteudo {; padrao {; coordX ; coordY}} ) -> Resultado 
Parâmetro Tipo   Descrição
conteudo  Texto in Definição texto do menu
padrao  Inteiro longo in Número do item de menu selecionado como padrão
coordX  Inteiro longo in Coordenadas X da esquina esquerda superior
coordY  Inteiro longo in Coordenadas Y de esquina superior esquerda
Resultado  Inteiro longo in Número de item de menu selecionado

O comando Pop up menu mostra um menu pop up na localização atual do mouse ou na localização definida pelos parâmetros opcionais coordX e coordY.

Para seguir as regras de interface de usuário, em geral este comando deve chamado em resposta a um clique e se o botão do mouse ainda estiver pressionado.

Os elementos do menu pop up se definem com o parâmetro conteudo, da maneira abaixo:

  • Cada elemento se separa dos outros por um ponto e vírgula (;). Por exemplo, "Element1;Element2;Element3".
  • Para desativar um elemento, coloque um parênteses aberto (() no texto do elemento.
  • Para definir uma linha de separação, passe "-" ou "(-" como texto do elemento.
  • Para definir o estilo de fonte para uma linha, coloque no texto do elemento um sinal menor que (<) seguido por um desses caracteres:

<BNegrito
<IItálica
<USublinhado
<OContorno (Macintosh apenas)
<SSombra (Macintosh apenas)


  • Para adicionar uma marca de seleção a um elemento, coloque no texto do elemento um sinal de exclamação (!) seguido pelo caractere que deseja utilizar como marca de seleção.
    • Em Macintosh, o caractere é mostrado diretamente. Para mostrar a marca padrão sem importar a versão ou a linguagem do sistema, utilize a instrução: Char(18).
    • Em Windows, é mostrada uma marca padrão, sem importar o caractere que passe.
  • Para adicionar um ícone a um elemento, coloque no texto do elemento um acento circunflexo (^) seguido por um caractere cujo código mais 208 é o recurso do ícone Mac OS.
  • Para adicionar um atalho a um elemento, coloque no texto do elemento uma barra oblíqua (/) seguida pelo caractere do atalho. Note que esta última opção é informativa apenas; nenhum atalho de teclado ativa o menu pop up. Entretanto, pode incluir um atalho se o elemento de menu pop up tiver4 um equivalente na barra de menus principal de sua aplicação.
Dica: se for possível desativar o mecanismo de interpretação dos caracteres especiais (!, /, etc.) no menu pop up para, por exemplo, ter esses caracteres incluídos nos textos. Para fazer isso, simplesmente inicie o parâmetro conteúdo com a instrução  Char(1) depois utilize esta instrução como separador:
conteúdo:=Char(1)+"1/4"+Char(1)+"1/2"+Char(1)+"3/4")

Note que uma vez executada esta instrução, não é possível atribuir estilos ou atalhos ao menu pop up.

Conselho
: é possível desativar o mecanismo de interpretação dos  caracteres especiais (!, /, etc.) no menu pop up para, por exemplo, ter esses caracteres incluídos nos textos. Para fazer isso, simplesmente inicie o parâmetro conteudo com a instrução Char(1) depois utilize esta instrução como separador:

 conteúdo:=Char(1)+"1/4"+Char(1)+"1/2"+Char(1)+"3/4")

Note que quando tiver executada esta instrução, não é possível atribuir estilos ou atalhos ao menu pop up.

O parâmetro opcional padrao lhe permite especificar o elemento de menu selecionado por padrão quando se mostra o menu. Passe um valor entre 1 e o número de elementos do menu. Se omitir este parâmetro, o comando seleciona por padrão o primeiro elemento do menu.

Os parâmetros opcionais coordX e coordY são utilizadas para designar a localização do menu pop-up a mostrar. Em coordX e coordY, passe respectivamente as coordenadas horizontal e vertical da esquina superior esquerda do menu. Estas coordenadas devem ser expressas em pixels no sistema de coordenadas local do formulário atual. Estes dois parâmetros devem ser passados juntos; se só for passado um, será ignorado.

Se utilizar os parâmetros coordX e coordY, o parâmetro por padrão é ignorado. Neste caso, o mouse não é encontrado necessariamente no nível do menu pop up.

Estes parâmetros são úteis especialmente para administrar os botões 3D com um menu pop up associado.

Se seleciona um elemento de menu, o comando retorna seu número; do contrário, retorna zero (0).

Nota: utilize os menus pop up com um número razoável de elementos. Se deseja mostrar mais de 50 elementos, pode utilizar melhor uma área de rolagem em um formulário.

Exemplo  

O método de projeto MEU MENU RAPIDO faz aparecer um menu de navegação pop up:

  ` Método de projeto MEU MENU RAPIDO
 GET MOUSE($vlMouseX;$vlMouseY;$vlBotao)
 If(Macintosh control down&NBSP;|&NBSP;($vlBotao=2))
    $vtElementos:="Sobre este banco...<I;(-;!-Outras opções;(-"
    For($vlTabela;1;Get last table number)
       If(Is table number valid($vlTabela))
          $vtElementos:=$vtElementos+";"+Table name($vlTabela)
       End if
    End for
    $vlEscolhaUsuario:=Pop up menu($vtElementos)
    Case of
       :($vlEscolhaUsuario=1)
  ` Mostrar informação
       :($vlEscolhaUsuario=2)
  ` Mostrar as opções
       Else
          If($vlEscolhaUsuario>0)
  ` Ir a tabela cujo número for $vlEscolhaUsuario-4
          End if
    End case
 End if

Este método de projeto pode ser chamado desde:

  • o método de um objeto de formulário que reage a um clique sem esperar que o botão do mouse seja liberado (por exemplo um botão invisível)
  • um processo que “espi a” os eventos e se comunica com os outros processos
  • um método de gestão de eventos instalado pelo comando ON ERR CALL.

Nos dois últimos casos, não é necessário que o clique seja produzido em um objeto de formulário. Esta é uma das janelas do comando Pop up menu. Geralmente, os menus pop up são mostrados através de objetos de formulário. Com Pop up menu, pode mostrar um menu pop up em qualquer lugar.

O menu pop up é mostrado em Windows ao pressionar o botão direito do mouse, e em Macintosh ao pressionar Control-Clique. Note, entretanto, que o método não verifica se na verdade houve um clique; o método chamante faz esse teste.

O próximo é o menu pop-up tal como aparece em Windows (esquerda) e Macintosh (direita). Note a marca de seleção padrão para a versão Windows.

 
PROPRIEDADES 

Produto: 4D
Tema: Interface de Usuário
Número 542

 
HISTÓRIA 

Modificado: 4D 2004

 
VER TAMBÉM 

Dynamic pop up menu
GET MOUSE

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)