Office.BindingSelectionChangedEventArgs interface

Obtient un objet Office.Binding qui représente la liaison qui a déclenché l’événement SelectionChanged.

binding: Binding;

Valeur de propriété

Obtient le nombre de colonnes sélectionnées. Si une seule cellule est sélectionnée, retourne 1.

Si l’utilisateur effectue une sélection non contiguë, le décompte de la dernière sélection contiguë au sein de la liaison est retourné.

Pour Word, cette propriété fonctionne uniquement pour les liaisons d’Office.BindingType « table ». Si la liaison est de type « matrix », une valeur null est retournée. En outre, l’appel échoue si le tableau contient des cellules fusionnées, car la structure du tableau doit être uniforme pour que cette propriété fonctionne correctement.

columnCount: number;

Valeur de propriété

Exemples

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

Obtient le nombre de lignes sélectionnées. Si une seule cellule est sélectionnée, retourne 1.

Si l’utilisateur effectue une sélection non contiguë, le décompte de la dernière sélection contiguë au sein de la liaison est retourné.

Pour Word, cette propriété fonctionne uniquement pour les liaisons d’Office.BindingType « table ». Si la liaison est de type « matrix », une valeur null est retournée. En outre, l’appel échoue si le tableau contient des cellules fusionnées, car la structure du tableau doit être uniforme pour que cette propriété fonctionne correctement.

rowCount: number;

Valeur de propriété

Exemples

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

Index de base zéro de la première colonne de la sélection à partir de la colonne la plus à gauche de la liaison.

Si l’utilisateur effectue une sélection non contiguë, les coordonnées de la dernière sélection contiguë au sein de la liaison sont retournées.

Pour Word, cette propriété fonctionne uniquement pour les liaisons d’Office.BindingType « table ». Si la liaison est de type « matrix », une valeur null est retournée. En outre, l’appel échoue si le tableau contient des cellules fusionnées, car la structure du tableau doit être uniforme pour que cette propriété fonctionne correctement.

startColumn: number;

Valeur de propriété

Exemples

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

Index de base zéro de la première ligne de la sélection à partir de la première ligne de la liaison.

Si l’utilisateur effectue une sélection non contiguë, les coordonnées de la dernière sélection contiguë au sein de la liaison sont retournées.

Pour Word, cette propriété fonctionne uniquement pour les liaisons d’Office.BindingType « table ». Si la liaison est de type « matrix », une valeur null est retournée. En outre, l’appel échoue si le tableau contient des cellules fusionnées, car la structure du tableau doit être uniforme pour que cette propriété fonctionne correctement.

startRow: number;

Valeur de propriété

Exemples

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

Obtient une valeur d’énumération Office.EventType qui identifie le type d’événement qui a été déclenché.

type: EventType;

Valeur de propriété