Элементы управления. 
Программирование на vba в ms excel

ОО.о Basic поддерживает такие объекты — элементы управления, как формы (диалоги), текстовые поля, командные кнопки, списки, комбинированные списки, кнопки с зависимой фиксацией и др. При этом существует несколько типизированных текстовых полей, имеющих, например, тип «число» или «дата».

Элементы управления могут быть использованы (размещены) в любом количестве не только в диалогах, но и в самом документе-таблице OpenOffice Calc. Разметить их можно с помощью панели инструментов «Элементы управления >. Также им можно назначить необходимые свойства и макросыобработчики событий.

Получить доступ к элементам управления можно через метод getControl, который возвращает его имя.

Пример:

Dim oCmd As Object.

oCmd = oDlg. getControl{" CmdBtnl")

oCmd. Label = «New» .

Здесь объектная переменная oDlg содержит существующую ссылку на диалог. Для элемента управления CmdBtnl определяется и инициализируется объектная переменная oCmd со ссылкой на этот элемент. Далее устанавливается его свойства Label (надпись) в значение New.

Примечание'. ОО. о Basic различает в именах элементов управления заглавные и строчные символы.

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

Разделение между видимыми элементами программы (Вид) и данными или документами позади них (Модель) поддерживается OpenOffice.org API во многих местах. В диалогах различие между данными и описанием не столь ярко выражено, тем не менее элементы API доступны и через Вид, и через Модель. Свойство Model осуществляет программно-управляемый доступ к модели диалога и объектам элементов управления.

Пример:

Dim oCmd As Object.

oCmd = oDlg. getControl («CmdBtnl»).

oCmd.Model. Enabled = False.

В этом примере в диалоге oDlg делается недоступной кнопка CmdBtn 1 через модель объекта oCmd.

Из всего многообразия предоставляемых ОО. о Basic элементов управления рассмотрим кратко текстовое поле и некоторые его свойства и методы^[1].

Текстовые поля позволяют пользователям вводить числа и текст, а также могут использоваться как ноля ввода специальных денежных и других данных. Программно-управляемая обработка элемента основана на UNO-сервисе com.sun.star.awt.UnoControlEdit.

Текстовые поля предоставляют следующие свойства:

• • Text (тип String) определяет текущее содержимое (текст) поля;
• • SelectedText (тип String) содержит выделенный текст поля;
• • Selection (тип Stmct) определяет характеристики выделения (только для чтения). Stmct — структура со свойствами Min и Мах в соответствии с com.sun.star.awt.Selection, определяющая начало и конец текущего выделения;
• • MaxTextLen (тип short) — максимальное количество символов, которые можно ввести в поле;
• • Editable (тип Boolean) определяет возможность ввода текста (True — ввод возможен, при False ввод блокируется). Вызывается непосредственно только через IsEditable;
• • IsEditable (тип Boolean) — содержимое элемента управления может быть изменено, только для чтения.

Кроме того, перечислим некоторые свойства, которые предоставляются через связанный объект модели:

• • Model. BackgroundColor (тип long) задает цвет фона элемента управления;
• • Model. MultiLine (тип Boolean) разрешает режим ввода текста в нескольких строках;
• • Model. Readonly (тин Boolean) устанавливает режим содержимого поля только для чтения.

Из методов текстового поля приведем только необходимый для дальнейшего изложения метод setSelection (Selection), который устанавливает выделение текста в соответствии с содержащейся в структуре Selection информацией. Смысл этой структуры описан выше в свойстве Selection.

• [1] Программирование на языке OpenOffice.org.BASIC. URL: http://websprav.admm-smolensk.ru/freesoft/freesoft/OpenOfiice.org.BASIC Guide.pdf.