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