PivotTable clase

PivotTable clase

Descripción resumida de PivotTable.

El tipo PivotTable expone los siguientes miembros:

Propiedades

PropiedadDescripción
is_excel_2003_compatibleEspecifica si la tabla dinámica es compatible con Excel2003 al actualizar la tabla dinámica.
si es verdadero, una cadena debe tener menos o igual a 255 caracteres, por lo que si la cadena tiene más de 255 caracteres,
quedará truncado. si es falso, una cadena no tendrá la restricción antes mencionada.
El valor por defecto es verdadero.
refreshed_by_whoObtiene el nombre del usuario que actualizó la tabla dinámica por última vez.
refresh_dateObtiene la fecha en la que se actualizó por última vez la tabla dinámica.
pivot_table_style_nameObtiene y establece el nombre del estilo de la tabla dinámica.
pivot_table_style_typeObtiene y establece el estilo de la tabla dinámica integrada.
column_fieldsDevuelve un objeto PivotFields que actualmente se muestra como campos de columna.
row_fieldsDevuelve un objeto PivotFields que actualmente se muestra como campos de fila.
page_fieldsDevuelve un objeto PivotFields que actualmente se muestra como campos de página.
data_fieldsObtiene un objeto PivotField que representa todos los campos de datos de una tabla dinámica.
Solo lectura. Se iniciará solo cuando haya dos o más campos de datos en DataPiovtFiels.
Solo se usa para agregar DataPivotField al área de fila/columna de la tabla dinámica. El valor predeterminado está en el área de la fila.
data_fieldObtiene un objeto PivotField que representa todos los campos de datos de una tabla dinámica.
Solo lectura. Se iniciará solo cuando haya dos o más campos de datos en DataPiovtFiels.
Solo se usa para agregar DataPivotField al área de fila/columna de la tabla dinámica. El valor predeterminado está en el área de la fila.
base_fieldsDevuelve un objeto PivotFields que incluye todos los campos del informe de tabla dinámica
pivot_filtersDevuelve un objeto PivotFilterCollection.
column_rangeDevuelve un objeto CellArea que representa el rango
que contiene el área de la columna en el informe de tabla dinámica. Solo lectura.
row_rangeDevuelve un objeto CellArea que representa el rango
que contiene el área de la fila en el informe de tabla dinámica. Solo lectura.
data_body_rangeDevuelve un objeto CellArea que representa el rango que contiene el área de datos
en la lista entre la fila del encabezado y la fila de inserción. Solo lectura.
table_range1Devuelve un objeto CellArea que representa el rango que contiene todo el informe de tabla dinámica.
pero no incluye campos de página. Solo lectura.
table_range2Devuelve un objeto CellArea que representa el rango que contiene todo el informe de tabla dinámica.
Incluye campos de página. Solo lectura.
column_grandIndica si el informe de tabla dinámica muestra los totales generales de las columnas.
is_grid_drop_zonesIndica si el informe de tabla dinámica muestra un diseño de tabla dinámica clásico.
(permite arrastrar campos en la cuadrícula)
row_grandIndica si el informe de tabla dinámica muestra totales generales para las filas.
display_null_stringIndica si el informe de tabla dinámica muestra una cadena personalizada
en celdas que contienen valores nulos.
null_stringObtiene la cadena que se muestra en las celdas que contienen valores nulos.
cuando la propiedad DisplayNullString es verdadera. El valor predeterminado es una cadena vacía.
display_error_stringIndica si el informe de tabla dinámica muestra una cadena personalizada en las celdas que contienen errores.
data_field_header_nameObtiene y establece el nombre del encabezado del campo del área de valor en la tabla dinámica.
error_stringObtiene la cadena que se muestra en las celdas que contienen errores.
cuando la propiedad DisplayErrorString es verdadera. El valor predeterminado es una cadena vacía.
is_auto_formatIndica si el informe de tabla dinámica se formatea automáticamente.
Casilla de verificación “tabla de formato automático” que se encuentra en la opción de tabla dinámica para Excel 2003
autofit_column_width_on_updateIndica si el ancho de columna se ajusta automáticamente al actualizar
auto_format_typeObtiene el tipo de formato automático de tabla dinámica.
has_blank_rowsIndica si se deben agregar filas en blanco.
Esta propiedad solo se aplica a los tipos de formato automático de tabla dinámica que necesitan agregar filas en blanco.
merge_labelsIndica si el elemento de la fila exterior, el elemento de la columna, el subtotal, el elemento de la fila exterior del informe de tabla dinámica especificado.
y las etiquetas de total general utilizan celdas combinadas.
preserve_formattingIndica si el formato se conserva cuando se actualiza o se vuelve a calcular la tabla dinámica.
show_drillObtiene si se muestran los botones expandir/contraer.
enable_drilldownObtiene si la profundización está habilitada.
enable_field_dialogIndica si el cuadro de diálogo Campo de tabla dinámica está disponible
cuando el usuario hace doble clic en el campo de la tabla dinámica.
enable_field_listObtiene si se habilita la lista de campos para la tabla dinámica.
enable_wizardIndica si el Asistente para tablas dinámicas está disponible.
subtotal_hidden_page_itemsIndica si los elementos de campo de página ocultos en el informe de tabla dinámica
se incluyen en subtotales de filas y columnas, totales de bloque y totales generales.
El valor predeterminado es Falso.
grand_total_nameDevuelve la etiqueta de cadena de texto que se muestra en el encabezado de la columna o fila del total general.
El valor predeterminado es la cadena “Gran Total”.
manual_updateIndica si el informe de tabla dinámica se vuelve a calcular solo a petición del usuario.
is_multiple_field_filtersEspecifica un valor booleano que indica si los campos de una tabla dinámica pueden tener varios filtros establecidos.
missing_items_limitEspecifica un valor booleano que indica si los campos de una tabla dinámica pueden tener varios filtros establecidos.
enable_data_value_editingEspecifica un valor booleano que indica si el usuario puede editar las celdas en el área de datos de la tabla dinámica.
Habilitar la edición de celdas en el área de valores
show_data_tipsEspecifica un valor booleano que indica si se debe mostrar información sobre herramientas para las celdas de datos de la tabla dinámica.
show_member_property_tipsEspecifica un valor booleano que indica si la información de propiedad del miembro debe omitirse en la información sobre herramientas de la tabla dinámica.
show_values_rowEspecifica un valor booleano que indica si se muestra la fila de valores.
mostrar la fila de valores
show_empty_colEspecifica un valor booleano que indica si se deben incluir columnas vacías en la tabla.
show_empty_rowEspecifica un valor booleano que indica si se deben incluir filas vacías en la tabla.
field_list_sort_ascendingEspecifica un valor booleano que indica si los campos de la tabla dinámica están ordenados en un orden no predeterminado en la lista de campos.
print_drillEspecifica un valor booleano que indica si se deben imprimir los indicadores de exploración.
Imprima los botones de expandir/contraer cuando se muestren en la tabla dinámica.
alt_text_titleObtiene el título del altertext.
alt_text_descriptionObtiene la descripción del texto alternativo.
nameObtiene el nombre de la tabla dinámica.
column_header_captionObtiene el título del encabezado de columna de la tabla dinámica.
indentEspecifica el incremento de sangría para el eje compacto y se puede utilizar para configurar el diseño del informe en formato compacto.
row_header_captionObtiene el título del encabezado de fila de la tabla dinámica.
show_row_header_captionIndica si el título del encabezado de fila se muestra en el informe de tabla dinámica
Indica si Mostrar títulos de campo y menús desplegables de filtro
custom_list_sortIndica si se considera la lista personalizada incorporada al ordenar datos
pivot_format_conditionsObtiene las condiciones de formato de la tabla dinámica.
page_field_orderObtiene el orden en que se agregan los campos de página al diseño del informe de tabla dinámica.
page_field_wrap_countObtiene el número de campos de página en cada columna o fila del informe de tabla dinámica.
tagObtiene una cadena guardada con el informe de tabla dinámica.
save_dataIndica si los datos del informe de tabla dinámica se guardan con el libro.
refresh_data_on_opening_fileIndica si se actualizan los datos al abrir el archivo.
refresh_data_flagIndica si se están actualizando datos o no.
external_connection_data_sourceObtiene el origen de datos de la conexión externa.
data_sourceObtiene y establece el origen de datos de la tabla dinámica.
pivot_formatsObtiene la colección de formatos aplicados a la tabla dinámica.
item_print_titlesUn bit que especifica si los títulos de los elementos pivotantes en el eje de la fila
se repiten en cada página impresa para los campos dinámicos en forma tabular.
print_titlesIndica si los títulos de impresión de la hoja de cálculo están configurados en función
en el informe de tabla dinámica. El valor predeterminado es falso.
display_immediate_itemsIndica si los elementos en las áreas de fila y columna son visibles
cuando el área de datos de la tabla dinámica está vacía. El valor por defecto es verdadero.
is_selectedIndica si la tabla dinámica está seleccionada.
show_pivot_style_row_headerIndica si el encabezado de fila en la tabla dinámica debe tener aplicado el estilo.
show_pivot_style_column_headerIndica si el encabezado de columna de la tabla dinámica debe tener aplicado el estilo.
show_pivot_style_row_stripesIndica si se aplica el formato de franja de fila.
show_pivot_style_column_stripesIndica si se aplica el formato de franja de columna.
show_pivot_style_last_columnIndica si se aplica el formato de franja de columna.

