Описание
Определяет метод, позволяющий получить текущие свойства элемента управления содержимым.
Применение
Этот метод следует использовать следующим образом:
window.Asc.plugin.executeMethod ("GetCurrentContentControlPr", [contentFormat]);
Параметры
Параметр | Описание | Тип | Пример |
contentFormat | Формат содержимого («нет», «текст», «html», «ole» или «рабочий стол«) | строковый | «text» |
Возвращает
Метод возвращает объект ContentControlProperties, содержащий свойства элемента управления содержимым, в следующей форме (JSON):
{ "Id" : integer, "Tag" : string, "Lock" : integer, "InternalId" : string, "Alias" : string, "PlaceHolderText" : string, "Appearance" : integer, "Color" : { "R": integer, "G": integer, "B": integer } }
Параметры
Параметр | Описание | Тип | Пример |
Id | Уникальный идентификатор элемента управления содержимым. Его можно использовать для поиска определенного элемента управления содержимым и ссылки на него в коде. | целочисленный | 2 |
Tag | Тег, назначенный элементу управления содержимым. Один и тот же тег может быть присвоен нескольким элементам управления содержимым, чтобы на них можно было ссылаться в коде. | строковый | «{tag}» |
Lock | Значение, которое определяет, возможно ли удалить и/или изменить элемент управления содержимым или нет. | целочисленный | 0 |
InternalId | Уникальный внутренний идентификатор элемента управления содержимым. | строковый | «1_713» |
Alias | Атрибут псевдонима. | строковый | «№1» |
PlaceHolderText | Текст-заполнитель элемента управления содержимым. | строковый | «placeholder text» |
Appearance | Определяет, отображается ли элемент управления содержимым в виде ограничивающей рамки (1) или нет (2). | целочисленный | 1 |
Color | Цвет текущего элемента управления содержимым в формате RGB:
| объект |
Параметр Lock может принимать следующие значения:
Числовое значение | Редактировать | Удалить |
0 | нет | да |
1 | нет | нет |
2 | да | нет |
3 | да | да |
Пример
window.Asc.plugin.event_onClick = function(isSelectionUse) { window.Asc.plugin.executeMethod("GetCurrentContentControlPr", [], function(obj) { window.Asc.plugin.currentContentControl = obj; var controlTag = obj ? obj.Tag : ""; if (isSelectionUse) controlTag = ""; ... }); };
Была ли полезна статья?