Описание

Определяет вспомогательный объект window.Asc.plugin.InputHelper, который представляет свойства помощника ввода.

Методы и свойства:

  • createWindow -функция, вызываемая для создания вспомогательного окна ввода.
    Пример
    window.Asc.plugin.init = function(text) {
        if (!window.isInit) {
            window.isInit = true;
            window.Asc.plugin.currentText = "";
            window.Asc.plugin.createInputHelper();
            window.Asc.plugin.getInputHelper().createWindow();
        }
    };
    
  • getItems — функция, вызываемая для возврата массива объектов InputHelperItem, содержащих все элементы из помощника ввода.
    Пример
    function getInputHelperSize () {
        var _size = window.Asc.plugin.getInputHelper().getScrollSizes();
        var _width = 150;
        var _height = _size.h;
        var _heightMin = window.Asc.plugin.getInputHelper().getItemsHeight(Math.min(5, window.Asc.plugin.getInputHelper().getItems().length));
        if (_width > 400)
            _width = 400;
        if (_height > _heightMin)
            _height = _heightMin;
            _width += 30;
            return { w: _width, h : _height };
    }
    
  • getScrollSizes -функция, вызываемая для получения размеров прокручиваемого окна помощника по вводу. Возвращает объект с параметрами ширины и высоты.
    Пример
    function getInputHelperSize () {
        var _size = window.Asc.plugin.getInputHelper().getScrollSizes();
        var _width = 200;
        var _height = _size.h;
        var _heightMin = window.Asc.plugin.getInputHelper().getItemsHeight(Math.min(5, window.Asc.plugin.getInputHelper().getItems().length));
        if (_width > 400)
            _width = 400;
        if (_height > _heightMin)
            _height = _heightMin;
            _width += 30;
            return { w: _width, h : _height };
    }                                         
    
  • setItems — функция, вызываемая для установки элементов в вспомогательный инструмент ввода.
    Параметры
    ПараметрОписаниеТип
    InputHelperItemОпределяет массив объектов InputHelperItem, который содержит все элементы для помощника ввода. Этот объект может иметь следующие параметры:

    • id — индекс предмета,
      type: строковый,
      example: «1»;
    • text -текст предмета,
      type: строковый,
      example: «name».
    Объект
    Пример
    {
        var items = [
            { text: "Name1.Family1", id : "0" },
            { text: "Name2.Family2", id : "1" },
            { text: "Name3.Family3", id : "2" },
            { text: "Name4.Family4", id : "3" },
            { text: "Name5.Family5", id : "4" },
            { text: "Name6.Family6", id : "5" },
            { text: "Name7.Family7", id : "6" },
            { text: "Name8.Family8", id : "7" },
            { text: "Name9.Family9", id : "8" },
            { text: "Name10.Family10", id : "9" },
            { text: "Name11.Family11", id : "10" },
            { text: "Name12.Family12", id : "11" },
            { text: "Name13.Family13", id : "12" }
        ];
        window.Asc.plugin.getInputHelper().setItems(items);
        var _sizes = getInputHelperSize();
        window.Asc.plugin.getInputHelper().show(_sizes.w, _sizes.h, true);
    }              
    
  • show -функция, вызываемая для отображения вспомогательного средства ввода.
    Параметры
    ПараметрыОписаниеТип
    widthШирина окна помощника ввода измеряется в миллиметрах.численный
    heightВысота окна помощника ввода измеряется в миллиметрах.численный
    isCaptureKeyboardОпределяет, захвачена ли клавиатура (true) или нет (false).логический
    Пример
    {
        var items = [
            { text: "Name1.Family1", id : "0" },
            { text: "Name2.Family2", id : "1" },
            { text: "Name3.Family3", id : "2" },
            { text: "Name4.Family4", id : "3" },
            { text: "Name5.Family5", id : "4" },
            { text: "Name6.Family6", id : "5" },
            { text: "Name7.Family7", id : "6" },
            { text: "Name8.Family8", id : "7" },
            { text: "Name9.Family9", id : "8" },
            { text: "Name10.Family10", id : "9" },
            { text: "Name11.Family11", id : "10" },
            { text: "Name12.Family12", id : "11" },
            { text: "Name13.Family13", id : "12" }
        ];
        window.Asc.plugin.getInputHelper().setItems(items);
        var _sizes = getInputHelperSize();
        window.Asc.plugin.getInputHelper().show(_sizes.w, _sizes.h, true);
    }                                                   
    
  • unShow — функция, вызываемая для скрытия помощника ввода.
    Пример
    window.Asc.plugin.executeMethod ("SelectContentControl", [window.Asc.plugin.currentContentControl.InternalId], function() {
        window.Asc.plugin.executeMethod("InputText", [item.text]);
        window.Asc.plugin.getInputHelper().unShow(); 
    });