Excel.ChartFill class
Representa el formato de relleno para un elemento de gráfico.
- Extends
Comentarios
[ Conjunto de API: ExcelApi 1.1 ]
Propiedades
context | Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office. |
Métodos
clear() | Borra el color de relleno de un elemento de gráfico. |
set |
Establece el formato de relleno de un elemento de gráfico en un color uniforme. |
toJSON() | Invalida el método JavaScript |
Detalles de las propiedades
context
Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.
context: RequestContext;
Valor de propiedad
Detalles del método
clear()
Borra el color de relleno de un elemento de gráfico.
clear(): void;
Devoluciones
void
Comentarios
[ Conjunto de API: ExcelApi 1.1 ]
Ejemplos
// Clear the line format of the major gridlines on the value axis of the chart named "Chart1".
await Excel.run(async (context) => {
const gridlines = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").axes.valueAxis.majorGridlines;
gridlines.format.line.clear();
await context.sync();
console.log("Chart Major Gridlines Format Cleared");
});
setSolidColor(color)
Establece el formato de relleno de un elemento de gráfico en un color uniforme.
setSolidColor(color: string): void;
Parámetros
- color
-
string
Código de color HTML que representa el color del fondo, con el formato #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
Devoluciones
void
Comentarios
[ Conjunto de API: ExcelApi 1.1 ]
Ejemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-point.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
let pointsCollection = sheet.charts.getItemAt(0).series.getItemAt(0).points;
let point = pointsCollection.getItemAt(2);
// Set color for chart point.
point.format.fill.setSolidColor('red');
await context.sync();
});
toJSON()
Invalida el método JavaScript toJSON()
para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify()
. (JSON.stringify
a su vez, llama al toJSON
método del objeto que se le pasa). Mientras que el objeto original Excel.ChartFill
es un objeto de API, el toJSON
método devuelve un objeto JavaScript sin formato (escrito como Excel.Interfaces.ChartFillData
) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.
toJSON(): {
[key: string]: string;
};
Devoluciones
{ [key: string]: string; }