Compartir a través de

Office.BindingSelectionChangedEventArgs interface

  • Referencia
Paquete:
office

Proporciona información sobre el enlace que ha generado el evento SelectionChanged.

Propiedades

binding

Obtiene un objeto Office.Binding que representa el enlace que generó el evento SelectionChanged.
columnCount

Obtiene la cantidad de columnas seleccionadas. Si se selecciona una sola celda, devolverá 1.

Si el usuario selecciona elementos que no son contiguos, devolverá el recuento del último grupo de elementos contiguos que haya seleccionado dentro del enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.
rowCount

Obtiene la cantidad de filas seleccionadas. Si se selecciona una sola celda, devolverá 1.

Si el usuario selecciona elementos que no son contiguos, devolverá el recuento del último grupo de elementos contiguos que haya seleccionado dentro del enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.
startColumn

El índice de base cero de la primera columna de la selección empezando desde la columna más a la izquierda del enlace.

Si el usuario hace una selección no contigua, se devuelven las coordenadas de la última selección contigua que hay en el enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.
startRow

El índice de base cero de la primera fila de la selección, a partir de la primera fila del enlace.

Si el usuario selecciona elementos que no son contiguos, devolverá las coordenadas del último grupo de elementos contiguos que haya seleccionado dentro del enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.
type

Obtiene un valor de enumeración Office.EventType que identifica el tipo de evento que se generó.

Detalles de las propiedades

binding

Obtiene un objeto Office.Binding que representa el enlace que generó el evento SelectionChanged.

binding: Binding;

Valor de propiedad

Office.Binding

columnCount

Obtiene la cantidad de columnas seleccionadas. Si se selecciona una sola celda, devolverá 1.

Si el usuario selecciona elementos que no son contiguos, devolverá el recuento del último grupo de elementos contiguos que haya seleccionado dentro del enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.

columnCount: number;

Valor de propiedad

number

Ejemplos

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

Obtiene la cantidad de filas seleccionadas. Si se selecciona una sola celda, devolverá 1.

Si el usuario selecciona elementos que no son contiguos, devolverá el recuento del último grupo de elementos contiguos que haya seleccionado dentro del enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.

rowCount: number;

Valor de propiedad

number

Ejemplos

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

El índice de base cero de la primera columna de la selección empezando desde la columna más a la izquierda del enlace.

Si el usuario hace una selección no contigua, se devuelven las coordenadas de la última selección contigua que hay en el enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.

startColumn: number;

Valor de propiedad

number

Ejemplos

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

El índice de base cero de la primera fila de la selección, a partir de la primera fila del enlace.

Si el usuario selecciona elementos que no son contiguos, devolverá las coordenadas del último grupo de elementos contiguos que haya seleccionado dentro del enlace.

Para Word, esta propiedad solo funcionará para los enlaces de Office.BindingType "table". Si el enlace es de tipo "matrix", devolverá null. También se producirá un error en la llamada si la tabla contiene celdas combinadas, porque la estructura de la tabla debe ser uniforme para que esta propiedad funcione correctamente.

startRow: number;

Valor de propiedad

number

Ejemplos

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

Obtiene un valor de enumeración Office.EventType que identifica el tipo de evento que se generó.

type: EventType;

Valor de propiedad

Office.EventType