Métodos

MétodoDescripción
remove_fieldElimina un campo de un área de campo específica
remove_fieldElimina un campo de un área de campo específica
remove_fieldEliminar campo de un área de campo específica
add_field_to_areaAgrega el campo al área específica.
add_field_to_areaAgrega el campo al área específica.
add_field_to_areaAgrega el campo al área específica.
add_calculated_fieldAgrega un campo calculado al campo dinámico.
add_calculated_fieldAgrega un campo calculado para pivotar el campo y arrastrarlo al área de datos.
moveMueve la tabla dinámica a una ubicación diferente en la hoja de trabajo.
moveMueve la tabla dinámica a una ubicación diferente en la hoja de trabajo.
formatDa formato al área seleccionada de la tabla dinámica.
formatFormatee la celda en el área de la tabla dinámica
set_auto_group_fieldEstablece el grupo de campos automático según la tabla dinámica.
set_auto_group_fieldEstablece el grupo de campos automático según la tabla dinámica.
set_manual_group_fieldEstablece el grupo de campos manual según la tabla dinámica.
set_manual_group_fieldEstablece el grupo de campos manual según la tabla dinámica.
set_manual_group_fieldEstablece el grupo de campos manual según la tabla dinámica.
set_manual_group_fieldEstablece el grupo de campos manual según la tabla dinámica.
set_ungroupConjuntos desagrupados por la tabla dinámica
set_ungroupConjuntos desagrupados por la tabla dinámica
copy_styleCopia el estilo con nombre de otra tabla dinámica.
show_report_filter_pageMuestra todas las páginas de filtrado del informe según PivotField, el PivotField debe estar ubicado en PageFields.
show_report_filter_page_by_nameMuestra todas las páginas de filtro del informe según el nombre de PivotField, el PivotField debe estar ubicado en PageFields.
show_report_filter_page_by_indexMostrar todas las páginas de filtro del informe según el índice de posición en PageFields
fieldsObtiene los campos específicos por tipo de campo.
change_data_sourceEstablezca los datos de origen de la tabla dinámica.
Hoja1!$A$1:$C$3
get_sourceObtenga los datos de origen de la tabla dinámica.
refresh_dataActualiza los datos de la tabla dinámica y la configuración desde su fuente de datos.
calculate_dataCalcula los datos de la tabla dinámica en celdas.
clear_dataBorrar los datos y el formato de la tabla dinámica
calculate_rangeCalcula el rango de la tabla dinámica.
format_allFormatee todas las celdas en el área de la tabla dinámica
format_rowFormatee los datos de la fila en el área de la tabla dinámica
get_horizontal_breaksobtener la lista de índice de filas de la tabla dinámica de saltos de página horizontales
show_in_compact_formDiseña la tabla dinámica en forma compacta.
show_in_outline_formDiseña la tabla dinámica en forma de esquema.
show_in_tabular_formDiseña la tabla dinámica en forma tabular.
get_cell_by_display_nameObtiene el objeto Cell por el nombre para mostrar de PivotField.
get_childrenObtiene las tablas dinámicas secundarias que utilizan estos datos de la tabla dinámica como fuente de datos.

