Workbook clase

Representa un objeto raíz para crear una hoja de cálculo de Excel.

El tipo Workbook expone los siguientes miembros:

Constructores

Constructor	Descripción
`__init__(self)`	Inicializa una nueva instancia de la clase `Workbook`.
`__init__(self, file_format_type)`	Inicializa una nueva instancia de la clase `Workbook`.
`__init__(self, file)`	Inicializa una nueva instancia de la clase `Workbook` y abre un archivo.
`__init__(self, stream)`	Inicializa una nueva instancia de la clase `Workbook` y abre un flujo.
`__init__(self, file, load_options)`	Inicializa una nueva instancia de la clase `Workbook` y abre un archivo.
`__init__(self, stream, load_options)`	Inicializa una nueva instancia de la clase `Workbook` y abre el flujo.

Propiedades

Propiedad	Descripción
settings	Representa la configuración del libro.
worksheets	Obtiene la colección `WorksheetCollection` en la hoja de cálculo.
is_licensed	Indica si la licencia está establecida.
colors	Devuelve colores en la paleta de la hoja de cálculo.
count_of_styles_in_pool	Obtiene el número de estilos en el grupo de estilos.
default_style	Obtiene o establece el objeto `Style` predeterminado del libro de trabajo.
is_digitally_signed	Indica si esta hoja de cálculo está firmada digitalmente.
is_workbook_protected_with_password	Indica si la estructura o ventana está protegida con contraseña.
vba_project	Obtiene el `Workbook.vba_project` en una hoja de cálculo.
has_macro	Indica si esta hoja de cálculo contiene macro/VBA.
has_revisions	Obtiene si el libro de trabajo tiene algún cambio registrado
file_name	Obtiene y establece el nombre del archivo actual.
cells_data_table_factory	Obtiene la fábrica para crear ICellsDataTable a partir de objetos personalizados
data_sorter	Obtiene un objeto DataSorter para ordenar datos.
theme	Obtiene el nombre del tema.
built_in_document_properties	Devuelve una colección `DocumentProperty` que representa todas las propiedades de documento integradas de la hoja de cálculo.
custom_document_properties	Devuelve una colección `DocumentProperty` que representa todas las propiedades del documento personalizado de la hoja de cálculo.
file_format	Obtiene y establece el formato de archivo.
has_custom_function	Detecta si se utiliza una función personalizada en este libro de trabajo. como por ejemplo en la fórmula de la celda, en los nombres definidos…
content_type_properties	Obtiene la lista de `ContentTypeProperty` objetos en el libro de trabajo.
custom_xml_parts	Representa una parte de almacenamiento de datos XML personalizado (datos XML personalizados dentro de un paquete).
data_mashup	Obtiene datos combinados.
ribbon_xml	Obtiene y establece el archivo XML que define la interfaz de usuario de la cinta.
absolute_path	Obtiene y establece la ruta absoluta del archivo.
data_connections	Obtiene la colección ExternalConnection.
data_model	Obtiene el modelo de datos en el libro de trabajo.

Métodos

