• Post category:executeMethod
  • Запись изменена:07.11.2022

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

Применение
Этот метод следует использовать следующим образом:

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:

  • R — значение компонента красного цвета,
    тип: целочисленный,
    пример: 0;
  • G -значение компонента зеленого цвета,
    тип: целочисленный,
    пример: 0;
  • B -значение компонента синего цвета,
    тип: целочисленный,
    пример: 255;
объект

Параметр 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 = "";
        ... 
    }); 
};