Compartir a través de


Excel.PivotLayout class

Representa el diseño visual de la tabla dinámica.

Extends

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Propiedades

altTextDescription

Descripción del texto alternativo de la tabla dinámica.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la tabla dinámica. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o comprender la tabla. Un título se puede leer a una persona con una discapacidad y se usa para determinar si desea escuchar la descripción del contenido.

altTextTitle

Título de texto alternativo de la tabla dinámica.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la tabla dinámica. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o comprender la tabla. Un título se puede leer a una persona con una discapacidad y se usa para determinar si desea escuchar la descripción del contenido.

autoFormat

Especifica si el formato se dará formato automáticamente cuando se actualice o cuando se muevan los campos.

context

Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.

emptyCellText

Texto que se rellena automáticamente en cualquier celda vacía de la tabla dinámica si fillEmptyCells == truees . Tenga en cuenta que este valor persiste si fillEmptyCells está establecido en falsey que al establecer este valor no se establece esa propiedad en true. De forma predeterminada, se trata de una cadena vacía.

enableFieldList

Especifica si la lista de campos se puede mostrar en la interfaz de usuario.

fillEmptyCells

Especifica si las celdas vacías de la tabla dinámica deben rellenarse con .emptyCellText El valor predeterminado es false. Tenga en cuenta que el valor de emptyCellText persiste cuando esta propiedad está establecida en false.

layoutType

Esta propiedad indica el PivotLayoutType de todos los campos de la tabla dinámica. Si los campos tienen diferentes estados, será null.

pivotStyle

Estilo aplicado a la tabla dinámica.

preserveFormatting

Especifica si el formato se conserva cuando el informe se actualiza o se vuelve a calcular mediante operaciones como la dinamización, la ordenación o el cambio de elementos de campo de página.

showColumnGrandTotals

Especifica si el informe de tabla dinámica muestra los totales generales de las columnas.

showFieldHeaders

Especifica si la tabla dinámica muestra encabezados de campo (títulos de campo y listas desplegables de filtros).

showRowGrandTotals

Especifica si el informe de tabla dinámica muestra los totales generales de las filas.

subtotalLocation

Esta propiedad indica el SubtotalLocationType de todos los campos de la tabla dinámica. Si los campos tienen estados diferentes, será null.

Métodos

displayBlankLineAfterEachItem(display)

Establece si se va a mostrar una línea en blanco después de cada elemento. Se establece en el nivel global de la tabla dinámica y se aplica a campos dinámicos individuales. Esta función sobrescribe la configuración de todos los campos de la tabla dinámica en el valor del display parámetro .

getCell(dataHierarchy, rowItems, columnItems)

Obtiene una única celda de la tabla dinámica en función de una jerarquía de datos y de los elementos de fila y columna de sus respectivas jerarquías. La celda devuelta es la intersección de la fila y columna determinadas que contiene los datos de la jerarquía determinada. Este método es el inverso de la llamada getPivotItems y getDataHierarchy en una celda determinada.

getColumnLabelRange()

Devuelve el intervalo donde residen las etiquetas de columna de la tabla dinámica.

getDataBodyRange()

Devuelve el intervalo donde residen los valores de datos de tabla dinámica.

getDataHierarchy(cell)

Obtiene la DataHierarchy que se usa para calcular el valor de un intervalo especificado en la tabla dinámica.

getFilterAxisRange()

Devuelve el intervalo del área de filtro de la tabla dinámica.

getPivotItems(axis, cell)

Obtiene los elementos dinámicos de un eje que componen el valor de un intervalo especificado en la tabla dinámica.

getPivotItems(axisString, cell)

Obtiene los elementos dinámicos de un eje que componen el valor de un intervalo especificado en la tabla dinámica.

getRange()

Devuelve el intervalo en el que existe la tabla dinámica, excluyendo el área de filtro.

getRowLabelRange()

Devuelve el intervalo donde residen las etiquetas de fila de la tabla dinámica.

load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

repeatAllItemLabels(repeatLabels)

Establece el valor "repetir todas las etiquetas de elemento" en todos los campos de la tabla dinámica.

