Convertidors

API interna Les classes d’aquesta pàgina no formen part de l’API pública i no s’exporten des del nivell superior. aspose.words_foss Els paquets de dades són utilitzats internament per l’export. La majoria dels desenvolupadors han d’utilitzar Document.save() En lloc d’això. Gestió de base per a l’API pública.

Aspose.Words FOSS for Python uses specialized converter classes to transform the internal document model into output formats. ParagraphConverter gestiona el text i el format, TableConverter manipuladors de estructures de taules, i ListHandler gestiona el formatatge de listes. Aquestes classes són detalls d’implementació i poden canviar sense previ avís.

Convertidor de paràgrafs

ParagraphConverter Transforma els paràgrafs del document en el format de sortida objectiu. Inspecta el formatge dels paràgrams, l’estil a nivell d’execució i el contingut inline.

Mètode	Descripció
`ParagraphConverter.get_paragraph_info()`	Extracció d’informació de formatatge des d"un paràgraf
`ParagraphConverter.get_run_formatting()`	Obtindre detalls de formatatge per a una executat text
`ParagraphConverter.format_text()`	Aplicar formatatge al contingut de text

Convertidor de taules

TableConverter converteix les taules de document en el format objectiu (com ara tauleles d’apunt).

Mètode	Descripció
`TableConverter.convert()`	Convertir un element de taula al format d’ sortida

Mantenidor de llistes

ListHandler gestiona l’estat de la llista durant la conversió del document, el nesting de les llistes d’enregistrament, els marcadors i el format.

Mètode	Descripció
`ListHandler.set_reader()`	Configurar el lector de documents per al context d’una llista
`ListHandler.reset()`	Estat de seguiment de la llista d’instauració
`ListHandler.get_list_info()`	Obtindre detalls d’un paràgraf per a l’article de la llista
`ListHandler.format_list_item()`	Formatar un element de llista amb marcador i indentament
`ListHandler.break_list()`	Final de senyal d’una seqüència de llistes

Consells i millors pràctiques

Els convertidors s’utilitzen internament per l’export la majoria dels desenvolupadors interactuen amb els convertors. Document.save() en lloc d’això.
ParagraphConverter.format_text() Respecta el context del bloc de codi per evitar aplicar formatatge en línia dins d’intervals de còdes.
ListHandler manté l’estat en els paràgrafs de la llista consecutiva crida reset() Quan s’inicia una secció de document nou

Problemàtiques comuns

Edició	Causa	Correcció
Columnes de taula desalineades	La taula d’entrada ha fusionat cèl·lules.	`TableConverter` tracta taules simples; les cèl·lules fusionades poden produir sortides inesperades.
Numeració de llistes trencades	No restablir l’estat de la llista entre seccions	L’anomenaràs. `ListHandler.reset()` als límits de la secció

Resum de referència d’API

Classe / mètode	Descripció
`ParagraphConverter.get_paragraph_info()`	Formateig de paràgrafs d’extracció
`ParagraphConverter.get_run_formatting()`	Obtindre el formatatge de nivell d’exécution
`ParagraphConverter.format_text()`	Aplicar formatatge al text
`TableConverter.convert()`	Convertir una taula en format de sortida
`ListHandler.set_reader()`	Ajustar el context del lector de documents
`ListHandler.get_list_info()`	Obtindre detalls d’elements de la llista
`ListHandler.format_list_item()`	Formatar un element de llista