setFocusedCell()
Beschreibung
Setzt den Fokus auf die angegebene Zelle
Verwendung
setFocusedCell(cell: string, scroll?: boolean): void;
Parameter
cell- (erforderlich) die ID der Zelle, auf die der Fokus gesetzt werden sollscroll- (optional) legt fest, ob die Tabellenkalkulation zur Zelle gescrollt wird, standardmäßigtrue
Beispiel
const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// Konfigurationsparameter
});
spreadsheet.parse(data);
spreadsheet.selection.setFocusedCell("D4");
Details
Die Methode macht die angegebene Zelle aktiv und verschiebt nach dem Neuzeichnen den Tastaturfokus auf diese Zelle. Der Tastaturfokus wird nicht verschoben, wenn er sich befindet:
- in einem Element außerhalb der Tabellenkalkulation
- in der Symbolleiste, im Menü oder in den Tabellenblatt-Tabs, die per Tastatur erreicht wurden
- in einem geöffneten Zelleneditor
Befindet sich der Tastaturfokus auf dem Seitenkörper (body), zum Beispiel direkt nach dem Laden der Seite, verschiebt die Methode ihn auf die Zelle.
Dieselben Regeln gelten für jede andere Änderung der aktiven Zelle, zum Beispiel durch eine andere API-Methode.
Wenn der Handler des Events beforeFocusSet false zurückgibt, wird die aktive Zelle nicht geändert und der Tastaturfokus nicht verschoben.
Die Methode tut nichts, solange die Auswahl mit der Konfigurationsoption selection: false oder mit der Methode selection.disable() deaktiviert ist.
Changelog: Das Verschieben des Tastaturfokus auf die Zelle wurde in v6.0.4 hinzugefügt
Verwandte Artikel: