Ein Builder für Tabellendiagramme. Weitere Informationen finden Sie in der Dokumentation zu Google Charts.
Das folgende Beispiel zeigt, wie ein Tabellendiagramm erstellt wird. Die Daten werden aus einer Google-Tabelle importiert.
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; var chartBuilder = Charts.newTableChart() .setDimensions(600, 500) .enablePaging(20) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
build() | Chart | Erstellt das Diagramm. |
enablePaging(enablePaging) | TableChartBuilder | Legt fest, ob das Durchblättern der Daten aktiviert werden soll. |
enablePaging(pageSize) | TableChartBuilder | Aktiviert Paginierung und legt die Anzahl der Zeilen pro Seite fest. |
enablePaging(pageSize, startPage) | TableChartBuilder | Aktiviert Paginierung und legt die Anzahl der Zeilen auf jeder Seite und der ersten Tabellenseite fest, die angezeigt werden soll (Seitennummern basieren auf null). |
enableRtlTable(rtlEnabled) | TableChartBuilder | Grundlegende Unterstützung für linksläufige Sprachen (wie Arabisch oder Hebräisch) durch Umkehren der Spaltenreihenfolge der Tabelle, sodass Spalte 0 die Spalte ganz rechts und die letzte Spalte die Spalte ganz links ist. |
enableSorting(enableSorting) | TableChartBuilder | Legt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt. |
setDataSourceUrl(url) | TableChartBuilder | Legt die URL der Datenquelle fest, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden. |
setDataTable(tableBuilder) | TableChartBuilder | Legt die Datentabelle für das Diagramm mithilfe eines DataTableBuilders fest. |
setDataTable(table) | TableChartBuilder | Legt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | Legt die Definition der Datenansicht für das Diagramm fest. |
setDimensions(width, height) | TableChartBuilder | Legt die Abmessungen des Diagramms fest. |
setFirstRowNumber(number) | TableChartBuilder | Legt die Zeilennummer für die erste Zeile in der Datentabelle fest. |
setInitialSortingAscending(column) | TableChartBuilder | Legt den Index der Spalte fest, nach der die Tabelle anfänglich (aufsteigend) sortiert werden soll. |
setInitialSortingDescending(column) | TableChartBuilder | Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert (absteigend) sein soll. |
setOption(option, value) | TableChartBuilder | Legt erweiterte Optionen für dieses Diagramm fest. |
showRowNumberColumn(showRowNumber) | TableChartBuilder | Legt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll. |
useAlternatingRowStyle(alternate) | TableChartBuilder | Legt fest, ob ungeraden und geraden Zeilen in einem Tabellendiagramm ein abwechselnder Farbstil zugewiesen wird. |
Detaillierte Dokumentation
build()
Erstellt das Diagramm.
Return
Chart
: Ein Diagrammobjekt, das in Dokumente oder UI-Elemente eingebettet oder als statisches Bild verwendet werden kann.
enablePaging(enablePaging)
Legt fest, ob das Durchblättern der Daten aktiviert werden soll.
Die Paginierung ist standardmäßig deaktiviert. Wenn Paging aktiviert ist, beträgt die Standardseitengröße 10.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enablePaging | Boolean | true , wenn das Paging aktiviert werden soll, andernfalls false . |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
enablePaging(pageSize)
Aktiviert Paginierung und legt die Anzahl der Zeilen pro Seite fest.
Die Standardseitengröße ist 10.
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
Parameter
Name | Typ | Beschreibung |
---|---|---|
pageSize | Integer | Die Anzahl der Zeilen auf jeder Seite der Tabelle. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
enablePaging(pageSize, startPage)
Aktiviert Paginierung und legt die Anzahl der Zeilen auf jeder Seite und der ersten Tabellenseite fest, die angezeigt werden soll (Seitennummern basieren auf null).
Die Standardseitengröße ist 10 und die Standardstartseite 0.
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
pageSize | Integer | Die Anzahl der Zeilen auf jeder Seite der Tabelle. |
startPage | Integer | Die erste anzuzeigende Tabellenseite (Seitennummern basieren auf null) |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
enableRtlTable(rtlEnabled)
Grundlegende Unterstützung für linksläufige Sprachen (wie Arabisch oder Hebräisch) durch Umkehren der Spaltenreihenfolge der Tabelle, sodass Spalte 0 die Spalte ganz rechts und die letzte Spalte die Spalte ganz links ist.
Dies wirkt sich nicht auf den Spaltenindex in den zugrunde liegenden Daten aus, sondern nur auf die Reihenfolge der Anzeige. Auch bei dieser Option wird die vollständige bidirektionale Sprachanzeige (BiDi) von der Tabellenvisualisierung nicht unterstützt. Diese Option wird ignoriert, wenn Sie Paging aktivieren (über die Seitenoption) oder wenn die Tabelle Bildlaufleisten enthält, weil Sie Höhen- und Breitenoptionen angegeben haben, die kleiner als die erforderliche Tabellengröße sind. Standardmäßig ist die linksläufige Unterstützung deaktiviert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
rtlEnabled | Boolean | true , wenn die Unterstützung von rechts nach links aktiviert werden soll, andernfalls false . |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
enableSorting(enableSorting)
Legt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt.
Wenn die Sortierung aktiviert ist und Nutzer auf die Spaltenüberschrift klicken, werden die Zeilen automatisch sortiert. Standardmäßig ist die Sortierung aktiviert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enableSorting | Boolean | true , um die Sortierung durch Klicken auf Spaltenüberschriften zu aktivieren, andernfalls false . |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setDataSourceUrl(url)
Legt die URL der Datenquelle fest, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden. Wenn eine Datenquellen-URL und eine Datentabelle angegeben werden, wird die URL der Datenquelle ignoriert.
Weitere Informationen zum Abfragen von Datenquellen finden Sie in der Google Charts-Dokumentation.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die URL der Datenquelle, einschließlich aller Suchparameter. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setDataTable(tableBuilder)
Legt die Datentabelle für das Diagramm mithilfe eines DataTableBuilders fest. Dies ist eine praktische Methode zum Festlegen der Datentabelle, ohne build()
aufrufen zu müssen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
tableBuilder | DataTableBuilder | Ein Datentabellen-Builder. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt, sodass weitere Aktualisierungen des Builders nicht im Diagramm widergespiegelt werden. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setDataTable(table)
Legt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält. Die erste Spalte sollte ein String sein und die Beschriftungen der horizontalen Achsen enthalten. Es kann eine beliebige Anzahl von Spalten folgen, alle müssen numerisch sein. Jede Spalte wird als separate Zeile angezeigt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
table | DataTableSource | Die Datentabelle für das Diagramm. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setDataViewDefinition(dataViewDefinition)
Legt die Definition der Datenansicht für das Diagramm fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
dataViewDefinition | DataViewDefinition | Ein Datenansichtsdefinitionsobjekt, das die Ansicht definiert, die aus der angegebenen Datenquelle für die Diagrammzeichnung abgeleitet werden soll. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setDimensions(width, height)
Legt die Abmessungen des Diagramms fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Integer | Die Breite des Diagramms in Pixeln. |
height | Integer | Die Höhe des Diagramms in Pixeln. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setFirstRowNumber(number)
Legt die Zeilennummer für die erste Zeile in der Datentabelle fest.
Die Standardzeilennummer der ersten Zeile ist 1.
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
number | Integer | Die Zeilennummer der ersten Zeile in der Datentabelle. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setInitialSortingAscending(column)
Legt den Index der Spalte fest, nach der die Tabelle anfänglich (aufsteigend) sortiert werden soll.
Die Spalte „os“ ist in aufsteigender Reihenfolge sortiert und mit einem kleinen Pfeil markiert.
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | Integer | Die Nummer der Spalte, nach der die Tabelle anfänglich sortiert werden soll. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setInitialSortingDescending(column)
Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert (absteigend) sein soll.
Die Spalte „os“ ist in absteigender Reihenfolge sortiert und mit einem kleinen Pfeil gekennzeichnet, der dies anzeigt.
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | Integer | Die Nummer der Spalte, nach der die Tabelle anfänglich sortiert werden soll. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
setOption(option, value)
Legt erweiterte Optionen für dieses Diagramm fest. Hier finden Sie die verfügbaren Optionen für dieses Diagramm. Diese Methode hat keine Auswirkungen, wenn die angegebene Option ungültig ist.
// Build a table chart which renders HTML. var builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); var chart = builder.build();
Parameter
Name | Typ | Beschreibung |
---|---|---|
option | String | Die festzulegende Option. |
value | Object | Der festzulegende Wert. |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
showRowNumberColumn(showRowNumber)
Legt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.
Standardmäßig werden keine Zeilennummern angezeigt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
showRowNumber | Boolean | true , wenn die erste Spalte der Tabelle die Zeilennummer anzeigen soll, andernfalls false . |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.
useAlternatingRowStyle(alternate)
Legt fest, ob ungeraden und geraden Zeilen in einem Tabellendiagramm ein abwechselnder Farbstil zugewiesen wird.
Das Standardverhalten entspricht den Zeilen mit abwechselnden Farben.
Parameter
Name | Typ | Beschreibung |
---|---|---|
alternate | Boolean | true , wenn die Farbstile abwechselnd sein sollen, andernfalls false . |
Return
TableChartBuilder
: Dieser Builder wird für Verkettungen verwendet.