Mostrar caixa de diálogo personalizada
Propósito 
Exibe uma caixa diálogo de mensagem personalizada, com etiquetas e texto personalizado.
Formato 
Mostrar caixa de diálogo personalizada [<título>; <texto da mensagem>; Tabela1::campo de entrada 1;...]
Opções 
Clique em Especificar para exibir a caixa de diálogo Opções de “Mostrar caixa de diálogo personalizada”, na qual é possível definir o título da caixa de diálogo, o texto da mensagem e os botões, e especificar até três campos que serão preenchidos ou exibidos.
Opções gerais
 •
Título permite que você especifique o título da caixa de diálogo personalizada. Insira um texto literal ou clique em Especificar para criar o título da caixa de diálogo a partir de um cálculo.
 •
Mensagem permite que você especifique a mensagem da caixa de diálogo. Insira um texto literal ou clique em Especificar para criar o texto da mensagem a partir de um cálculo.
 •
Etiquetas do botão permite especificar quantos botões (até três) serão exibidos na caixa de diálogo personalizada e nas etiquetas desses botões. Se você deixar uma etiqueta de botão em branco, o botão não aparecerá na caixa de diálogo personalizada. Se você deixar todos os títulos de botão em branco, um botão OK será exibido no canto inferior direito da caixa de diálogo personalizada. Para criar uma etiqueta de botão com base em um cálculo, clique em Especificar e defina o cálculo.
 •
As caixas de seleção Confirmar dados passam informações da caixa de diálogo para o banco de dados de acordo com a ação de cada botão. Se nenhum campo estiver ativo, os dados são confirmados; se um campo estiver ativo, os dados são confirmados quando o registro for confirmado.
Opções de campo de entrada
 •
Selecione Mostrar campo de entrada <n> para ativar um campo de entrada.
 •
Selecione Especificar para escolher o campo que será preenchido. Cada área de entrada é mapeada para um campo.
 •
Selecione Usar caractere de senha (*) para mascarar o texto enquanto ele é digitado ou enquanto ele é exibido no banco de dados. Essa opção obscurece os dados que estão sendo inseridos na caixa de diálogo personalizada ou que estão sendo exibidos, mas não altera os dados reais quando eles são armazenados no banco de dados.
 •
Use Etiqueta para especificar uma etiqueta de campo (o texto que identificará essa entrada para o usuário.) Insira um texto literal ou crie a etiqueta a partir de um cálculo.
Compatibilidade 
 
Onde a etapa de script é executada 
Compatível 
FileMaker Pro 
Sim 
Script programado do FileMaker Server 
Não 
FileMaker Go 
Sim 
Publicação na Web personalizada 
Não 
FileMaker WebDirect 
Sim 
Solução de tempo de execução 
Sim 
Originado em 
FileMaker Pro 6.0 ou anterior
Descrição 
A caixa de diálogo de mensagem personalizada pode usar a entrada do usuário em até três campos do banco de dados, e exibir os dados de até três campo do banco de dados. O script é pausado contanto que a caixa de diálogo personalizada fique na tela. Os campos usados para entrada podem ser do tipo texto, número, data, hora, carimbo de data/hora ou contêiner. A caixa de diálogo personalizada também pode ter até três botões, com títulos de botão personalizados.
Use a função Get(LastMessageChoice) para determinar qual botão o usuário pressionará.
 •
1 para o primeiro botão (por padrão, com o rótulo OK)
 •
2 para o segundo botão (por padrão, com o rótulo Cancelar)
 •
3 para o terceiro botão
Notas
 •
Se os valores inseridos nos campos de entrada não corresponderem ao tipo de campo, uma mensagem de erro de validação será exibida. O usuário deve resolver os erros de validação para que a caixa de diálogo seja fechada. Consulte Definição de validação de campo para obter mais informações.
 •
Os campos especificados não precisam aparecer no layout atual. Os campos de entrada de Mostrar caixa de diálogo personalizada são independentes de layouts, similar à etapa de script Definir campo.
 •
Os dados não podem ser inseridos nos campos de cálculo ou resumo.
 •
Mostrar caixa de diálogo personalizada ignora quaisquer opções de entrada de campo. Consulte Como permitir ou impedir a entrada em campos para obter mais informações.
 •
A entrada de dados através da etapa de script Mostrar caixa de diálogo personalizada é limitada por quaisquer critérios de privilégios de acesso que possam estar em vigor. (Selecione Executar script com privilégios de acesso total para ativar o script para todos os usuários.)
 •
(Windows) É possível criar um atalho de teclado para um botão da caixa de diálogo personalizada colocando um E comercial antes da letra da tecla de atalho na etiqueta do botão. Por exemplo, para criar um atalho de teclado ‘C’ (Alt+C) para o botão ‘Concluído’, digite a etiqueta ‘&Concluído’.
 •
No caso dos bancos de dados criados com versões do FileMaker Pro anteriores à 12 e abertos com o FileMaker Pro 13, a caixa de seleção Confirmar dados de Botão padrão é marcada quando você abre a caixa de diálogo Mostrar caixa de diálogo personalizada.
 •
Antes de alterar o status de confirmação de dados de um botão para um banco de dados que já está em uso, considere o comportamento que os usuários esperam do botão e como a alteração desse comportamento pode afetar a validade dos dados confirmados (ou não confirmados) para o banco de dados.
 •
Para desenvolver caixas de diálogo personalizadas mais complexas, use a etapa de script Nova janela.
Exemplo 1 
Realiza uma busca. Se nenhum registro for encontrado, será exibida uma caixa de diálogo personalizada.
Realizar busca [Restaurar]
If [Get (FoundCount) = 0]
Mostrar caixa de diálogo personalizada ["Nenhum registro foi encontrado."]
End If
Exemplo 2 
Cria um novo registro, solicita que o usuário insira informações e vai para o layout Detalhes do cliente. O primeiro botão é Cancelar, para que os usuários não criem inadvertidamente um registro pressionando Retorno ou Enter na caixa de diálogo personalizada.
Congelar janela
Novo registro/solicitação
Mostrar caixa de diálogo personalizada ["Novo cliente"; "Insira informações nos campos abaixo:"; Clientes::Empresa; Clientes::Nome; Clientes::Cidade]
If [Get ( LastMessageChoice ) = 1]
Excluir registro/solicitação [Sem caixa de diálogo]
Else
Ir para layout ["Detalhes do cliente"]
End If
Exemplo 3 
Entra no Modo de busca, solicita que o usuário forneça os critérios de busca e realiza a busca. Se a busca não retornar nenhum registro, será perguntado se o usuário deseja realizar nova busca e se ele deseja executar o script novamente ou parar todos os scripts.
Script: Buscar
Entrar em Modo de busca [ ]
Mostrar caixa de diálogo personalizada ["Localizar clientes por ID, nome ou cidade."; Clientes::ID; Clientes::Nome; Clientes::Cidade]
If [Get ( LastMessageChoice ) = 1]
Realizar busca [ ]
If [Get ( FoundCount ) = 0]
Mostrar caixa de diálogo personalizada ["Nenhum registro foi encontrado. Localizar novamente?"]
If [Get ( LastMessageChoice ) = 1]
#Chama esse script como um subscript
Realizar script ["Buscar"]
Else
Mostrar todos os registros
#Para todos os scripts e subscripts
Parar script
End If
End If
Else If [Get ( LastMessageChoice ) = 2]
Entrar em Modo de navegação [ ]
End If
Tópicos relacionados 
Referência de etapas de script (lista em ordem alfabética)
Referência de etapas de script (lista de categorias)