BlipFill Class
Picture Fill.When the object is serialized out as xml, its qualified name is pic:blipFill.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Drawing.Pictures.BlipFill
Namespace: DocumentFormat.OpenXml.Drawing.Pictures
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(Blip))> _
<ChildElementInfoAttribute(GetType(SourceRectangle))> _
<ChildElementInfoAttribute(GetType(Tile))> _
<ChildElementInfoAttribute(GetType(Stretch))> _
Public Class BlipFill _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As BlipFill
[ChildElementInfoAttribute(typeof(Blip))]
[ChildElementInfoAttribute(typeof(SourceRectangle))]
[ChildElementInfoAttribute(typeof(Tile))]
[ChildElementInfoAttribute(typeof(Stretch))]
public class BlipFill : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
DocumentFormat.OpenXml.Drawing.Blip <a:blip>
DocumentFormat.OpenXml.Drawing.SourceRectangle <a:srcRect>
DocumentFormat.OpenXml.Drawing.Tile <a:tile>
DocumentFormat.OpenXml.Drawing.Stretch <a:stretch>
[ISO/IEC 29500-1 1st Edition]
20.2.2.1 blipFill (Picture Fill)
This element specifies the type of picture fill that the picture object has. Because a picture has a picture fill already by default, it is possible to have two fills specified for a picture object. An example of this is shown below.
[Example: Consider the picture below that has a blip fill applied to it. The image used to fill this picture object has transparent pixels instead of white pixels.
<pic:pic>
…
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
</a:stretch>
</pic:blipFill>
…
</pic:pic>
The above picture object is shown as an example of this fill type. end example]
[Example: Consider now the same picture object but with an additional gradient fill applied within the shape properties portion of the picture.
<pic:pic>
…
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
</a:stretch>
</pic:blipFill>
<pic:spPr>
<a:gradFill>
<a:gsLst>
<a:gs pos="0">
<a:schemeClr val="tx2">
<a:shade val="50000"/>
</a:schemeClr>
</a:gs>
<a:gs pos="39999">
<a:schemeClr val="tx2">
<a:tint val="20000"/>
</a:schemeClr>
</a:gs>
<a:gs pos="70000">
<a:srgbClr val="C4D6EB"/>
</a:gs>
<a:gs pos="100000">
<a:schemeClr val="bg1"/>
</a:gs>
</a:gsLst>
</a:gradFill>
</pic:spPr>
…
</pic:pic>
The above picture object is shown as an example of this double fill type. end example]
Parent Elements |
---|
pic (§20.2.2.5) |
Child Elements |
Subclause |
---|---|
blip (Blip) |
§20.1.8.13 |
srcRect (Source Rectangle) |
§20.1.8.55 |
stretch (Stretch) |
§20.1.8.56 |
tile (Tile) |
§20.1.8.58 |
Attributes |
Description |
---|---|
dpi (DPI Setting) Namespace: .../drawingml/2006/main |
Specifies the DPI (dots per inch) used to calculate the size of the blip. If not present or zero, the DPI in the blip is used. [Note: This attribute is primarily used to keep track of the picture quality within a document. There are different levels of quality needed for print than on-screen viewing and thus a need to track this information. end note] The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype. |
rotWithShape (Rotate With Shape) Namespace: .../drawingml/2006/main |
Specifies that the fill should rotate with the shape. That is, when the shape that has been filled with a picture and the containing shape (say a rectangle) is transformed with a rotation then the fill is transformed with the same rotation. The possible values for this attribute are defined by the W3C XML Schema boolean datatype. |
[Note: The W3C XML Schema definition of this element’s content model (CT_BlipFillProperties) is located in §A.4.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.