• 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 = "";
        ... 
    }); 
};