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
'Declaración
<ChildElementInfoAttribute(GetType(Fill))> _
Public Class Background _
Inherits OpenXmlCompositeElement
'Uso
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 1ª edición]
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:
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. Los extractos anteriores han sido traducidos del inglés al español por Microsoft (o algunos de sus agentes) e ISO no asume ningún tipo de responsabilidad por dichas traducciones.
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.