BlipFill Class
Picture Fill.When the object is serialized out as xml, its qualified name is p:blipFill.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Presentation.BlipFill
Namespace: DocumentFormat.OpenXml.Presentation
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(SourceRectangle))> _
<ChildElementInfoAttribute(GetType(Stretch))> _
<ChildElementInfoAttribute(GetType(Blip))> _
<ChildElementInfoAttribute(GetType(Tile))> _
Public Class BlipFill _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As BlipFill
[ChildElementInfoAttribute(typeof(SourceRectangle))]
[ChildElementInfoAttribute(typeof(Stretch))]
[ChildElementInfoAttribute(typeof(Blip))]
[ChildElementInfoAttribute(typeof(Tile))]
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]
19.3.1.4 blipFill (Picture Fill)
This element specifies the kind 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>
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>
The above picture object is shown as an example of this double fill type. end example]
Parent Elements |
---|
pic (§19.3.1.37) |
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.