CellFormat class
CellFormat class
Represents all formatting for a table cell. To learn more, visit the Working with Tables documentation article.
Properties
| Name | Description |
|---|---|
| borders | Gets collection of borders of the cell. |
| bottom_padding | Returns or sets the amount of space (in points) to add below the contents of cell. |
| fit_text | If True, fits text in the cell, compressing each paragraph to the width of the cell. |
| hide_mark | Returns or sets visibility of cell mark. |
| horizontal_merge | Specifies how the cell is merged horizontally with other cells in the row. |
| left_padding | Returns or sets the amount of space (in points) to add to the left of the contents of cell. |
| orientation | Returns or sets the orientation of text in a table cell. |
| preferred_width | Returns or sets the preferred width of the cell. |
| right_padding | Returns or sets the amount of space (in points) to add to the right of the contents of cell. |
| shading | Returns a Shading object that refers to the shading formatting for the cell. |
| top_padding | Returns or sets the amount of space (in points) to add above the contents of cell. |
| vertical_alignment | Returns or sets the vertical alignment of text in the cell. |
| vertical_merge | Specifies how the cell is merged with other cells vertically. |
| width | Gets the width of the cell in points. |
| wrap_text | If True, wrap text for the cell. |
Methods
| Name | Description |
|---|---|
| clear_formatting() | Resets to default cell formatting. Does not change the width of the cell. |
| set_paddings(left_padding, top_padding, right_padding, bottom_padding) | Sets the amount of space (in points) to add to the left/top/right/bottom of the contents of cell. |
Examples
Shows how to build a table with custom borders.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
builder.start_table()
# Setting table formatting options for a document builder
# will apply them to every row and cell that we add with it.
builder.paragraph_format.alignment = aw.ParagraphAlignment.CENTER
builder.cell_format.clear_formatting()
builder.cell_format.width = 150
builder.cell_format.vertical_alignment = aw.tables.CellVerticalAlignment.CENTER
builder.cell_format.shading.background_pattern_color = aspose.pydrawing.Color.green_yellow
builder.cell_format.wrap_text = False
builder.cell_format.fit_text = True
builder.row_format.clear_formatting()
builder.row_format.height_rule = aw.HeightRule.EXACTLY
builder.row_format.height = 50
builder.row_format.borders.line_style = aw.LineStyle.ENGRAVE_3D
builder.row_format.borders.color = aspose.pydrawing.Color.orange
builder.insert_cell()
builder.write('Row 1, Col 1')
builder.insert_cell()
builder.write('Row 1, Col 2')
builder.end_row()
# Changing the formatting will apply it to the current cell,
# and any new cells that we create with the builder afterward.
# This will not affect the cells that we have added previously.
builder.cell_format.shading.clear_formatting()
builder.insert_cell()
builder.write('Row 2, Col 1')
builder.insert_cell()
builder.write('Row 2, Col 2')
builder.end_row()
# Increase row height to fit the vertical text.
builder.insert_cell()
builder.row_format.height = 150
builder.cell_format.orientation = aw.TextOrientation.UPWARD
builder.write('Row 3, Col 1')
builder.insert_cell()
builder.cell_format.orientation = aw.TextOrientation.DOWNWARD
builder.write('Row 3, Col 2')
builder.end_row()
builder.end_table()
doc.save(file_name=ARTIFACTS_DIR + 'DocumentBuilder.InsertTable.docx')
Shows how to modify the format of rows and cells in a table.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
table = builder.start_table()
builder.insert_cell()
builder.write('City')
builder.insert_cell()
builder.write('Country')
builder.end_row()
builder.insert_cell()
builder.write('London')
builder.insert_cell()
builder.write('U.K.')
builder.end_table()
# Use the first row's "RowFormat" property to modify the formatting
# of the contents of all cells in this row.
row_format = table.first_row.row_format
row_format.height = 25
row_format.borders.get_by_border_type(aw.BorderType.BOTTOM).color = aspose.pydrawing.Color.red
# Use the "CellFormat" property of the first cell in the last row to modify the formatting of that cell's contents.
cell_format = table.last_row.first_cell.cell_format
cell_format.width = 100
cell_format.shading.background_pattern_color = aspose.pydrawing.Color.orange
doc.save(file_name=ARTIFACTS_DIR + 'Table.RowCellFormat.docx')
Shows how to modify formatting of a table cell.
doc = aw.Document(file_name=MY_DIR + 'Tables.docx')
table = doc.first_section.body.tables[0]
first_cell = table.first_row.first_cell
# Use a cell's "CellFormat" property to set formatting that modifies the appearance of that cell.
first_cell.cell_format.width = 30
first_cell.cell_format.orientation = aw.TextOrientation.DOWNWARD
first_cell.cell_format.shading.foreground_pattern_color = aspose.pydrawing.Color.light_green
doc.save(file_name=ARTIFACTS_DIR + 'Table.CellFormat.docx')
See Also
- module aspose.words.tables