_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 de entrada do usuário. Retorna 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. Isso pode ser uma cadeia de caracteres, um número, uma data ou um valor booliano .
- 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 argumentos e HelpContextID estiverem presentes, um botão Ajuda aparecerá na caixa de diálogo.
- HelpContextID
- Object
Objeto opcional. O número da ID de contexto do tópico 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 uma ou uma soma dos valores a seguir. Você pode usar a soma dos valores permitidos para Type. Por exemplo, para uma caixa de entrada que pode aceitar texto e números, defina 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 Type for 0, o InputBox retornará a fórmula na forma de texto – por 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 pedir uma fórmula ao usuário, deverá usar a FormulaLocal propriedade para atribuir 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 na qual permite a validação seletiva da entrada do usuário e pode ser usado com objetos, valores de erro e fórmulas do Microsoft Excel. InputBox sem qualificador de objeto chama a função InputBox .