Описание
Определяет метод, позволяющий получить текущие свойства элемента управления содержимым.
Применение
Этот метод следует использовать следующим образом:
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 = "";
...
});
};