_Application.InputBox Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe uma caixa de diálogo para entrada de usuário. Retorna as informações inseridas na caixa de diálogo.
public object InputBox (string Prompt, object Title, object Default, object Left, object Top, object HelpFile, object HelpContextID, object Type);Public Function InputBox (Prompt As String, Optional Title As Object, Optional Default As Object, Optional Left As Object, Optional Top As Object, Optional HelpFile As Object, Optional HelpContextID As Object, Optional Type As Object) As ObjectParâmetros
- Prompt
- String
Objeto Obrigatório. A mensagem a ser exibida na caixa de diálogo. Pode ser uma cadeia de caracteres, um número, uma data ou um valor Boolean.
- Title
- Object
Objeto Opcional. Título da caixa de entrada. Se esse argumento for omitido, será usado o título padrão.
- Default
- Object
Objeto Opcional. Especifica um valor que será exibido na caixa de texto quando a caixa de diálogo for exibida inicialmente. Se este argumento for omitido, a caixa de texto é deixada vazia. Este valor pode ser um objeto Range.
- Left
- Object
Objeto Opcional. Especifica uma posição x para a caixa de diálogo em relação ao canto superior esquerdo da tela em pontos.
- Top
- Object
Objeto Opcional. Especifica uma posição y para a caixa de diálogo em relação ao canto superior esquerdo da tela em pontos.
- HelpFile
- Object
Objeto Opcional. O nome do arquivo de Ajuda para esta caixa de entrada. Se os HelpFile HelpContextID argumentos e estão presentes, um botão ajuda aparecerá na caixa de diálogo.
- HelpContextID
- Object
Objeto Opcional. O número de ID de contexto do tópico de Ajuda em HelpFile .
- Type
- Object
Objeto Opcional. Especifica o tipo de dados de retorno. Se esse argumento for omitido, a caixa de diálogo retorna texto. Pode ser um ou uma soma dos seguintes valores. Você pode usar a soma dos valores permitiveis para Type . Por exemplo, para uma caixa de entrada que pode aceitar texto e números, desem conjunto Type como 1 + 2.
Retornos
Comentários
Use InputBox para exibir uma caixa de diálogo simples, de modo que você possa inserir informações a serem usadas em uma macro. A caixa de diálogo tem um botão OK e um botão Cancelar. Se você escolher o botão OK, InputBox retornará o valor inserido na caixa de diálogo. Se você clicar no botão Cancelar, InputBox retornará False.
Se for 0, InputBox retornará a fórmula na forma de texto — por Type exemplo, "=2*PI()/360". Se houver alguma referência na fórmula, elas são retornadas como referências de estilo A1. (Use ConvertFormula(Object, XlReferenceStyle, Object, Object, Object) para converter entre estilos de referência.)
Se Type for 8, InputBox retornará um objeto Range.
Se você usar o método InputBox para solicitar uma fórmula ao usuário, use a propriedade para atribuir FormulaLocal a fórmula a um objeto Range. A fórmula de entrada estará no idioma do usuário.
O método InputBox difere da função InputBox porque permite a validação seletiva da entrada do usuário e pode ser usado com objetos Microsoft Excel, valores de erro e fórmulas. InputBox sem qualificador de objeto chama a função InputBox.