4D Doc Center : Dynamic pop up menu

4D v13.4

Dynamic pop up menu


Dynamic pop up menu ( menu {; porpadrao {; coordX ; coordY}} ) -> Resultado

Parâmetro	Tipo	Descrição
menu	MenuRef	Referência de menu
porpadrao	cadeia	Parâmetro de itens selecionado por padrão
coordX	Inteiro longo	Coordenada X do canto esquerdo superior
coordY	Inteiro longo	Coordenada Y do canto esquerdo superior
Resultado	cadeia	Parâmetro do menu de item selecionado

Descrição

O comando Dynamic pop up menu faz aparecer um menu suspenso hierárquico na localização atual do mouse ou na localização definida pelos parâmetros opcionais Coordx e Coordy.

O menu hierárquico utilizado deve ter sido criado com o comando Create menu. A referência devolvida por Create menu deve ser passada no parâmetro menu.

De acordo com as regras padrão da interface, este comando geralmente deve ser chamado em resposta a um clique direito, ou quando o botão é mantido pressionado por um certo período de tempo (menu contextual por exemplo).

O parâmetro opcional porpadrao pode ser utilizado para definir um elemento do menu suspenso selecionado automaticamente quando aparece o menu. Neste parâmetro, passe uma cadeia personalizada associada a referência do elemento de menu. Esta cadeia deve ter sido definida anteriormente com a ajuda do comando SET MENU ITEM PARAMETER. Se não passar este parâmetro, o primeiro elemento do menu será selecionado automaticamente.

Os parâmetros opcionais CoordX e CoordY podem ser utilizados para especificar a localização do menu suspenso a mostrar. Nos parâmetros CoordX e CoordY, passe as coordenadas horizontal e vertical respectivamente, da esquina superior esquerda do menu. Estas coordenadas devem ser expressas em píxels no sistema de coordenadas local do formulário atual. Estes dois parâmetros devem ser passados juntos; se é passado só um deles, o outro será ignorado.

Se quer mostrar um menu suspenso associado a um botão 3D, não passe os parâmetros opcionais CoordX e CoordY. Neste caso, 4D calcula automaticamente a localização do menu relativo ao botão de acordo aos padrões de interface da plataforma atual.

Se um elemento de menu for selecionado, o comando devolve sua cadeia de caracteres personalizada associada (tal como foi definido utilizando o comando SET MENU ITEM PARAMATER). Do contrario, o comando devolve uma cadeia vazia.

Nota: o comando Pop up menu (tema Interface de usuário) pode ser utilizada para criar menus suspensos baseados em texto.