Zum Hauptinhalt springen

selection

Beschreibung​

Optional. Aktiviert/deaktiviert die Zellauswahl

Verwendung​

selection?: boolean;

Standardkonfiguration​

selection: true

Beispiel​

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
selection: false,
// other config parameters
});

Details​

Wenn die Eigenschaft auf false gesetzt ist:

  • hat das Spreadsheet keine aktive Zelle
  • können Zellen weder mit der Maus, der Tastatur noch der API ausgewählt werden: Die Methoden setSelectedCell() und setFocusedCell() werden ignoriert, und die Methoden getSelectedCell() und getFocusedCell() geben undefined zurück
  • können Zellen nicht über die Oberfläche bearbeitet werden: Die Formelleiste ist gesperrt, der Ausfüllgriff ist ausgeblendet, und die Methode startEdit() wird ignoriert
  • sind das Kontextmenü und das Spaltenmenü-Symbol nicht verfügbar
  • hält Tab einmal auf dem Grid an und verschiebt den Fokus weiter, und Ctrl + F6 überspringt das Grid

Die Spalten und Zeilen lassen sich weiterhin durch Ziehen ihrer Ränder in der Größe ändern, und die Daten können weiterhin über die API geändert werden, zum Beispiel mit der Methode setValue().

In Kombination mit der Eigenschaft readonly schaltet die Option die Tastaturnavigation und die Auswahl aus, die im schreibgeschützten Modus verfügbar sind:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
readonly: true,
selection: false,
// other config parameters
});

Um die Auswahl zur Laufzeit aus- und einzuschalten, verwenden Sie die Methoden selection.disable() und selection.enable().

Changelog: Hinzugefügt in v6.0.4

Verwandte Artikel: