Shading class
Shading class
Contains shading attributes for an object. To learn more, visit the Programming with Documents documentation article.
Inheritance: Shading → InternableComplexAttr
Properties
| Name | Description |
|---|---|
| background_pattern_color | Gets or sets the color that’s applied to the background of the Shading object. |
| background_pattern_theme_color | Gets or sets the background pattern theme color in the applied color scheme that is associated with this Shading object. |
| background_tint_and_shade | Gets or sets a double value that lightens or darkens a background theme color. |
| foreground_pattern_color | Gets or sets the color that’s applied to the foreground of the Shading object. |
| foreground_pattern_theme_color | Gets or sets the foreground pattern theme color in the applied color scheme that is associated with this Shading object. |
| foreground_tint_and_shade | Gets or sets a double value that lightens or darkens a foreground theme color. |
| texture | Gets or sets the shading texture. |
Methods
| Name | Description |
|---|---|
| clear_formatting() | Removes shading from the object. |
| equals(rhs) | Determines whether the specified Shading is equal in value to the current Shading. |
Examples
Shows how to apply border and shading color while building a table.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Start a table and set a default color/thickness for its borders.
table = builder.start_table()
table.set_borders(aw.LineStyle.SINGLE, 2, aspose.pydrawing.Color.black)
# Create a row with two cells with different background colors.
builder.insert_cell()
builder.cell_format.shading.background_pattern_color = aspose.pydrawing.Color.light_sky_blue
builder.writeln('Row 1, Cell 1.')
builder.insert_cell()
builder.cell_format.shading.background_pattern_color = aspose.pydrawing.Color.orange
builder.writeln('Row 1, Cell 2.')
builder.end_row()
# Reset cell formatting to disable the background colors
# set a custom border thickness for all new cells created by the builder,
# then build a second row.
builder.cell_format.clear_formatting()
builder.cell_format.borders.left.line_width = 4
builder.cell_format.borders.right.line_width = 4
builder.cell_format.borders.top.line_width = 4
builder.cell_format.borders.bottom.line_width = 4
builder.insert_cell()
builder.writeln('Row 2, Cell 1.')
builder.insert_cell()
builder.writeln('Row 2, Cell 2.')
doc.save(file_name=ARTIFACTS_DIR + 'DocumentBuilder.TableBordersAndShading.docx')
Shows how to decorate text with borders and shading.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
borders = builder.paragraph_format.borders
borders.distance_from_text = 20
borders.get_by_border_type(aw.BorderType.LEFT).line_style = aw.LineStyle.DOUBLE
borders.get_by_border_type(aw.BorderType.RIGHT).line_style = aw.LineStyle.DOUBLE
borders.get_by_border_type(aw.BorderType.TOP).line_style = aw.LineStyle.DOUBLE
borders.get_by_border_type(aw.BorderType.BOTTOM).line_style = aw.LineStyle.DOUBLE
shading = builder.paragraph_format.shading
shading.texture = aw.TextureIndex.TEXTURE_DIAGONAL_CROSS
shading.background_pattern_color = aspose.pydrawing.Color.light_coral
shading.foreground_pattern_color = aspose.pydrawing.Color.light_salmon
builder.write('This paragraph is formatted with a double border and shading.')
doc.save(file_name=ARTIFACTS_DIR + 'DocumentBuilder.ApplyBordersAndShading.docx')
See Also
- module aspose.words
- class InternableComplexAttr