Método	Descripción
`save(self, file_name, save_format)`	Guarda el libro de trabajo en el disco.
`save(self, file_name)`	Guarde el libro de trabajo en el disco.
`save(self, file_name, save_options)`	Guarda el libro de trabajo en el disco.
`save(self, stream, save_format)`	Guarda el libro de trabajo en la secuencia.
`save(self, stream, save_options)`	Guarda el libro de trabajo en la secuencia.
`create_style(self)`	Crea un nuevo estilo.
`create_style(self, clone_default_style)`	Crea un nuevo estilo.
`replace(self, place_holder, new_value)`	Reemplaza el valor de una celda con una nueva cadena.
`replace(self, place_holder, new_value)`	Reemplaza el valor de una celda con un nuevo entero.
`replace(self, place_holder, new_value)`	Reemplaza el valor de una celda con un nuevo doble.
`replace(self, place_holder, new_values, is_vertical)`	Reemplaza el valor de una celda con una nueva matriz de cadenas.
`replace(self, place_holder, new_values, is_vertical)`	Reemplaza los valores de las celdas con una matriz de números enteros.
`replace(self, place_holder, new_values, is_vertical)`	Reemplaza los valores de las celdas con una matriz doble.
`replace(self, bool_value, new_value)`	Reemplaza los valores de las celdas con datos nuevos.
`replace(self, int_value, new_value)`	Reemplaza los valores de las celdas con datos nuevos.
`replace(self, place_holder, new_value, options)`	Reemplaza el valor de una celda con una nueva cadena.
`copy(self, source, copy_options)`	Copia otro objeto de libro de trabajo.
`copy(self, source)`	Copia datos de un objeto de libro de trabajo de origen.
`calculate_formula(self)`	Calcula el resultado de fórmulas.
`calculate_formula(self, ignore_error)`	Calcula el resultado de fórmulas.
`calculate_formula(self, options)`	Cálculo de fórmulas en este libro de trabajo.
`refresh_dynamic_array_formulas(self, calculate)`	Actualiza fórmulas de matriz dinámica (se extienden a un nuevo rango de celdas vecinas según los datos actuales) Otras fórmulas del libro de trabajo no se calcularán de forma recursiva incluso si se utilizan mediante fórmulas de matriz dinámica.
`refresh_dynamic_array_formulas(self, calculate, copts)`	Actualiza fórmulas de matriz dinámica (se extienden a un nuevo rango de celdas vecinas según los datos actuales)
`import_xml(self, url, sheet_name, row, col)`	Importa/actualiza un archivo de datos XML en el libro de trabajo.
`import_xml(self, stream, sheet_name, row, col)`	Importa/actualiza un archivo de datos XML en el libro de trabajo.
`export_xml(self, map_name, path)`	Exportar datos XML vinculados por el mapa XML especificado.
`export_xml(self, map_name, stream)`	Exportar datos XML.
`parse_formulas(self, ignore_error)`	Analiza todas las fórmulas que no se analizaron cuando se cargaron desde un archivo de plantilla o se establecieron en una celda.
`start_access_cache(self, opts)`	Inicia la sesión que utiliza cachés para acceder a los datos.
`close_access_cache(self, opts)`	Cierra la sesión que utiliza cachés para acceder a los datos.
`remove_unused_styles(self)`	Eliminar todos los estilos no utilizados.
`create_builtin_style(self, type)`	Crea un estilo integrado según el tipo dado.
`create_cells_color(self)`	Crea un objeto `CellsColor`.
`combine(self, second_workbook)`	Combina otro objeto de libro de trabajo.
`get_style_in_pool(self, index)`	Obtiene el estilo en el grupo de estilos. Todos los estilos del libro de trabajo se reunirán en un grupo. Sólo hay un índice de referencia simple en las celdas.
`get_fonts(self)`	Obtiene todas las fuentes en el grupo de estilos.
`get_named_style(self, name)`	Obtiene el estilo nombrado en el grupo de estilos.
`merge_named_styles(self, source)`	Fusiona estilos con nombre del otro archivo Excel.
`change_palette(self, color, index)`	Cambia la paleta de la hoja de cálculo en el índice especificado.
`is_color_in_palette(self, color)`	Comprueba si un color está en la paleta de la hoja de cálculo.
`get_matching_color(self, raw_color)`	Encuentre el color que mejor coincida en la paleta actual.
`set_encryption_options(self, encryption_type, key_length)`	Establecer opciones de cifrado.
`protect(self, protection_type, password)`	Protege un libro de trabajo.
`protect_shared_workbook(self, password)`	Protege un libro de trabajo compartido.
`unprotect(self, password)`	Desprotege un libro de trabajo.
`unprotect_shared_workbook(self, password)`	Desprotege un libro de trabajo compartido.
`remove_macro(self)`	Elimina VBA/macro de esta hoja de cálculo.
`remove_digital_signature(self)`	Elimina la firma digital de esta hoja de cálculo.
`accept_all_revisions(self)`	Acepta todos los cambios rastreados en el libro de trabajo.
`remove_external_links(self)`	Elimina todos los enlaces externos en el libro de trabajo.
`get_theme_color(self, type)`	Obtiene el color del tema.
`set_theme_color(self, type, color)`	Establece el color del tema
`custom_theme(self, theme_name, colors)`	Costumbres del tema.
`copy_theme(self, source)`	Copia el tema de otro libro de trabajo.
`has_exernal_links(self)`	Indica si este libro de trabajo contiene enlaces externos a otras fuentes de datos.
`update_custom_function_definition(self, definition)`	Actualiza la definición de funciones personalizadas.
`update_linked_data_source(self, external_workbooks)`	Si este libro de trabajo contiene enlaces externos a otras fuentes de datos, Aspose.Cells intentará recuperar los datos más recientes de las fuentes proporcionadas.
`set_digital_signature(self, digital_signature_collection)`	Establece una firma digital en un archivo de hoja de cálculo (Excel 2007 y posterior).
`add_digital_signature(self, digital_signature_collection)`	Agrega una firma digital a un archivo de hoja de cálculo OOXML (Excel2007 y posteriores).
`get_digital_signature(self)`	Obtiene la firma digital del archivo.
`remove_personal_information(self)`	Elimina información personal.
`close(self)`	Dispose() es omitido por el contenedor desde el protocolo Python

Observaciones

La clase Workbook corresponde a una hoja de cálculo de Excel. Cada hoja de cálculo puede contener varias hojas de cálculo. La característica básica de la clase es abrir y guardar archivos nativos de Excel. La clase tiene algunas funciones avanzadas como copiar datos de otros libros de trabajo, combinar dos libros de trabajo, convertir Excel a PDF, convertir Excel a imagen y proteger la hoja de cálculo de Excel.

Ejemplo

El siguiente ejemplo carga un Workbook desde un archivo Excel llamado designer.xls y hace invisibles las barras de desplazamiento horizontal y vertical. Luego reemplaza dos valores de cadena con un valor entero y un valor de cadena respectivamente dentro de la hoja de cálculo y finalmente guarda el libro como archivo xlsx de Excel.

from aspose.cells import Workbook

# Open a designer file
designerFile = "designer.xls"
workbook = Workbook(designerFile)
# Set scroll bars
workbook.settings.is_h_scroll_bar_visible = False
workbook.settings.is_v_scroll_bar_visible = False
# Replace the placeholder string with new values
newInt = 100
workbook.replace("OldInt", newInt)
newString = "Hello!"
workbook.replace("OldString", newString)
workbook.save("result.xlsx")

Ver también

WarningInfo clase WorkbookDesigner clase