BlipFill Class
Defines the BlipFill Class.When the object is serialized out as xml, its qualified name is a:blipFill.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Drawing.BlipFill
Namespace: DocumentFormat.OpenXml.Drawing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(Tile))> _
<ChildElementInfoAttribute(GetType(SourceRectangle))> _
<ChildElementInfoAttribute(GetType(Blip))> _
<ChildElementInfoAttribute(GetType(Stretch))> _
Public Class BlipFill _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As BlipFill
[ChildElementInfoAttribute(typeof(Tile))]
[ChildElementInfoAttribute(typeof(SourceRectangle))]
[ChildElementInfoAttribute(typeof(Blip))]
[ChildElementInfoAttribute(typeof(Stretch))]
public class BlipFill : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
Blip <a:blip>
SourceRectangle <a:srcRect>
Tile <a:tile>
Stretch <a:stretch>
[ISO/IEC 29500-1 1st Edition]
20.1.8.14 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.
<p:pic>
…
<p:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
</a:stretch>
</p:blipFill>
…
</p:pic>
.jpg "DocumentFormat.OpenXml.Drawing.BlipFill-image001")
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.
<p:pic>
…
<p:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
</a:stretch>
</p:blipFill>
<p: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>
</p:spPr>
…
</p:pic>
.jpg "DocumentFormat.OpenXml.Drawing.BlipFill-image002")
The above picture object is shown as an example of this double fill type. end example]
Parent Elements |
|---|
bg (§21.4.3.1); bgFillStyleLst (§20.1.4.1.7); bgPr (§19.3.1.2); defRPr (§21.1.2.3.2); endParaRPr (§21.1.2.2.3); fill (§20.1.8.28); fill (§20.1.4.2.9); fillOverlay (§20.1.8.29); fillStyleLst (§20.1.4.1.13); grpSpPr (§21.3.2.14); grpSpPr (§20.1.2.2.22); grpSpPr (§20.5.2.18); grpSpPr (§19.3.1.23); pic (§20.1.2.2.30); rPr (§21.1.2.3.9); spPr (§21.2.2.197); spPr (§21.3.2.23); spPr (§21.4.3.7); spPr (§20.1.2.2.35); spPr (§20.2.2.6); spPr (§20.5.2.30); spPr (§19.3.1.44); tblPr (§21.1.3.15); tcPr (§21.1.3.17); uFill (§21.1.2.3.12) |
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) |
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) |
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.