set(properties, options)

Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto de API del mismo tipo.

set(properties)

Establece varias propiedades en el objeto al mismo tiempo, en función de un objeto cargado existente.

setAutoSortOnCell(cell, sortBy)

Establece la tabla dinámica para la ordenación automática mediante la celda especificada para seleccionar automáticamente el contexto y todos los criterios necesarios. Esto funciona igual que aplicar un Autoordenar desde la interfaz de usuario.

setAutoSortOnCell(cell, sortByString)

Establece la tabla dinámica para la ordenación automática mediante la celda especificada para seleccionar automáticamente el contexto y todos los criterios necesarios. Esto funciona igual que aplicar un Autoordenar desde la interfaz de usuario.

setStyle(style)

Establece el estilo aplicado a la tabla dinámica.

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.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original Excel.PivotLayout es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como Excel.Interfaces.PivotLayoutData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

Detalles de las propiedades

altTextDescription

Descripción del texto alternativo de la tabla dinámica.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la tabla dinámica. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o comprender la tabla. Un título se puede leer a una persona con una discapacidad y se usa para determinar si desea escuchar la descripción del contenido.

altTextDescription: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Set the alt text for the displayed PivotTable.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.altTextTitle = "Farm Sales PivotTable";
  pivotLayout.altTextDescription = "A summary of fruit sales. It is pivoted on farm name, and fruit type. The aggregated data is both the sums of crates sold at the farms and the sums of crates sold wholesale.";
  console.log("Adding alt text. Check the PivotTable settings to see the changes.");

  await context.sync();
});

altTextTitle

Título de texto alternativo de la tabla dinámica.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la tabla dinámica. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o comprender la tabla. Un título se puede leer a una persona con una discapacidad y se usa para determinar si desea escuchar la descripción del contenido.

altTextTitle: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

autoFormat

Especifica si el formato se dará formato automáticamente cuando se actualice o cuando se muevan los campos.

autoFormat: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

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

emptyCellText

Texto que se rellena automáticamente en cualquier celda vacía de la tabla dinámica si fillEmptyCells == truees . Tenga en cuenta que este valor persiste si fillEmptyCells está establecido en falsey que al establecer este valor no se establece esa propiedad en true. De forma predeterminada, se trata de una cadena vacía.

emptyCellText: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Set a default value for an empty cell in the PivotTable. This doesn't include cells left blank by the layout.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.emptyCellText = "--";

  // Set the text alignment to match the rest of the PivotTable.
  pivotLayout.getDataBodyRange().format.horizontalAlignment = Excel.HorizontalAlignment.right;
  await context.sync();
});

enableFieldList

Especifica si la lista de campos se puede mostrar en la interfaz de usuario.

enableFieldList: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

fillEmptyCells

Especifica si las celdas vacías de la tabla dinámica deben rellenarse con .emptyCellText El valor predeterminado es false. Tenga en cuenta que el valor de emptyCellText persiste cuando esta propiedad está establecida en false.

fillEmptyCells: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Toggle whether empty cells are filled with a default value.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.load("fillEmptyCells");
  await context.sync();

  let fillToSet = !pivotLayout.fillEmptyCells;
  console.log(`Filling empty cells? - ${fillToSet}`);

  pivotLayout.fillEmptyCells = fillToSet;
  await context.sync();
});

layoutType

Esta propiedad indica el PivotLayoutType de todos los campos de la tabla dinámica. Si los campos tienen diferentes estados, será null.

layoutType: Excel.PivotLayoutType | "Compact" | "Tabular" | "Outline";

Valor de propiedad

Excel.PivotLayoutType | "Compact" | "Tabular" | "Outline"

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Change the PivotLayout.type to a new type.
  const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");
  pivotTable.layout.load("layoutType");
  await context.sync();

  // Cycle between the three layout types.
  if (pivotTable.layout.layoutType === "Compact") {
    pivotTable.layout.layoutType = "Outline";
  } else if (pivotTable.layout.layoutType === "Outline") {
    pivotTable.layout.layoutType = "Tabular";
  } else {
    pivotTable.layout.layoutType = "Compact";
  }

  await context.sync();
  console.log("Pivot layout is now " + pivotTable.layout.layoutType);
});

