Two main colors are defined - a foreground color and a background color. Different fillTypes use these values differently. In addition to the foreground and background any number of shade colors can be defined. Each shade color is associated with a "position" which says how far into the shade the color appears – colors must be given in position order.
For a solid fill the foreground color is used and the background (and everything else except transparency) is ignored. For pattern and texture fills the fillBlip identifies a BLIP, which will be used for the fill.
fillWidth and fillHeight define the desired pattern/texture size in EMUs. The pattern/tile will be expanded to this size. If the pattern is a bitmap the actual size will be rounded to a close integer multiple of the original (pixel) size of the bitmap. If the size is 0 then the pattern/tile will not be expanded or contracted at all in pixel terms, so the fill will be device dependent - this may result in non-proportional scaling between devices (on devices with non-square pixels).
For a pattern the foreground and background colors define the colors to use when filling with a pattern, for a texture the colors are in the bitmap (this is the only difference).
For both pattern and texture fills the fill is registered with (0,0) on the view in which the effect appears unless fillShape is set to TRUE, in which case the pattern/texture is registered relative to the shape (so it moves with the shape).
For a picture fill the fillBlip is centered in the shape - not tiled.
For a shaded fill the colors define shade bands to use across the shade, shading between each pair of colors. The positions are the positions of the shade at which the given color appears - the shade ends with the first index that is >= 1 (in 16.16 notation), the indices must be in ascending order or the result is undefined. The interpretation of the shade start and shade end points varies according to the exact shade type.
The fillBackground fill indicates a fill inherited from a background object.
Property | PID | Type | Default | Description | ||
fillType | 384 | MSOFILLTYPE | Solid | Type of fill | ||
fillColor | 385 | MSOCLR | white | Foreground color | ||
fillOpacity | 386 | LONG | 1<<16 | Fixed 16.16 | ||
fillBackColor | 387 | MSOCLR | white | Background color | ||
fillBackOpacity | 388 | LONG | 1<<16 | Shades only | ||
fillCrMod | 389 | MSOCLR | undefined | Modification for BW views | ||
fillBlip | 390 | IMsoBlip* | NULL | Pattern/texture | ||
fillBlipName | 391 | WCHAR* | NULL | Blip file name | ||
fillBlipFlags | 392 | MSOBLIPFLAGS | Comment | Blip flags | ||
fillWidth | 393 | LONG | 0 | How big (A units) to make a metafile texture. | ||
fillHeight | 394 | LONG | 0 | |||
fillAngle | 395 | LONG | 0 | Fade angle - degrees in 16.16 | ||
fillFocus | 396 | LONG | 0 | Linear shaded fill focus percent | ||
fillToLeft | 397 | LONG | 0 | Fraction 16.16 | ||
fillToTop | 398 | LONG | 0 | Fraction 16.16 | ||
fillToRight | 399 | LONG | 0 | Fraction 16.16 | ||
fillToBottom | 400 | LONG | 0 | Fraction 16.16 | ||
fillRectLeft | 401 | LONG | 0 | For shaded fills, use the specified rectangle instead of the shape's bounding rect to define how large the fade is going to be. | ||
fillRectTop | 402 | LONG | 0 | |||
fillRectRight | 403 | LONG | 0 | |||
fillRectBottom | 404 | LONG | 0 | |||
fillDztype | 405 | MSODZTYPE | Default | |||
fillShadePreset | 406 | LONG | 0 | Special shades | ||
fillShadeColors | 407 | IMsoArray | NULL | a preset array of colors | ||
fillOriginX | 408 | LONG | 0 | |||
fillOriginY | 409 | LONG | 0 | |||
fillShapeOriginX | 410 | LONG | 0 | |||
fillShapeOriginY | 411 | LONG | 0 | |||
fillShadeType | 412 | MSOSHADETYPE | Default | Type of shading, if a shaded (gradient) fill. | ||
fFilled | 443 | BOOL | TRUE | Is shape filled? | ||
fHitTestFill | 444 | BOOL | TRUE | Should we hit test fill? | ||
fillShape | 445 | BOOL | TRUE | Register pattern on shape | ||
fillUseRect | 446 | BOOL | FALSE | Use the large rect? | ||
fNoFillHitTest | 447 | BOOL | FALSE | Hit test a shape as though filled | ||