Entrada de Usuário em Caixas de Diálogo
Caixas de diálogo são normalmente usadas para solicitar ao usuário dados que são então usados pelo aplicativo. O formulário exibindo a caixa de diálogo processa essas informações. Quando você exibe uma caixa de diálogo, é importante saber como ela é fechada ou seu "resultado". Por exemplo, se o usuário clicar em um botão Cancelar, os dados inseridos pelo usuário são descartados em vez de mantidos. Você pode usar a propriedade Form.DialogResult para descobrir como um caixa de diálogo é fechada.
A partir do formulário que exibe a caixa de diálogo (conhecido como o formulário pai da caixa de diálogo), você pode usar o valor da propriedade DialogResult para determinar se um botão OK ou um botão Cancelar for clicado. Baseado no DialogResult retornado, você decidir se precisa recuperar informações da caixa de diálogo. Você pode definir o valor da propriedade DialogResult de uma caixa de diálogo quando você não usar controles Button na caixa de diálogo, mas ainda deseja retornar um DialogResult .
Quando um formulário é exibido como uma caixa de diálogo de janela restrita (modal), clicar no botão Fechar (o botão com um X no canto superior direito do formulário) faz com que o formulário seja ocultado e a propriedade DialogResult seja definida como DialogResult.Cancel. O método Close não automaticamente é chamado quando o usuário clica no botão Fechar de uma caixa de diálogo ou define o valor da propriedade DialogResult. Em vez disso, o formulário será oculto e pode ser mostrado novamente sem criar uma nova instância da caixa de diálogo. Devido a esse comportamento, você deve chamar o método Dispose do formulário quando o formulário não for mais necessário pelo seu aplicativo.
.gif "Observação") Observação |
|---|
Você pode substituir o valor atribuído à propriedade DialogResult quando o usuário clica no botão Fechar, definindo a propriedade DialogResult em um manipulador de eventos para o evento Closing do formulário. |
Consulte também
Tarefas
Como: Criar caixas de diálogo em tempo de Design
Como: Feche as caixas de diálogo e reter a entrada do usuário
Como: Recuperar o resultado para caixas de diálogo