Продукты Р7
Корпоративный сервер 2024
Корпоративный сервер 2024
Сервер документов
Сервер документов
Редакторы документов
Редакторы документов
Корпоративный сервер 2019
Корпоративный сервер 2019
Графика
Графика
ВКС и мессенджер
ВКС и мессенджер
Мобильные редакторы
Мобильные редакторы
Почтовый сервер
Почтовый сервер
Органайзер
Органайзер
Сервер лицензирования
Сервер лицензирования
Файл-Экспресс
Файл-Экспресс
Аналитика
Аналитика
Дополнительно
Часто задаваемые вопросы
Разработчикам
Интеграции
Новые возможности

GetSelectedText

Обновлено: 18.11.26

Инструкция актуальна для версий продукта: 2026.3.1.3296 – 2026.3.1.3906

Описание. Возвращает выделенный текст в виде строки. Параметр-объект задаёт, какие элементы включать в результат и чем разделять абзацы, ячейки и строки таблицы.

Редакторы: документы, таблицы, презентации.

Параметры

Параметр необязательный. Это объект со свойствами:

СвойствоТипПо умолчаниюОписание
NewLineлогическоеtrueВключать разрывы строк (Shift+Enter). При false разрыв строки удаляется
NewLineParagraphлогическоеtrueРазделять абзацы. При false абзацы и ячейки таблицы склеиваются без разделителей
NumberingлогическоеtrueВключать номера и маркеры списков. Номер отделяется от текста табуляцией: "1.\tтекст"
MathлогическоеtrueВключать формулы. При false формулы в текст не попадают
ParaSeparatorстрока"\r\n"Разделитель абзацев
NewLineSeparatorстрока"\r"Чем заменять разрыв строки
TabSymbolстрокапробелЧем заменять символ табуляции в тексте. Табуляция после номера списка не заменяется
TableCellSeparatorстрока"\t"Разделитель ячеек в строке таблицы
TableRowSeparatorстрока"\r\n"Разделитель строк таблицы

Если вызвать метод без параметра, действуют значения по умолчанию: разрывы строк, абзацы, нумерация и формулы включаются.

Возвращаемое значение

Строка с выделенным текстом.

  • Если ничего не выделено, метод возвращает пустую строку.
  • Если выделен абзац целиком, строка заканчивается разделителем абзаца (по умолчанию "\r\n").

Пример

window.Asc.plugin.executeMethod("GetSelectedText", [{
    Numbering: false,
    ParaSeparator: "\n",
    TableCellSeparator: " | ",
    TableRowSeparator: "\n"
}], function (text) {
    if (!text) {
        console.log("Ничего не выделено");
        return;
    }
    console.log(text.trim());
});

Особенность в Таблицах

В редакторе таблиц метод не возвращает содержимое выделенных ячеек и выделенных целиком фигур: результат — пустая строка. Текст возвращается в двух случаях: пользователь редактирует ячейку и выделил текст внутри неё или выделил текст внутри фигуры.

Чтобы получить значения выделенных ячеек, используйте callCommand:

window.Asc.plugin.callCommand(function () {
    return JSON.stringify(Api.GetSelection().GetValue());
}, false, false, function (result) {
    var values = JSON.parse(result);
    // для диапазона A1:B2: [["a1","b1"],["a2","b2"]]
    console.log(values);
});

Используется в примерах

Была ли эта статья полезной?

Поделитесь пожалуйста своим мнением

      В статье есть ошибкиРекомендации не помоглиТекст трудно понятьСодержание статьи не соответствует заголовкуДругое