BlipFill Class

Picture Fill.When the object is serialized out as xml, its qualified name is p:blipFill.

Namespace:  DocumentFormat.OpenXml.Presentation
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(SourceRectangle))]
[ChildElementInfoAttribute(typeof(Stretch))]
[ChildElementInfoAttribute(typeof(Blip))]
[ChildElementInfoAttribute(typeof(Tile))]
public class BlipFill : OpenXmlCompositeElement

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>
DocumentFormat.OpenXml.Presentation.BlipFill-image

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>
DocumentFormat.OpenXml.Presentation.BlipFill-image

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.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show: