BlipFill class

Office 2013 and later

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

Namespace:  DocumentFormat.OpenXml.Drawing.Pictures
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

C#
VB
C++
Copy
No code example is currently available or this language may not be supported.

[ISO/IEC 29500-1 1st Edition]

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.

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