_Application.InputBox Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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 Object

Parâ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

Object

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 .