Office.BindingSelectionChangedEventArgs interface

Возвращает объект Office.Binding , представляющий привязку, которая вызвала событие SelectionChanged.

binding: Binding;

Значение свойства

Получает количество выбранных столбцов. Если выбрана одна ячейка, то возвращается значение 1.

Если пользователь делает не сплошной выбор, то возвращается количество для последнего сплошного выбора.

Для Word это свойство будет работать только для привязок office.BindingType "table". Если привязка имеет тип "matrix", возвращается значение null. Кроме того, вызов завершится неудачно, если в таблице имеются объединенные ячейки, поскольку для правильной работы этого свойства структура таблицы должна быть однородной.

columnCount: number;

Значение свойства

Примеры

// The following example adds an event handler for the SelectionChanged event to the binding with an id of myTable.
// When the user changes the selection, the handler displays the coordinates of the first cell in the selection,
// and the number of row and columns selected.
function addSelectionHandler() {
    Office.context.document.bindings.getByIdAsync("myTable", function (result) {
        result.value.addHandlerAsync("bindingSelectionChanged", myHandler);
    });
}

// Display selection start coordinates and row/column count.
function myHandler(bArgs) {
    write("Selection start row/col: " + bArgs.startRow + "," + bArgs.startColumn);
    write("Selection row count: " + bArgs.rowCount);
    write("Selection col count: " + bArgs.columnCount);
}
// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

Получает количество выбранных строк. Если выбрана одна ячейка, то возвращается значение 1.

Если пользователь делает не сплошной выбор, то возвращается количество для последнего сплошного выбора.

Для Word это свойство будет работать только для привязок office.BindingType "table". Если привязка имеет тип "matrix", возвращается значение null. Кроме того, вызов завершится неудачно, если в таблице имеются объединенные ячейки, поскольку для правильной работы этого свойства структура таблицы должна быть однородной.

rowCount: number;

Значение свойства

Примеры

// The following example adds an event handler for the SelectionChanged event to the binding with an id of myTable.
// When the user changes the selection, the handler displays the coordinates of the first cell in the selection,
// and the number of row and columns selected.
function addSelectionHandler() {
    Office.context.document.bindings.getByIdAsync("myTable", function (result) {
        result.value.addHandlerAsync("bindingSelectionChanged", myHandler);
    });
}

// Display selection start coordinates and row/column count.
function myHandler(bArgs) {
    write("Selection start row/col: " + bArgs.startRow + "," + bArgs.startColumn);
    write("Selection row count: " + bArgs.rowCount);
    write("Selection col count: " + bArgs.columnCount);
}
// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

Отсчитываемый от нуля индекс первого столбца текущего выбора, начиная с самого левого столбца в привязке.

Если пользователь выбирает не смежные столбцы, то возвращаются координаты последнего сплошного выбора.

Для Word это свойство будет работать только для привязок office.BindingType "table". Если привязка имеет тип "matrix", возвращается значение null. Кроме того, вызов завершится неудачно, если в таблице имеются объединенные ячейки, поскольку для правильной работы этого свойства структура таблицы должна быть однородной.

startColumn: number;

Значение свойства

Примеры

// The following example adds an event handler for the SelectionChanged event to the binding with an id of myTable.
// When the user changes the selection, the handler displays the coordinates of the first cell in the selection,
// and the number of row and columns selected.
function addSelectionHandler() {
    Office.context.document.bindings.getByIdAsync("myTable", function (result) {
        result.value.addHandlerAsync("bindingSelectionChanged", myHandler);
    });
}

// Display selection start coordinates and row/column count.
function myHandler(bArgs) {
    write("Selection start row/col: " + bArgs.startRow + "," + bArgs.startColumn);
    write("Selection row count: " + bArgs.rowCount);
    write("Selection col count: " + bArgs.columnCount);
}
// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

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

Если пользователь выбирает не смежные строки, то возвращаются координаты последнего сплошного выбора.

Для Word это свойство будет работать только для привязок office.BindingType "table". Если привязка имеет тип "matrix", возвращается значение null. Кроме того, вызов завершится неудачно, если в таблице имеются объединенные ячейки, поскольку для правильной работы этого свойства структура таблицы должна быть однородной.

startRow: number;

Значение свойства

Примеры

// The following example adds an event handler for the SelectionChanged event to the binding with an id of myTable.
// When the user changes the selection, the handler displays the coordinates of the first cell in the selection,
// and the number of row and columns selected.
function addSelectionHandler() {
    Office.context.document.bindings.getByIdAsync("myTable", function (result) {
        result.value.addHandlerAsync("bindingSelectionChanged", myHandler);
    });
}

// Display selection start coordinates and row/column count.
function myHandler(bArgs) {
    write("Selection start row/col: " + bArgs.startRow + "," + bArgs.startColumn);
    write("Selection row count: " + bArgs.rowCount);
    write("Selection col count: " + bArgs.columnCount);
}
// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

Возвращает значение перечисления Office.EventType , определяющее тип события, которое было создано.

type: EventType;

Значение свойства