Office.BindingSelectionChangedEventArgs interface

Paquet:

office

Fournit des informations sur la liaison qui a déclenché l’événement SelectionChanged.

Propriétés

binding	Obtient un objet Office.Binding qui représente la liaison qui a déclenché l’événement SelectionChanged.
columnCount	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.
rowCount	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.
startColumn	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.
startRow	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.
type	Obtient une valeur d’énumération Office.EventType qui identifie le type d’événement qui a été déclenché.

Détails de la propriété

binding

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

binding: Binding;

Valeur de propriété

Office.Binding

columnCount

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é

number

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

rowCount

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é

number

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

startColumn

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é

number

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

startRow

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é

number

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

type

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é

Office.EventType