DoModal

<< Clique para Mostrar o Sumário >>

 

DoModal

DoModal(Screen, Title, Left, Top, Width, Height, Arg, [Flags])

Abre uma Tela modal, que é uma janela que não permite clicar em outras Telas ou janelas enquanto não é fechada. O parâmetro Title passado neste método só é utilizado se a propriedade Caption está vazia. Do contrário, este parâmetro é ignorado. Este método possui os seguintes parâmetros:

Screen: Determina o nome da Tela

Title: Determina o título da janela modal

Left, Top: Posição XY da janela modal, em pixels

Width: Largura da janela modal, em pixels ou Himetric

Height: Altura da janela modal, em pixels ou Himetric

Arg: Determina a variável a ser usada no evento OnPreShow da Tela

Flags: Determina a combinação utilizada na janela modal. Tal combinação é realizada somando-se os valores da tabela correspondentes às opções que o usuário deseja. Quando o valor especificado é igual a -1 (menos um, usado quando o parâmetro e omitido), são adotadas as configurações do Viewer para a janela modal. Quando este valor é diferente de -1 (menos um), pode-se usar as combinações descritas na tabela a seguir

Combinações possíveis para o parâmetro Flags

Valor

Descrição

1

Habilita a barra de título na janela

2

Habilita o botão Fechar na janela

4

Habilita o botão Minimizar na janela

8

Habilita o botão Maximizar na janela

16

Habilita a borda na janela

32

Especifica que a janela pode ser dimensionada

64

Especifica que a janela pode ser movida

256

Especifica que a janela permanece no topo da Tela

512

Especifica que a janela é configurada no estilo Barra de Ferramentas

1024

Desabilita os botões de objeto

2048

Centraliza a Tela modal no Quadro, tanto horizontal quanto verticalmente

 

O código a seguir contém um exemplo de uso deste método.

Sub Botao1_Click()
  ' Ao clicar no Botão, abre uma outra Tela modal
  Application.DoModal "Tela1", "Titulo", 0, 0, 400, 200, 0, 3
End Sub

 

NOTA

Os valores de tamanho neste método podem ser informados como números ou Strings. No caso de números, são considerados em pixels. No caso de Strings, se vierem acompanhados da unidade "hm", são interpretados como Himetric. Qualquer outro caso é considerado em pixels.

Esta página foi útil?