pivotStyle

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Estilo aplicado a la tabla dinámica.

readonly pivotStyle: Excel.PivotTableStyle;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi BETA (SOLO VERSIÓN PRELIMINAR) ]

preserveFormatting

Especifica si el formato se conserva cuando el informe se actualiza o se vuelve a calcular mediante operaciones como la dinamización, la ordenación o el cambio de elementos de campo de página.

preserveFormatting: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Set whether the PivotTable keeps the established format after it is refreshed and recalculated.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.load("preserveFormatting");
  await context.sync();

  let preserveFormattingToSet = !pivotLayout.preserveFormatting;
  console.log(`Preserve the formatting PivotTable after a refresh? - ${preserveFormattingToSet}`);

  pivotLayout.preserveFormatting = preserveFormattingToSet;
  await context.sync();
});

showColumnGrandTotals

Especifica si el informe de tabla dinámica muestra los totales generales de las columnas.

showColumnGrandTotals: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Turn the grand totals on and off for the rows and columns.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.load(["showRowGrandTotals", "showColumnGrandTotals"]);
  await context.sync();

  let showColumnTotals = !pivotLayout.showColumnGrandTotals;
  let showRowTotals = !pivotLayout.showRowGrandTotals;
  console.log(`Show column grand totals? - ${showColumnTotals}`);
  console.log(`Show row grand totals? - ${showRowTotals}`);

  pivotLayout.showColumnGrandTotals = showColumnTotals;
  pivotLayout.showRowGrandTotals = showRowTotals;

  await context.sync();
});

showFieldHeaders

Especifica si la tabla dinámica muestra encabezados de campo (títulos de campo y listas desplegables de filtros).

showFieldHeaders: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Turn the field headers on and off for the row and column hierarchies.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;
  pivotLayout.load("showFieldHeaders");
  await context.sync();

  let showHeaders = !pivotLayout.showFieldHeaders;
  console.log(`Show field headers? - ${showHeaders}`);
  pivotLayout.showFieldHeaders = showHeaders;
  await context.sync();
});

showRowGrandTotals

Especifica si el informe de tabla dinámica muestra los totales generales de las filas.

showRowGrandTotals: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Turn the grand totals on and off for the rows and columns.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.load(["showRowGrandTotals", "showColumnGrandTotals"]);
  await context.sync();

  let showColumnTotals = !pivotLayout.showColumnGrandTotals;
  let showRowTotals = !pivotLayout.showRowGrandTotals;
  console.log(`Show column grand totals? - ${showColumnTotals}`);
  console.log(`Show row grand totals? - ${showRowTotals}`);

  pivotLayout.showColumnGrandTotals = showColumnTotals;
  pivotLayout.showRowGrandTotals = showRowTotals;

  await context.sync();
});

subtotalLocation

Esta propiedad indica el SubtotalLocationType de todos los campos de la tabla dinámica. Si los campos tienen estados diferentes, será null.

subtotalLocation: Excel.SubtotalLocationType | "AtTop" | "AtBottom" | "Off";

Valor de propiedad

Excel.SubtotalLocationType | "AtTop" | "AtBottom" | "Off"

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Detalles del método

displayBlankLineAfterEachItem(display)

Establece si se va a mostrar una línea en blanco después de cada elemento. Se establece en el nivel global de la tabla dinámica y se aplica a campos dinámicos individuales. Esta función sobrescribe la configuración de todos los campos de la tabla dinámica en el valor del display parámetro .

displayBlankLineAfterEachItem(display: boolean): void;

Parámetros

display

boolean

True activa la configuración de visualización de línea en blanco. False lo desactiva.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Add a blank row after each PivotItem in the row hierarchy.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.displayBlankLineAfterEachItem(true);
  console.log("Setting `PivotLayout.displayBlankLineAfterEachItem` to true.");

  await context.sync();
});

