GenGlyph: 2 GenGlyph Basics

Up: GEOS SDK TechDocs | Up | Prev: 1 GenGlyph Features | Next: 3 Modifying a GenGlyph

The GenGlyph object does not, by itself, offer any instance fields or messages. The functionality of a GenGlyph object is included entirely within the instance fields and messages of its superclass, GenClass .

Unlike text within a GenText, the text of a GenGlyph is taken solely from the object's GI_visMoniker . Therefore, the primary use of a GenGlyph lies in its visual moniker. Any GenClass messages dealing with an object's visual moniker will modify the appearance of a GenGlyph.

A GenGlyph does not allow word-wrapping; if your text may be longer than the object's horizontal constraints, either break up the lines of text into smaller, single-line GenGlyphs or use a GenText object.

Code Display 6-1 Using Hints to Manage GenGlyphs

/* This code will duplicate the display shown above */
@object GenInteractionClass DiskCopyBox = {
    GI_comp = @DiskCopyHeader, @SourceSelection, @DestinationSelection;
    GII_visibility = GIV_DIALOG;
    HINT_ORIENT_CHILDREN_VERTICALLY;
}
/* The DiskCopyHeader will be the line of instructional text. */
@object GenGlyphClass DiskCopyHeader = {
    GI_visMoniker = "Select source and destination for disk copy:";
    HINT_CENTER_MONIKER;			/* Centers the moniker horizontally. */
}
/* These objects will form the "Source" line. */
@object GenInteractionClass SourceSelection = {
    GI_comp = @SourceText, @SourceList;
    HINT_ORIENT_CHILDREN_HORIZONTALLY;
    HINT_CENTER_MONIKER;
}
/* This group of objects will form the "Destination" line. */
@object GenInteractionClass DestinationSelection = {
    GI_comp = @DestinationText, @DestinationList;
    HINT_ORIENT_CHILDREN_HORIZONTALLY;
    HINT_CENTER_MONIKER;
}
/* For simplicity, the List objects are not shown. */
@object GenGlyphClass SourceText = {
    GI_visMoniker = "Source:";
}
@object GenGlyphClass DestinationText = {
    GI_visMoniker = "Destination:";
}

Up: GEOS SDK TechDocs | Up | Prev: 1 GenGlyph Features | Next: 3 Modifying a GenGlyph