Работа с колони и редове
За повече контрол върху това как работят таблиците, научете се как да манипулирате колони и редове.
Намиране на индекса на елементите в таблицата
Колони, редове и клетки се управляват чрез достъп до избрания документен възел чрез неговия индекс. Намирането на индекс на всеки възел включва събиране на всички детски възли от типа елемент от базовия възел, и след това използване на IndexOf метод за намиране на индекса на желания възел в колекцията.
Намиране на индекс на таблица в документ
Понякога може да се наложи да направите промени в определена таблица в документ. За да направите това, можете да се позовавате на таблица по нейния индекс.
Следният пример за код показва как да се извлече индексът на таблица в документ:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
table = doc.get_child(aw.NodeType.TABLE, 0, True).as_table() | |
all_tables = doc.get_child_nodes(aw.NodeType.TABLE, True) | |
table_index = all_tables.index_of(table) |
Намиране на индекс на ред в таблица
По същия начин, може да се наложи да направите промени в определен ред в избрана таблица. За да направите това, можете да се обърнете към ред по неговия индекс.
Следният пример за код показва как да се извлече индексът на ред в таблица:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
row_index = table.index_of(table.last_row) |
Намиране на индекс на клетка в ред
И накрая, може да се наложи да се направят промени в определена клетка и можете да направите това по клетъчен индекс, както добре.
Следният пример с код показва как да се извлече индексът на клетка в ред:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
cell_index = row.index_of(row.cells[4]) |
Работа с колони
В Aspose.Words Document Object Model (DOM), Table Възелът се състои от Row Възли и после Cell Възли. По този начин в Document
Модел на обекта Aspose.Words, както в Word документи, няма понятие за колона.
По дизайн, редовете в таблицата Microsoft Word както и Aspose.Words са напълно независими и основните свойства и операции се съдържат само в редовете и клетките на таблицата. Това дава на таблиците способността да имат някои интересни атрибути:
- Всеки ред на масата може да има напълно различен брой клетки
- Вертикално, клетките на всеки ред могат да имат различни ширини
- Възможно е да се присъединят таблици с различен ред формати и брой клетки
Всички операции, извършвани върху колони са всъщност “къси пътища,” които извършват операцията чрез колективно смяна на редовите клетки по такъв начин, че изглежда, че се прилагат към колони. Това означава, че можете да извършвате операции на колоните, като просто итерирате върху същия индекс на редовете.
Следният пример за код опростява такива операции чрез доказване на фасаден клас, който събира клетките, които съставляват “колони” на таблица:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
class Column: | |
"""Represents a facade object for a column of a table in a Microsoft Word document.""" | |
def __init__(self, table: aw.tables.Table, column_index: int): | |
if table is None: | |
raise ValueError("table") | |
self.table = table | |
self.column_index = column_index | |
def index_of(self, cell: aw.tables.Cell): | |
"""Returns the index of the given cell in the column.""" | |
return self.get_column_cells().index(cell) | |
def insert_column_before(self): | |
"""Inserts a brand new column before this column into the table.""" | |
column_cells = self.get_column_cells() | |
if len(column_cells) == 0: | |
raise ValueError("Column must not be empty") | |
# Create a clone of this column. | |
for cell in column_cells: | |
cell.parent_row.insert_before(cell.clone(False), cell) | |
# This is the new column. | |
column = self.__class__(column_cells[0].parent_row.parent_table, self.column_index) | |
# We want to make sure that the cells are all valid to work with (have at least one paragraph). | |
for cell in column.get_column_cells(): | |
cell.ensure_minimum() | |
# Increase the index which this column represents since there is now one extra column in front. | |
self.column_index += 1 | |
return column | |
def remove(self): | |
"""Removes the column from the table.""" | |
for cell in self.get_column_cells(): | |
cell.remove() | |
def to_txt(self): | |
"""Returns the text of the column.""" | |
return "".join(cell.to_string(aw.SaveFormat.TEXT) for cell in self.get_column_cells()) | |
def get_column_cells(self): | |
"""Provides an up-to-date collection of cells which make up the column represented by this facade.""" | |
column_cells = [] | |
for row in self.table.rows: | |
cell = row.as_row().cells[self.column_index] | |
if cell is not None: | |
column_cells.append(cell) | |
return column_cells | |
Следният пример с код показва как да се постави празна колона в таблица:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
doc = aw.Document(MY_DIR + "Tables.docx") | |
table = doc.get_child(aw.NodeType.TABLE, 0, True).as_table() | |
column = self.Column(table, 0) | |
# Print the plain text of the column to the screen. | |
print(column.to_txt()) | |
# Create a new column to the left of this column. | |
# This is the same as using the "Insert Column Before" command in Microsoft Word. | |
new_column = column.insert_column_before() | |
for cell in new_column.get_column_cells(): | |
cell.first_paragraph.append_child(aw.Run(doc, "Column Text " + str(new_column.index_of(cell)))) |
Следният пример за код показва как да се премахне колона от таблица в документ:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
doc = aw.Document(MY_DIR + "Tables.docx") | |
table = doc.get_child(aw.NodeType.TABLE, 1, True).as_table() | |
column = self.Column(table, 2) | |
column.remove() |
Задаване на редове като заглавни редове
Можете да изберете да повторите първия ред в таблицата като Header Row само на първата страница или на всяка страница, ако таблицата е разделена на няколко. В Aspose.Words, Можете да повторите заглавието на всяка страница с помощта на HeadingFormat собственост.
Можете също така да маркирате няколко заглавни редове, ако тези редове са разположени един след друг в началото на таблицата. За да направите това, трябва да приложите HeadingFormat свойства на тези редове.
Следният пример за код показва как да се изгради таблица, която включва Заглавни редове, които се повтарят на следващите страници:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
builder.start_table() | |
builder.row_format.heading_format = True | |
builder.paragraph_format.alignment = aw.ParagraphAlignment.CENTER | |
builder.cell_format.width = 100 | |
builder.insert_cell() | |
builder.writeln("Heading row 1") | |
builder.end_row() | |
builder.insert_cell() | |
builder.writeln("Heading row 2") | |
builder.end_row() | |
builder.cell_format.width = 50 | |
builder.paragraph_format.clear_formatting() | |
for _ in range(50): | |
builder.insert_cell() | |
builder.row_format.heading_format = False | |
builder.write("Column 1 Text") | |
builder.insert_cell() | |
builder.write("Column 2 Text") | |
builder.end_row() | |
doc.save(ARTIFACTS_DIR + "WorkingWithTables.repeat_rows_on_subsequent_pages.docx") |
Запазване на таблици и редове от прекъсване на страниците
Има моменти, когато съдържанието на таблицата не трябва да се разделя на страници. Например, ако заглавието е над една маса, заглавието и таблицата трябва винаги да се държат заедно на една и съща страница, за да се запази правилното външен вид.
Има две отделни техники, които са полезни за постигане на тази функционалност:
Allow row break across pages
, за редове в таблицатаKeep with next
, които се прилагат към параграфи в таблици
По подразбиране горните свойства са изключени.
Запазване на ред от прекъсване на страниците
Това включва ограничаване на съдържанието в клетките на един ред от разделяне на една страница. В Microsoft Word, това може да се намери под Table Properties като опцията готварски ред да се прекъсне през страниците. В Aspose.Words това е открито под RowFormat обект на a Row като свойство RowFormat.AllowBreakAcrossPages.
Следният пример за код показва как да се деактивират редовете на страниците за всеки ред в таблица:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
doc = aw.Document(MY_DIR + "Table spanning two pages.docx") | |
table = doc.get_child(aw.NodeType.TABLE, 0, True).as_table() | |
# Disable breaking across pages for all rows in the table. | |
for row in table.rows: | |
row.as_row().row_format.allow_break_across_pages = False | |
doc.save(ARTIFACTS_DIR + "WorkingWithTables.row_format_disable_break_across_pages.docx") |
Запазване на таблица от прекъсване на страниците
За да спрем разделянето на таблицата между страниците, трябва да уточним, че искаме съдържанието в таблицата да остане заедно.
За да направите това, Aspose.Words използва метод, който позволява на потребителите да избират таблица и позволява KeepWithNext параметър към true за всеки параграф в рамките на таблиците. Изключението е последният параграф от таблицата, който следва да бъде определен false.
Следният пример за код показва как да се постави таблица, за да останем заедно на една и съща страница:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git. | |
doc = aw.Document(MY_DIR + "Table spanning two pages.docx") | |
table = doc.get_child(aw.NodeType.TABLE, 0, True).as_table() | |
# We need to enable KeepWithNext for every paragraph in the table to keep it from breaking across a page, | |
# except for the last paragraphs in the last row of the table. | |
for cell in table.get_child_nodes(aw.NodeType.CELL, True): | |
cell = cell.as_cell() | |
cell.ensure_minimum() | |
for para in cell.paragraphs: | |
para = para.as_paragraph() | |
if not (cell.parent_row.is_last_row and para.is_end_of_cell): | |
para.paragraph_format.keep_with_next = True | |
doc.save(ARTIFACTS_DIR + "WorkingWithTables.keep_table_together.docx") |