getCell(dataHierarchy, rowItems, columnItems)

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Obtiene una única celda de la tabla dinámica en función de una jerarquía de datos y de los elementos de fila y columna de sus respectivas jerarquías. La celda devuelta es la intersección de la fila y columna determinadas que contiene los datos de la jerarquía determinada. Este método es el inverso de la llamada getPivotItems y getDataHierarchy en una celda determinada.

getCell(dataHierarchy: DataPivotHierarchy | string, rowItems: Array<PivotItem | string>, columnItems: Array<PivotItem | string>): Excel.Range;

Parámetros

dataHierarchy

Excel.DataPivotHierarchy | string

dataHierarchy que proporciona el elemento de datos que se va a buscar.

rowItems

Array<Excel.PivotItem | string>

PivotItems del eje de filas que componen el valor que se va a buscar.

columnItems

Array<Excel.PivotItem | string>

PivotItems del eje de columna que componen el valor que se va a buscar.

Devoluciones

Intervalo que especifica una sola celda que contiene el valor especificado.

Comentarios

[ Conjunto de API: ExcelApi BETA (SOLO VERSIÓN PRELIMINAR) ]

getColumnLabelRange()

Devuelve el intervalo donde residen las etiquetas de columna de la tabla dinámica.

getColumnLabelRange(): Excel.Range;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

getDataBodyRange()

Devuelve el intervalo donde residen los valores de datos de tabla dinámica.

getDataBodyRange(): Excel.Range;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-filters-and-summaries.yaml

await Excel.run(async (context) => {
    const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");

    // The layout controls the ranges used by the PivotTable.
    const range = pivotTable.layout.getDataBodyRange();

    // Get all the data hierarchy totals.
    const grandTotalRange = range.getLastRow();
    grandTotalRange.load("address");
    await context.sync();
    
    // Use the wholesale and farm sale totals to make a final sum.
    const masterTotalRange = context.workbook.worksheets.getActiveWorksheet().getRange("B27:C27");
    masterTotalRange.formulas = [["All Crates", "=SUM(" + grandTotalRange.address + ")"]];
    await context.sync();
});

getDataHierarchy(cell)

Obtiene la DataHierarchy que se usa para calcular el valor de un intervalo especificado en la tabla dinámica.

getDataHierarchy(cell: Range | string): Excel.DataPivotHierarchy;

Parámetros

cell

Excel.Range | string

Una sola celda dentro del cuerpo de datos de la tabla dinámica.

Devoluciones

Objeto DataPivotHierarchy usado para calcular el valor de la celda especificada.

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

getFilterAxisRange()

Devuelve el intervalo del área de filtro de la tabla dinámica.

getFilterAxisRange(): Excel.Range;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

getPivotItems(axis, cell)

Obtiene los elementos dinámicos de un eje que componen el valor de un intervalo especificado en la tabla dinámica.

getPivotItems(axis: Excel.PivotAxis, cell: Range | string): Excel.PivotItemCollection;

Parámetros

axis
Excel.PivotAxis

Eje desde el que se van a obtener los objetos PivotItem. Debe ser "row" o "column".

cell

Excel.Range | string

Una sola celda dentro del cuerpo de datos de la tabla dinámica.

Devoluciones

PivotItemCollection de los pivotItems que se usan para calcular los valores de la fila especificada.

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

getPivotItems(axisString, cell)

Obtiene los elementos dinámicos de un eje que componen el valor de un intervalo especificado en la tabla dinámica.

getPivotItems(axisString: "Unknown" | "Row" | "Column" | "Data" | "Filter", cell: Range | string): Excel.PivotItemCollection;

Parámetros

axisString

"Unknown" | "Row" | "Column" | "Data" | "Filter"

Eje desde el que se van a obtener los objetos PivotItem. Debe ser "row" o "column".

cell

Excel.Range | string

Una sola celda dentro del cuerpo de datos de la tabla dinámica.

Devoluciones

PivotItemCollection de los pivotItems que se usan para calcular los valores de la fila especificada.

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

getRange()

Devuelve el intervalo en el que existe la tabla dinámica, excluyendo el área de filtro.

getRange(): Excel.Range;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

getRowLabelRange()

