Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Changes►                                             ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIPRIMITIVES
 
typedef struct _CHARBUNDLE {    /* cbnd */
    LONG    lColor;
    LONG    lBackColor;
    USHORT  usMixMode;
    USHORT  usBackMixMode;
    USHORT  usSet;
    USHORT  usPrecision;
    SIZEF   sizfxCell;
    POINTL  ptlAngle;
    POINTL  ptlShear;
    USHORT  usDirection;
} CHARBUNDLE;
 
The CHARBUNDLE structure contains fields that describe the current character
attributes in the application's presentation space. MS OS/2 uses these
attributes whenever the application draws text using one of the Gpi
functions.
 
Field          Description
────────────────────────────────────────────────────────────────────────────
 
lColor         Specifies the character foreground color.
 
lBackColor     Specifies the character background color.
 
usMixMode      Specifies the foreground mix mode. MS OS/2 uses this mix mode
               when it combines the character foreground color and the
               current drawing-surface color.
 
usBackMixMode  Specifies the background mix mode. MS OS/2 uses this mix mode
               when it combines the character background color and the
               current drawing-surface color.
 
usSet          Specifies the character set. This value is the local
               identifier for the current logical font. It can be any value
               from 1 through 254.
 
usPrecision    Specifies the current character mode. There are three
               possible modes: mode 1, mode 2, and mode 3. If mode 1 is set
               and the current font is an image font, MS OS/2 ignores the
               current shear, angle, and box attributes. If mode 2 is set
               and the current font is an image font, MS OS/2 uses the
               current shear, angle, and box attributes. If mode 3 is set
               and the current font is an image font, MS OS/2 issues an
               error message. If the current font is a vector font, MS OS/2
               always uses the current shear, angle, and box attributes
               (regardless of the mode).
 
sizfxCell      Specifies the character-cell size (in world units). This
               SIZEF structure contains two fixed values.
 
ptlAngle       Points to the POINTL structure that contains the coordinates
               of the endpoint of the character-angle vector. The baseline
               of vector characters is drawn parallel to the character-angle
               vector.
 
ptlShear       Points to the POINTL structure that contains the coordinates
               of the endpoint of the character-shear vector. The vertical
               strokes in vector characters are drawn parallel to the
               character-shear vector.
 
usDirection    Specifies the character direction. The default direction is
               from left to right. This parameter can be one of the
               following values:
 
               Value             Meaning
               ─────────────────────────────────────────────────────────────
               CHDIRN_LEFTRIGHT  Left to right
 
               CHDIRN_RIGHTLEFT  Right to left
 
               CHDIRN_TOPBOTTOM  Top to bottom
 
               CHDIRN_BOTTOMTOP  Bottom to top
 
See Also
 
GpiQueryAttrs, GpiQueryCharAngle, GpiQueryCharBox, GpiQueryCharSet,
GpiQueryCp, GpiSetAttrs, GpiSetCharAngle, GpiSetCharBox, GpiSetCharSet,
GpiSetCp, POINTL, SIZEF
 
                                      ♦