w:numPicBullet (Picture Bullet Definition)

Defines a picture to be used as a list bullet, referenced by its integer ID from a numbering level.

Parent elements

w:numbering

Child elements

w:pict

Description

w:numPicBullet defines a picture bullet — an image used in place of a standard text or symbol bullet in a list. Each definition has a unique w:numPicBulletId and is referenced from a w:lvl element via w:lvlPicBulletId.

It is defined in ECMA-376 Part 1 §17.9.20.

The image is contained in a child w:pict (VML) element or a wp:inline DrawingML element.

Attributes

Attribute	Type	Possible Values	Description
`w:numPicBulletId`	`xsd:integer`	Non-negative integer, unique within `numbering.xml`	Identifier used by `w:lvlPicBulletId` to reference this picture.

Examples

<!-- In numbering.xml: define picture bullet with id=1 -->
<w:numPicBullet w:numPicBulletId="1">
  <w:pict>
    <v:rect style="width:0;height:0" filled="false" stroked="false">
      <v:imagedata r:id="rId1" o:title="bullet_star"/>
    </v:rect>
  </w:pict>
</w:numPicBullet>

<!-- Referencing it from a level -->
<w:lvl w:ilvl="0">
  <w:numFmt w:val="bullet"/>
  <w:lvlPicBulletId w:val="1"/>
  <w:lvlText w:val=" "/>
  <w:lvlJc w:val="left"/>
  <w:pPr><w:ind w:left="720" w:hanging="360"/></w:pPr>
</w:lvl>

// Note: picture bullets require VML or DrawingML image parts.
// Use the Open XML SDK's NumberingPictureBullet class.
using DocumentFormat.OpenXml.Wordprocessing;

var numPicBullet = new NumberingPictureBullet
{
    NumberingPictureBulletId = 1
};
// Add w:pict with image data as a child element.

Notes

w:numPicBullet elements appear at the top level of numbering.xml, before w:abstractNum definitions.
The image part must be related to numbering.xml via a relationship with type http://schemas.openxmlformats.org/officeDocument/2006/relationships/image.
The w:lvlText value for a picture-bullet level is typically a space character (" ").