Devuelve el intervalo donde residen las etiquetas de fila de la tabla dinámica.

getRowLabelRange(): Excel.Range;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(options?: Excel.Interfaces.PivotLayoutLoadOptions): Excel.PivotLayout;

Parámetros

options
Excel.Interfaces.PivotLayoutLoadOptions

Proporciona opciones para las propiedades del objeto que se van a cargar.

Devoluciones

load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames?: string | string[]): Excel.PivotLayout;

Parámetros

propertyNames

string | string[]

Una cadena delimitada por comas o una matriz de cadenas que especifican las propiedades que se van a cargar.

Devoluciones

load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.PivotLayout;

Parámetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select es una cadena delimitada por comas que especifica las propiedades que se van a cargar y propertyNamesAndPaths.expand es una cadena delimitada por comas que especifica las propiedades de navegación que se van a cargar.

Devoluciones

repeatAllItemLabels(repeatLabels)

Establece el valor "repetir todas las etiquetas de elemento" en todos los campos de la tabla dinámica.

repeatAllItemLabels(repeatLabels: boolean): void;

Parámetros

repeatLabels

boolean

True activa la configuración de visualización de repetición de etiquetas. False lo desactiva.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotlayout.yaml

await Excel.run(async (context) => {
  // Repeat the PivotItem labels for each row used by another level of the row hierarchy.
  const pivotTable = context.workbook.pivotTables.getItem("Farm Sales");
  const pivotLayout = pivotTable.layout;

  pivotLayout.repeatAllItemLabels(true);
  console.log("Setting `PivotLayout.repeatAllItemLabels` to true.");

  await context.sync();
});

set(properties, options)

Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto de API del mismo tipo.

set(properties: Interfaces.PivotLayoutUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parámetros

properties
Excel.Interfaces.PivotLayoutUpdateData

Objeto JavaScript con propiedades estructuradas isomórficamente con las propiedades del objeto al que se llama al método.

options
OfficeExtension.UpdateOptions

Proporciona una opción para suprimir errores si el objeto properties intenta establecer propiedades de solo lectura.

Devoluciones

void

set(properties)

Establece varias propiedades en el objeto al mismo tiempo, en función de un objeto cargado existente.

set(properties: Excel.PivotLayout): void;

Parámetros

properties
Excel.PivotLayout

Devoluciones

void

setAutoSortOnCell(cell, sortBy)

Establece la tabla dinámica para la ordenación automática mediante la celda especificada para seleccionar automáticamente el contexto y todos los criterios necesarios. Esto funciona igual que aplicar un Autoordenar desde la interfaz de usuario.

setAutoSortOnCell(cell: Range | string, sortBy: Excel.SortBy): void;

Parámetros

cell

Excel.Range | string

Una sola celda para usar obtener los criterios de para aplicar el autoort.

sortBy
Excel.SortBy

Dirección de la ordenación.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

setAutoSortOnCell(cell, sortByString)

Establece la tabla dinámica para la ordenación automática mediante la celda especificada para seleccionar automáticamente el contexto y todos los criterios necesarios. Esto funciona igual que aplicar un Autoordenar desde la interfaz de usuario.

setAutoSortOnCell(cell: Range | string, sortByString: "Ascending" | "Descending"): void;

Parámetros

cell

Excel.Range | string

Una sola celda para usar obtener los criterios de para aplicar el autoort.

sortByString

"Ascending" | "Descending"

Dirección de la ordenación.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

setStyle(style)

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Establece el estilo aplicado a la tabla dinámica.

setStyle(style: string | PivotTableStyle | BuiltInPivotTableStyle): void;

Parámetros

style

string | Excel.PivotTableStyle | Excel.BuiltInPivotTableStyle

Estilo que se va a aplicar a la tabla dinámica. Se InvalidArgumentException produce una excepción si se proporciona una cadena que no coincide con el nombre de ningún estilo.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi BETA (SOLO VERSIÓN PRELIMINAR) ]

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.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original Excel.PivotLayout es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como Excel.Interfaces.PivotLayoutData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

toJSON(): Excel.Interfaces.PivotLayoutData;

Devoluciones