Ejemplo

from aspose.cells import FormatConditionType, OperatorType, Workbook
from aspose.cells.pivot import PivotFieldType, PivotFilterType, PivotTableStyleType
from aspose.pydrawing import Color

book = Workbook()
sheet = book.worksheets[0]
cells = sheet.cells
cells.get(0, 0).value = "fruit"
cells.get(1, 0).value = "grape"
cells.get(2, 0).value = "blueberry"
cells.get(3, 0).value = "kiwi"
cells.get(4, 0).value = "cherry"
cells.get(5, 0).value = "grape"
cells.get(6, 0).value = "blueberry"
cells.get(7, 0).value = "kiwi"
cells.get(8, 0).value = "cherry"
cells.get(0, 1).value = "year"
cells.get(1, 1).value = 2020
cells.get(2, 1).value = 2020
cells.get(3, 1).value = 2020
cells.get(4, 1).value = 2020
cells.get(5, 1).value = 2021
cells.get(6, 1).value = 2021
cells.get(7, 1).value = 2021
cells.get(8, 1).value = 2021
cells.get(0, 2).value = "amount"
cells.get(1, 2).value = 50
cells.get(2, 2).value = 60
cells.get(3, 2).value = 70
cells.get(4, 2).value = 80
cells.get(5, 2).value = 90
cells.get(6, 2).value = 100
cells.get(7, 2).value = 110
cells.get(8, 2).value = 120
pivots = sheet.pivot_tables
pivotIndex = pivots.add("=Sheet1!A1:C9", "A12", "TestPivotTable")
pivot = pivots[pivotIndex]
pivot.add_field_to_area(PivotFieldType.ROW, "fruit")
pivot.add_field_to_area(PivotFieldType.COLUMN, "year")
pivot.add_field_to_area(PivotFieldType.DATA, "amount")
pivot.pivot_table_style_type = PivotTableStyleType.PIVOT_TABLE_STYLE_MEDIUM10
# Change PivotField's attributes
rowField = pivot.row_fields[0]
rowField.display_name = "custom display name"
# Add PivotFilter
index = pivot.pivot_filters.add(0, PivotFilterType.COUNT)
filter = pivot.pivot_filters[index]
filter.auto_filter.filter_top10(0, False, False, 2)
# Add PivotFormatCondition
formatIndex = pivot.pivot_format_conditions.add()
pfc = pivot.pivot_format_conditions[formatIndex]
fcc = pfc.format_conditions
fcc.add_area(pivot.data_body_range)
idx = fcc.add_condition(FormatConditionType.CELL_VALUE)
fc = fcc[idx]
fc.formula1 = "100"
fc.operator = OperatorType.GREATER_OR_EQUAL
fc.style.background_color = Color.red
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")

Ver también