Background Class
Document Background.When the object is serialized out as xml, its qualified name is v:background.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Vml.Background
Namespace: DocumentFormat.OpenXml.Vml
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(Fill))> _
Public Class Background _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As Background
[ChildElementInfoAttribute(typeof(Fill))]
public class Background : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
- Fill <v:fill>
[ISO/IEC 29500-1 1st Edition]
14.1.2.2 background (Document Background)
This element describes the fill of the background of a page using vector graphics fills. Fills consist of simple colors, more advanced effects defined through the fill element (§14.1.2.5), or images.
[Example: The following shades the page background a pale red:
<v:background fillcolor="#c0504d">
</v:background>
This uses the fill element (§14.1.2.5) to create a gradient background fill:
<v:background>
<v:fill type="gradient" color="#c0504d" color2="#f0504d" angle="45"/>
</v:background>
end example]
Parent Elements |
|---|
background (Part 1, §17.2.1); object (Part 1, §17.3.3.19); pict (§9.2.2.2); pict (§9.5.1) |
Child Elements |
Subclause |
|---|---|
fill (Shape Fill Properties) |
§14.1.2.5 |
Attributes |
Description |
|---|---|
bwmode (Black-and-White Mode) Namespace: urn:schemas-microsoft-com:office:office |
Specifies how a shape renders for black-and-white output devices. When a shape is printed on a black-and-white printer or displayed in a black-and-white view in an application, several options are possible. Default is auto, which uses o:bwnormal for normal black-and-white rendering and o:bwpure for pure black-and-white rendering [Example: This shape renders in grayscale in a black-and-white environment: end example] The possible values for this attribute are defined by the ST_BWMode simple type (§14.2.3.3). |
bwnormal (Normal Black-and-White Mode) Namespace: urn:schemas-microsoft-com:office:office |
Specifies the black-and-white mode for normal black-and-white output devices. Default is auto. [Example: This shape renders in a pale grayscale in a normal black-and-white environment: end example] The possible values for this attribute are defined by the ST_BWMode simple type (§14.2.3.3). |
bwpure (Pure Black-and-White Mode) Namespace: urn:schemas-microsoft-com:office:office |
Specifies the black-and-white mode for pure black-and-white output devices. Default is auto. [Example: This shape renders in high contrast when in a pure black-and-white environment: end example] The possible values for this attribute are defined by the ST_BWMode simple type (§14.2.3.3). |
fillcolor (Fill Color) |
Specifies the color to use for the fill. Default is white. If the fill element (§14.1.2.5) is present, its color attribute takes precedence. Colors are typically specified as either a named color, such as red, or six hexadecimal digits representing the red, green and blue values of the color, such as #00FF30. Full details are specified in the simple type description. [Example: This shape is red if its fill is visible: This is equivalent to: end example] The possible values for this attribute are defined by the ST_ColorType simple type (§15.1.2.3). |
filled (Shape Fill Toggle) |
Specifies whether the closed path is filled. Default is true. This attribute is overridden by the fill on attribute. [Example: .png "DocumentFormat.OpenXml.Vml.Background-image001")
end example] The possible values for this attribute are defined by the ST_TrueFalse simple type (§15.1.2.5). |
id (Unique Identifier) |
Specifies a unique identifier that can be used to reference a VML object. Default is no value. [Example: end example] The possible values for this attribute are defined by the W3C XML Schema string datatype. |
targetscreensize (Target Screen Size) Namespace: urn:schemas-microsoft-com:office:office |
Specifies the target resolution used for WordprocessingML documents with a gradient or picture filled background. Default is no value. Allowed values are:
The possible values for this attribute are defined by the ST_ScreenSize simple type (§14.2.3.23). |
[Note: The W3C XML Schema definition of this element’s content model (CT_Background) is located in §A.6.1. end note]
© ISO/IEC29500: 2008.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.