Объект TextBox (Outlook Forms Script)
Отображает пользовательскую информацию или информацию из упорядоченного набора данных.
Замечания
Элемент управления TextBox (текстовое поле) обычно используется для отображения информации, добавленной пользователем. Он также может отображать набор данных, таких как таблица, запрос, лист или результат подсчета. Если Элемент TextBox привязан к источнику данных, изменение содержимого TextBox также изменяет значение привязанного источника данных.
Форматирование любой части текста TextBox повлияет на весь текст элемента управления. Например, если изменить шрифт или размер любого символа элемента управления, изменение затронет все символы элемента управления.
По умолчанию для TextBox используется свойство Value .
Советы по использованию текстовых полей
TextBox — это гибкий элемент управления, управляемый следующими свойствами: Text, MultiLine, WordWrap и AutoSize.
Text содержит текст, отображаемый в текстовом поле.
MultiLine определяет способ отображения текста элементом управления TextBox (в виде одной строки или множества строк). Символы новой строки определяют конец одной строки и начало другой. Если параметр MultiLine имеет значение False (значение по умолчанию), текст усекается, а не упаковывается в оболочку.
WordWrap позволяет TextBox переносить строки текста, которые не помещаются в TextBox. Значение по умолчанию — True.
Если вы не используете WordWrap, элемент TextBox начинает новую строку текста при обнаружении символа новой строки в тексте. Если WordWrap отключен, вы можете иметь текстовые строки, которые не помещаются полностью в TextBox. Элемент TextBox отображает части текста, которые помещаются в его ширину, и усекает части текста, которые не помещаются. WordWrap можно использовать лишь в случае, если MultiLine присвоено значение True.
AutoSize определяет, полностью ли отображается текст в TextBox. При использовании AutoSize вместе с TextBox размер последнего элементаувеличивается или уменьшается в зависимости от количества текста иразмера шрифта. Значение по умолчанию — False.
AutoSize удобно применять в таких случаях:
Отображение заголовка из одной или нескольких строк.
Отображение содержимого TextBox длиною в одну строку.
Отображение содержимого TextBox, состоящего из нескольких строк только для чтения.
Избегайте применять AutoSize к пустому элементу TextBox, который использует свойства MultiLine и WordWrap. В таком случае при вводе текста в TextBox этотэлемент автоматически принимает вид поля шириною в один символ, отображающего весь текст одной строкой.
Методы
| Имя | Описание |
|---|---|
| Copy | Копирует содержимое объекта в буфер обмена. |
| Cut | Удаляет выбранную информацию из объекта и переносит ее в буфер обмена. |
| Paste | Передает содержимое буфера обмена объекту. |
Свойства
| Имя | Описание |
|---|---|
| AutoSize | Возвращает или задает логическое значение, указывающее, будет ли объект автоматически изменять размер для отображения всего содержимого. Для чтения и записи. |
| AutoTab | Возвращает или задает логическое значение, указывающее, происходит ли автоматическая вкладка, когда пользователь вводит максимально допустимое количество символов в TextBox. Для чтения и записи. |
| AutoWordSelect | Возвращает или задает логическое значение, указывающее, является ли базовая единица, используемая для расширения выделенного фрагмента, словом или одним символом. Для чтения и записи. |
| BackColor | Возвращает или задает значение Long , указывающее цвет фона объекта . Для чтения и записи. |
| BackStyle | Возвращает или задает целое число , задающее стиль фона для объекта . Для чтения и записи. |
| BorderColor | Возвращает или задает значение Long , указывающее цвет границы объекта. Для чтения и записи. |
| BorderStyle | Возвращает или задает целое число , указывающее тип границы элемента управления. Для чтения и записи. |
| CanPaste | Возвращает логическое значение, указывающее, содержит ли буфер обмена данные, поддерживаемые объектом. Только для чтения. |
| CurLine | Возвращает или задает значение Long , представляющее текущую строку элемента управления. Для чтения и записи. |
| CurTargetX | Возвращает значение Long , представляющее предпочтительную горизонтальную позицию точки вставки в многострочной области TextBox. Только для чтения. |
| CurX | Возвращает или задает значение Long , представляющее текущее горизонтальное положение точки вставки в многострочной области TextBox. Для чтения и записи. |
| DragBehavior | Возвращает или задает целое число , указывающее, включает ли система функцию перетаскивания для элемента управления . Для чтения и записи. |
| Enabled | Возвращает или задает логическое значение, указывающее, может ли элемент управления получать фокус и реагировать на события, созданные пользователем. Для чтения и записи. |
| EnterFieldBehavior | Возвращает или задает целое число , указывающее поведение выделения при вводе элемента TextBox. Для чтения и записи. |
| EnterKeyBehavior | Возвращает или задает логическое значение, определяющее эффект нажатия клавиши ВВОД в TextBox. Для чтения и записи. |
| ForeColor | Возвращает или задает значение Long , указывающее цвет переднего плана объекта. Для чтения и записи. |
| HideSelection | Возвращает или задает логическое значение, указывающее, остается ли выделенный текст выделенным, если элемент управления не имеет фокуса. Для чтения и записи. |
| IMEMode | Возвращает или задает целое число , указывающее режим времени выполнения по умолчанию редактора метода ввода (IME) для элемента управления. Для чтения и записи. |
| IntegralHeight | Возвращает или задает логическое значение, указывающее, отображает ли элемент TextBox полные строки текста или частичные строки. Для чтения и записи. |
| LineCount | Возвращает значение Long , указывающее количество текстовых строк в элементе TextBox. Только для чтения. |
| Locked | Возвращает или задает логическое значение, указывающее, можно ли изменять элемент управления. Для чтения и записи. |
| MaxLength | Возвращает или задает значение Long , указывающее максимальное число символов, которое пользователь может ввести в TextBox. Для чтения и записи. |
| MouseIcon | Возвращает значение String , представляющее полное имя пути настраиваемого значка, назначаемого элементу управления. Только для чтения. |
| MousePointer | Возвращает или задает целое число , указывающее тип указателя, отображаемого при наведении указателя мыши на определенный объект. Для чтения и записи. |
| MultiLine | Возвращает или задает логическое значение, указывающее, может ли элемент управления принимать и отображать несколько строк текста. Для чтения и записи. |
| PasswordChar | Возвращает или задает значение String , указывающее замещающий символ, который будет отображаться вместо символов, фактически введенных в TextBox. Для чтения и записи. |
| ScrollBars | Возвращает или задает целое число , указывающее, имеет ли элемент управления вертикальные полосы прокрутки, горизонтальные полосы прокрутки или и то, и другое. Для чтения и записи. |
| SelectionMargin | Возвращает или задает логическое значение, указывающее, может ли пользователь выделить строку текста, щелкнув область слева от текста. Для чтения и записи. |
| SelLength | Возвращает или задает значение Long , представляющее количество символов, выделенных в элементе TextBox. Для чтения и записи. |
| SelStart | Возвращает или задает значение Long , представляющее начальную точку выделенного текста, или точку вставки, если текст не выделен. Для чтения и записи. |
| SelText | Возвращает или задает значение String , представляющее выделенный текст элемента управления. Для чтения и записи. |
| SpecialEffect | Возвращает или задает целое число , указывающее внешний вид объекта. Для чтения и записи. |
| TabKeyBehavior | Возвращает или задает логическое значение, указывающее, разрешены ли вкладки в области редактирования. Для чтения и записи. |
| Текст | Возвращает или задает значение String , указывающее текст в элементе управления . Для чтения и записи. |
| TextAlign | Возвращает или задает целое число , указывающее способ выравнивания текста в элементе управления . Для чтения и записи. |
| TextLength | Возвращает значение Long , представляющее длину текста в количестве символов в области редактирования TextBox. Только для чтения. |
| Значение | Возвращает или задает значение Variant , указывающее текст в области редактирования. Для чтения и записи. |
| WordWrap | Возвращает или задает логическое значение, указывающее, будет ли содержимое элемента управления автоматически переноситься в конце строки, а элемент управления разворачивается в соответствии с текстом. Для чтения и записи. |
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.