_Application.InputBox Метод

Определение

Пространство имен:

Microsoft.Office.Interop.Excel

Сборка:

Microsoft.Office.Interop.Excel.dll

Отображает диалоговое окно для данных, вводимых пользователями. Возвращает данные, введенные в диалоговом окне.

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

Параметры

Prompt

String

Обязательный объект. Сообщение, которое отображается в диалоговом окне. Это может быть строка, число, дата или логическое значение.

Title

Object

Необязательный объект. Название поля для ввода. Если этот аргумент пропущен, используется заголовок по умолчанию "Ввод".

Default

Object

Необязательный объект. Задает значение, которое будет отображаться в текстовом поле при первоначальном отображении диалогового окна. Если этот аргумент пропущен, текстовое поле остается пустым. Это значение может представлять собой объект Range объекта.

Left

Object

Необязательный объект. Задает позицию x для диалогового окна по отношению к верхнему левому углу экрана в точках.

Top

Object

Необязательный объект. Задает позицию y для диалогового окна по отношению к левому верхнему углу экрана в точках.

HelpFile

Object

Необязательный объект. Имя файла справки для этого поля ввода. HelpFile Если аргументы и HelpContextID присутствуют, в диалоговом окне появится кнопка Справка.

HelpContextID

Object

Необязательный объект. Идентификатор контекста раздела справки в HelpFile.

Type

Object

Необязательный объект. Задает тип возвращаемых данных. Если этот аргумент опущен, диалоговое окно возвращает текст. Может быть одним или суммой следующих значений. Можно использовать сумму допустимых значений для Type. Например, для поля ввода, которое может принимать как текст, так и числа, установите значение Type 1 +2.

Возвращаемое значение

Object

Комментарии

Используйте InputBox для отображения простого диалогового окна, что позволит вам вводить данные, которое можно будет использоваться в макросе. Диалоговое окно имеет кнопку ОК и кнопку Отмена. Если нажать кнопку ОК, InputBox возвращает значение, введенное в диалоговом окне. Если нажать кнопку Отмена, inputBox вернет значение False.

Если Type имеет значение 0, InputBox возвращает формулу в виде текста, например "=2*PI()/360". Если в формуле есть все ссылки, они возвращаются в качестве ссылки в стиле A1. (Используйте ConvertFormula(Object, XlReferenceStyle, Object, Object, Object) для преобразования между стилями ссылок.)

Если Type имеет значение 8, InputBox возвращает объект Range .

Если вы используете метод InputBox , чтобы запросить у пользователя формулу, необходимо использовать FormulaLocal свойство для назначения формулы объекту Range . Ввод формулы будет выполняться на языке пользователя.

Метод InputBox отличается от функции InputBox тем, что он позволяет выборочную проверку входных данных пользователя и может использоваться с объектами Microsoft Excel, значениями ошибок и формулами. InputBox без квалификатора объектов вызывает функцию InputBox .