Работа с элементами управления

К элементам управления относятся следующие объекты: "Флажок" (CheckBoxControl), "Поле ввода" (InputFieldControl), "Выбор даты" (DatePickerControl) и "Выпадающий список" (DropListControl). Они могут быть расположены в текстовом документе или его шаблоне.

Используйте метод Document:getContentControls() чтобы получить элементы управления из текущего документа:

 local controls = document:getContentControls()

Метод ContentControls:findByTitle(string) позволяет получить элемент управления по его названию:

 local textField = controls:findByTitle("input")

Метод ContentControls:enumerate() позволяет перечислить элементы управления документа:

 local contentControls = document:getContentControls()

 local enumerator = contentControls:enumerate()
 for content_control in enumerator do
   print(content_control:getTitle())
 end

Чтобы взаимодействовать со значениями элементов управления, преобразуйте полученный объект ContentControl в объект элемента управления. Это можно сделать с помощью методов toCheckBox(), toInputField(), toDatePicker() и toDropList():

 local checkBox = controls:findByTitle("check"):toCheckBox()
 local inputField = controls:findByTitle("input"):toInputField()
 local startDate = controls:findByTitle("date"):toDatePicker()
 local comboBox = controls:findByTitle("select"):toDropList()

У каждого объекта элемента управления есть методы для получения и задания его значения (getValue() и setValue()):

 checkBox:setValue(not(checkBox:getValue()))

Выпадающий список дополнительно содержит метод DropListControl:getChoices(), который возвращает элементы выпадающего списка.