Compartilhar via

Office.BindingSelectionChangedEventArgs interface

  • Referência
Pacote:
office

Fornece informações sobre a associação que gerou o evento SelectionChanged.

Propriedades

binding

Obtém um objeto Office.Binding que representa o enlace que elevou o evento SelectionChanged.
columnCount

Obtém o número de colunas selecionadas. Se uma única célula for selecionada, retornará 1.

Se o usuário fizer uma seleção não contígua, a contagem para a última seleção contígua dentro de associação será retornada.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.
rowCount

Obtém o número de linhas selecionadas. Se uma única célula for selecionada, retornará 1.

Se o usuário fizer uma seleção não contígua, a contagem para a última seleção contígua dentro de associação será retornada.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.
startColumn

O índice com base em zero da primeira coluna da seleção contando da coluna mais à esquerda na associação.

Se o usuário fizer uma seleção não contígua, as coordenadas para a última seleção contígua dentro de associação serão retornadas.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.
startRow

O índice com base em zero da primeira linha da seleção contando da primeira linha na associação.

Se o usuário fizer uma seleção não contígua, as coordenadas para a última seleção contígua dentro de associação serão retornadas.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.
type

Obtém um valor de enumeração Office.EventType que identifica o tipo de evento que foi gerado.

Detalhes da propriedade

binding

Obtém um objeto Office.Binding que representa o enlace que elevou o evento SelectionChanged.

binding: Binding;

Valor da propriedade

Office.Binding

columnCount

Obtém o número de colunas selecionadas. Se uma única célula for selecionada, retornará 1.

Se o usuário fizer uma seleção não contígua, a contagem para a última seleção contígua dentro de associação será retornada.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.

columnCount: number;

Valor da propriedade

number

Exemplos

// 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; 
}

rowCount

Obtém o número de linhas selecionadas. Se uma única célula for selecionada, retornará 1.

Se o usuário fizer uma seleção não contígua, a contagem para a última seleção contígua dentro de associação será retornada.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.

rowCount: number;

Valor da propriedade

number

Exemplos

// 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; 
}

startColumn

O índice com base em zero da primeira coluna da seleção contando da coluna mais à esquerda na associação.

Se o usuário fizer uma seleção não contígua, as coordenadas para a última seleção contígua dentro de associação serão retornadas.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.

startColumn: number;

Valor da propriedade

number

Exemplos

// 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; 
}

startRow

O índice com base em zero da primeira linha da seleção contando da primeira linha na associação.

Se o usuário fizer uma seleção não contígua, as coordenadas para a última seleção contígua dentro de associação serão retornadas.

Por Word, esta propriedade funcionará apenas para enlaces de Office.BindingType "table". Se a associação for do tipo "matrix", será retornado null. Além disso, a chamada falhará se a tabela contiver células mescladas, porque a estrutura da tabela deve ser uniforme para esta propriedade funcionar corretamente.

startRow: number;

Valor da propriedade

number

Exemplos

// 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; 
}

type

Obtém um valor de enumeração Office.EventType que identifica o tipo de evento que foi gerado.

type: EventType;

Valor da propriedade

Office.EventType