Freigeben über

Office.BindingSelectionChangedEventArgs interface

  • Referenz
Paket:
office

Stellt Informationen zu der Bindung bereit, die das SelectionChanged-Ereignis ausgelöst hat.

Eigenschaften

binding

Ruft ein Office.Binding-Objekt ab, das die Bindung darstellt, die das SelectionChanged-Ereignis ausgelöst hat.
columnCount

Ruft die Anzahl der ausgewählten Spalten ab. Wenn eine einzelne Zelle ausgewählt wird, wird 1 zurückgegeben.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, wird die Anzahl der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.
rowCount

Ruft die Anzahl der ausgewählten Zeilen ab. Wenn eine einzelne Zelle ausgewählt wird, wird 1 zurückgegeben.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, wird die Anzahl der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.
startColumn

Der nullbasierte Index der ersten Spalte der Auswahl ab der äußersten linken Spalte der Bindung.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, werden die Koordinaten der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.
startRow

Der nullbasierte Index der ersten Zeile der Auswahl ab der ersten Zeile der Bindung.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, werden die Koordinaten der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.
type

Ruft einen Office.EventType-Enumerationswert ab, der die Art des ausgelösten Ereignisses angibt.

Details zur Eigenschaft

binding

Ruft ein Office.Binding-Objekt ab, das die Bindung darstellt, die das SelectionChanged-Ereignis ausgelöst hat.

binding: Binding;

Eigenschaftswert

Office.Binding

columnCount

Ruft die Anzahl der ausgewählten Spalten ab. Wenn eine einzelne Zelle ausgewählt wird, wird 1 zurückgegeben.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, wird die Anzahl der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.

columnCount: number;

Eigenschaftswert

number

Beispiele

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

Ruft die Anzahl der ausgewählten Zeilen ab. Wenn eine einzelne Zelle ausgewählt wird, wird 1 zurückgegeben.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, wird die Anzahl der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.

rowCount: number;

Eigenschaftswert

number

Beispiele

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

Der nullbasierte Index der ersten Spalte der Auswahl ab der äußersten linken Spalte der Bindung.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, werden die Koordinaten der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.

startColumn: number;

Eigenschaftswert

number

Beispiele

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

Der nullbasierte Index der ersten Zeile der Auswahl ab der ersten Zeile der Bindung.

Wenn Benutzer eine nicht zusammenhängende Auswahl treffen, werden die Koordinaten der letzten zusammenhängenden Auswahl innerhalb der Bindung zurückgegeben.

Für Word funktioniert diese Eigenschaft nur für Bindungen von Office.BindingType "table". Lautet der Typ der Bindung "matrix", wird null zurückgegeben. Für den Aufruf tritt auch ein Fehler auf, wenn die Tabelle zusammengeführte Zellen enthält, da die Struktur der Tabelle einheitlich sein muss, damit diese Eigenschaft richtig funktioniert.

startRow: number;

Eigenschaftswert

number

Beispiele

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

Ruft einen Office.EventType-Enumerationswert ab, der die Art des ausgelösten Ereignisses angibt.

type: EventType;

Eigenschaftswert

Office.EventType