<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:
<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>

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:
<v:shape ... o:bwmode="grayscale" ... >
</v:shape>

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:
<v:shape ... 
  o:bwmode="lightgrayscale" ... >
</v:shape>

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:
<v:shape ... o:bwmode="highcontrast" ... >
</v:shape>

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:
<v:shape ... fillcolor="red" ... >
</v:shape>

This is equivalent to:

<v:shape ... fillcolor="#ff0000" ... >
</v:shape>

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:
<v:shape ... filled="f" 
  fillcolor="red" ...>
</v:shape>

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>

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>