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 (§6.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 (§6.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 (§2.2.1); object (§2.3.3.19); pict (§2.3.3.21); pict (§2.9.23) |
|
Child Elements |
Subclause |
|
fill (Shape Fill Properties) |
§6.1.2.5 |
|
Attributes |
Description |
|
bwmode (Black-and-White Mode)
Namespace: urn:schemas-microsoft-com:office:office |
Specifies how a shape will render 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 will use 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:
<v:shape ... o:bwmode="grayscale" ... > </v:shape>
end example]
The possible values for this attribute are defined by the ST_BWMode simple type (§6.2.3.2). |
|
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:
<v:shape ... o:bwmode="lightgrayscale" ... > </v:shape>
end example]
The possible values for this attribute are defined by the ST_BWMode simple type (§6.2.3.2). |
|
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:
<v:shape ... o:bwmode="highcontrast" ... > </v:shape>
end example]
The possible values for this attribute are defined by the ST_BWMode simple type (§6.2.3.2). |
|
fillcolor (Fill Color) |
Specifies the color to use for the fill. Default is white. If the fill element (§6.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:
<v:shape ... fillcolor="red" ... > </v:shape>
This is equivalent to:
<v:shape ... fillcolor="#ff0000" ... > </v:shape>
end example]
The possible values for this attribute are defined by the ST_ColorType simple type (§6.1.3.1). |
|
filled (Shape Fill Toggle) |
Specifies whether the closed path will be filled. Default is true. This attribute is overridden by the fill on attribute.
[Example:
fillcolor="red" ...> </v:shape>
end example]
The possible values for this attribute are defined by the ST_TrueFalse simple type (§6.1.3.14). |
|
id (Unique Identifier) |
Specifies a unique identifier that can be used to reference a VML object.
Default is no value.
[Example:
<v:shape ... id="myShape" ... > </v:shape>
end example]
The possible values for this attribute are defined by the 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:
• 544,376 • 640,480 • 720,512 • 800,600 • 1024,768 • 1152,862
The possible values for this attribute are defined by the ST_ScreenSize simple type (§6.2.3.22). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Background">
<sequence>
<element ref="fill" minOccurs="0"/>
</sequence>
<attributeGroup ref="AG_Id"/>
<attributeGroup ref="AG_Fill"/>
<attribute ref="o:bwmode"/>
<attribute ref="o:bwpure"/>
<attribute ref="o:bwnormal"/>
<attribute ref="o:targetscreensize"/>
</complexType>