Chapter 2:
Common Attributes


ATTRIBUTE

Description

A_AREABACKCOLOR

Area background color

A_AREACOLOR_ALPHA

Opacity/Transparency (Alpha Channel) for areas

A_AREACOLOR_NONE

Area Color None (transparent)

A_AREACOLOR_RGB

Area Color definition

A_AREADROPSHADOW

Area Drop Shadow

A_AREAPATTERN

Area pattern definition

A_AREASFX

Area Special Effects definition

A_FONT_FANCYBOX

Font Fancy Box definition

A_FONT_LEADING

Font Leading

A_FONTALIGN

Font Alignment

A_FONTBACKCOLOR

Font Background Color

A_FONTCHARSET

Font Character Set

A_FONTCOLOR_NONE

Font Color None (transparent)

A_FONTCOLOR_RGB

Font Color definition

A_FONTDROPSHADOW

Font Drop Shadow

A_FONTNAME

Font Name

A_FONTNAME_MBC

Font Name using mix single-byte fonts

A_FONTORIENT

Font Orientation

A_FONTORIENTCUSTOM

Font Orientation Custom angle

A_FONTPATTERN

Font Pattern definition

A_FONTSFX

Font Special Effects definition

A_FONTSIZE_LIMIT

Font Size Limit

A_FONTSIZE_POINT_100

Font Point Size in 100th/Point Units

A_FONTSIZE_VC

Font Size in Virtual Coordinates

A_FONTSTYLE

Font Style (underline, bold, etc.)

A_GLOW

Glow data objects mode on/off

A_GLOW_COLOR

Glow data object's color

A_GLOW_MODE

Glow inside, outside, both

A_GLOW_THICKNESS

Glow thickness

A_GRAPH_PRESET

Graph Preset (graph type and subtype)

A_LINECOLOR_ALPHA

Opacity/Transparency (Alpha Channel) for lines

A_LINECOLOR_NONE

Line Color None (transparent)

A_LINECOLOR_RGB

Line Color definition

A_LINEPATTERN

Line Pattern (e.g. solid, dash, dot, dot and dash)

A_LINESFX

Line Special Effects definition

A_LINEWIDTH

Line Width (in virtual coordinates)

A_LINEWIDTH_POINT_100

Line Width in 100th/Point Units

A_LOCATE_FOOTNOTE

Locate Footenote (position/size of bounding box)

A_LOCATE_FRAME

Locate Frame (position/size of chart frame)

A_LOCATE_SUBTITLE

Locate Subtitle (position/size of bounding box)

A_LOCATE_TITLE

Locate Title (position/size of bounding box)

A_LOCK_FONTSIZE

Lock Font Size

A_SHOW_FOOTNOTE

Show/Hide Footnote

A_SHOW_SUBTITLE

Show/Hide Subtitle

A_SHOW_TITLE

Show/Hide Title

A_SUPPRESS

Suppress data

A_AREABACKCOLOR

 

This attribute sets the background color for patterns.

Type:

typedef struct {
     UINT16 red;      //0...65535
     UINT16 green;    //0...65535
     UINT16 blue;     //0...65535
} RGB16, FAR *RGB16Ptr;

Valid Range:

See the RGB16 structure in Appendix A.

Default:

255,255,255 (White)

Example:

static RGB16 aRGB[8] = {0,0,0}/* BLACK */
SetGraphAttrSI(gpGraph,gpSelItem,
     A_AREABACKCOLOR,&aRGB[1]);

Notes:

If you use SetGraphAttr(), you must specify the object ID of an area object to indicate the object to which this attribute is to be applied. See Appendix B for a list of area objects. You may use a series ID to select a particular area object.

Also See:

A_AREACOLOR_NONE, A_AREACOLOR_RGB, A_AREACOLOR_ALPHA

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Area

Optional

Optional

All

   

A_AREACOLOR_ALPHA

 

The value assigned to this attribute is assigned to the nAlpha (Alpha Channel) member of the color instance record (ColorInstRec) associated with a particular area object. The value of this attribute makes the object's color more opaque or transparent.

Type:

INT16

Valid Range:

0..255 (255 = opaque, 0 = transparent)

Default:

255

Example:

In the following illustration, the riser that represents the January series (normally red) has its A_AREACOLOR_ALPHA attribute set to 128.

 

Also See:

A_LINECOLOR_ALPHA

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Area

Optional

Optional

All

         
         

A_AREACOLOR_NONE

 

This attribute can be used to make an area object transparent. If the area is transparent, the underlying elements are seen behind the area. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular area object. Use a group and/or series ID to select a particular instance of an area object.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

This area has no color; it is transparent.

 

FALSE=

This area is not transparent; use the normal color settings.

Default:

FALSE

Example:

SetGraphAttrSI(gpGraph,gpSelItem,A_AREACOLOR_NONE,&bTRUE);

Notes:

This attribute overrides A_AREACOLOR_RGB when drawing occurs. If A_AREACOLOR_NONE is TRUE, the area will remain transparent regardless of the A_AREACOLOR_RGB setting. This attribute must be explicitly set to FALSE in order to see an area's color.

Also See:

A_AREABACKCOLOR, A_AREACOLOR_RGB, A_AREACOLOR_ALPHA

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Area

Optional

Optional

All

   

A_AREACOLOR_RGB

 

This attribute sets the color of an area object. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular area object. Use a group and/or series ID to select a particular instance of an area object.

Type:

typedef struct {
     UINT16 red;      //0...65535
     UINT16 green;    //0...65535
     UINT16 blue;     //0...65535
} RGB16, FAR *RGB16Ptr;

Valid Range:

See the RGB16 structure in Appendix A.

Default:

None

Notes:

1.

For API use via Set/GetGraphAttr(), a copy of the structure RGB16 should be used (e.g., RGB16 myRGBstruct;).

 

2.

The library does not modify the system color palette. If your application requires colors in addition to those in the system palette, your application must create and realize a logical palette into the system palette.

 

3.

If an ObjectID and/or Series ID is not specified or SetGraphAttrSL is used to apply the attribute, the color will be applied to all area objects.

 

4.

If the O2D_RISER ObjectID is used and A2D_COLORBYSERIES is FALSE (color by group), the SeriesID will actually select the group rather than the series.

 

5.

For more accurate color with ACM_COLOR_MODEL, set this attribute after DrawTheGraph() or DryRunTheGraph().

 

6.

You can set the PGSDK default area instance by setting Object ID, Series ID, and Group ID to -3. This default area will be the initial color assigned to any annotation object created by CreateAnode().

Also See:

A_AREABACKCOLOR, A_AREACOLOR_NONE, A_AREACOLOR_ALPHA, A2D_COLORBYSERIES, ACM_COLOR_MODEL

Usage

ObjectID

SeriesID

GroupID

GraphTypes

 

Area

Optional

Optional

All

         

A_AREADROPSHADOW

 

This attribute assigns a drop shadow to an area object. The drop shadow is drawn with the color specified, offset from the object by the virtual coordinate of nXoff and nYoff. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular area object. Use a group and/or series ID to select a particular instance of an area object.

Type:

typedef struct {
     INT16 nXoff;     /* virtual x offset */
     INT16 nYoff;     /* virtual y offset */
     UINT16 nRed;     /* RGB values */
     UINT16 nGreen;   /* RGB values */
     UINT16 nBlue;    /* RGB values */
} DropShadowInstRec, FAR *DropShadowInstPtr;

Valid Range:

See the DropShadowInstRec in Appendix A.

 

nRed, nGreen, and nBlue: 0...65535 for desired color

Default:

None

Example:

DropShadowInstRec Shadow;
Shadow.nXoff = 100;
Shadow.nYoff = 120;
Shadow.nRed = 0;
Shadow.nGreen = 0;
Shadow.nBlue = 0;
UpdateMenu (hmenu,&wEffect,wParam);
SetGraphAttrSL(gpGraph,gpList,A_AREADROPSHADOW,&Shadow);

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of an area object to indicate the object to which this attribute is to be applied. See Appendix B for a list of area objects. You may use a series ID to select a particular area object.

 

2.

Setting nXoff and nYoff to zero disables any previous drop shadow. Drop shadows are not objects and cannot be selected, they are considered attributes of an object.

Usage

ObjectID

SeriesID

GroupID

GraphTypes

 

Area

Optional

Optional

All

A_AREAPATTERN

 

This attribute assigns a pattern to an area object. For Windows applications, the system uses the patterns installed by default. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular area object. Use a group and/or series ID to select a particular instance of an area object.

Type:

INT16

Valid Range:

-6...6

 

-6 =

Diagonal cross with transparent background

 

-5 =

Cross with transparent background

 

-4 =

Backward diagonal with transparent background

 

-3 =

Forward diagonal with transparent background

 

-2 =

Vertical with transparent background

 

-1 =

Horizontal with transparent background

 

0 =

Solid

 

1 =

Horizontal with solid background

 

2 =

Vertical with solid background

 

3 =

Forward diagonal with solid background

 

4 =

Backward diagonal with solid background

 

5 =

Cross with solid background

 

6 =

Diagonal cross with solid background

Default:

0 (SOLID)

Example:

See SAMP14.C
SetGraphAttrSI(gpGraph,gpSelItem,A_AREAPATTERN,&pat[1]);

Notes:

1.

In the current Windows architecture, patterns can only have one of the 20 colors defined in the Windows default palette. If any other color is assigned to the pattern, Windows will use the closest "pure color" match it can find. Use the A_AREACOLOR_RGB attribute to set/change the color of the pattern. The background color is always white and cannot be changed.

 

2.

These patterns are the current test patterns in our SHELL application. The actual number and description of patterns may change based on the controlling application.

Also See:

A_FONT_PATTERN, A_LINE_PATTERN

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Area

Optional

Optional

All

         

A_AREASFX

 

This attribute applies a special effect (e.g., wash or bitmap/picture) to an area object. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular area object. Use a group and/or series ID to select a particular instance of an area object.

Type:

typedef struct
{
     INT16 effect;
     union
     {
          WashRecord wash;
          PictureRecord picture;
          BrushRecord brush;
          AdvancedWashRecord advwash;
     } info;
} FXStruct, *FXPtr;

Valid Range:

See the FXStruct data structure in Appendix A.

Default:

None.

Example:

FXStruct aSFX;
aSFX.effect = ADVANCED_WASH_FX;
aSFX.info.advwash.startColor = aRGB[4];
aSFX.info.advwash.endColor = aRGB[0];
aSFX.info.advwash.nOffsetX = 50;
aSFX.info.advwash.nOffsetY = 100;
aSFX.info.advwash.nAngle = 45;
aSFX.info.advwash.nSteps = 0;
aSFX.info.advwash.nWashType = WashLinear;
aSFX.info.advwash.nScale = 0;
SetGraphAttrSL( gpGraph, gpList,A_AREASFX, &aSFX );

 

Notes:

1.

When a picture special effect is specified, the system will use an existing, compatible bit-map file in your application environment if an invalid file name or format is specified.

 

2.

Also see the picture call back function in the PGSDK Programmer's Manual.

Also See:

A_FONTSFX, A_LINESFX

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Area

Optional

Optional

All

A_FONT_FANCYBOX

 

Fancy boxes are rectangles that are drawn behind a given text or area object. They have different effects like bevels or extrusion so that the text stands out. Fancy boxes have an area fill, so they respond to calls to change area color, area pattern, etc.. Fancy boxes also have a line style, so they respond to changes to line width, line color, etc. This attribute applies a fancy box to a selected font object. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular text object. Use a group and/or series ID to select a particular instance of an text object.

Type:

typedef struct _FancyBoxRec {
     INT16 nShape;
     INT16 nStyle;
} FancyBoxRec, FAR *FancyBoxPtr;

Valid Range:

See the FancyBoxRec in Appendix A.

Default:

None

Example:

// Put a single-line octagon box behind the x-axis
// labels on a bar chart
FancyBoxRec MyFancyBox;
MyFancyBox.nShape = fbOctagon;
MyFancyBox.nStyle = FrameSingleLine;
SetGraphAttr(pGraph, GRAPH_LAYER, O2D_O1_LABEL, 0, 0,
     A_FONT_FANCYBOX, &MyFancyBox);

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         
         

A_FONT_LEADING

 

This attribute is used to adjust the space between lines on multi-line labels.

Type:

INT16

Valid Range:

-100...500 (+100 = double leading)

Default:

0 (default leading)

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTALIGN

 

This attribute defines the alignment of text in its bounding box. The text can be left, right, center, or full-justified in its bounding box. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular text object.

Type:

INT16

Valid Range:

Select a value from the FontAlignType enum:

 

FontAlignType

Value

Description

 

ALIGN_LEFT

0

Align text object left justified

 

ALIGN_CENTER

1

Center text object

 

ALIGN_RIGHT

2

Align text object right justified

 

ALIGN_JUSTIFY

3

Full Justify Text object

Default:

ALIGN_LEFT

Example:

INT16 Left = ALIGN_LEFT;
INT16 Right = ALIGN_RIGHT;
INT16 Center = ALIGN_CENTER;
SetGraphAttr ( gpGraph,GRAPH_LAYER,O5D_LBLTITLE,
     NULL_SERIESID,NULL_GROUPID,A_FONTALIGN, &Left);
SetGraphAttr ( gpGraph, GRAPH_LAYER,O5D_LBLSUBTITLE,
     NULL_SERIESID, NULL_GROUPID,A_FONTALIGN, &Right);
SetGraphAttr ( gpGraph, GRAPH_LAYER,O5D_LBLFOOTNOTE,
     NULL_SERIESID, NULL_GROUPID,A_FONTALIGN, &Center);

 

Notes:

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

Also See:

A_FONTORIENT

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTBACKCOLOR

 

This attribute sets the background color for text objects. If you use setGraphAttr() to apply this attribute, specify the object ID of a particular text object.

Type:

typedef struct {
     UINT16 red;      //0...65535
     UINT16 green;    //0...65535
     UINT16 blue;     //0...65535
} RGB16, FAR *RGB16Ptr;

Valid Range:

See the RGB16 structure in Appendix A.

Default:

255,255,255 (White)

Example:

static RGB16 aRGB[8] = {0,0,0}/* BLACK */
SetGraphAttrSI(gpGraph,gpSelItem,
     A_FONTBACKCOLOR,&aRGB[1]);

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

Also See:

A_FONTCOLOR_NONE, A_FONTCOLOR_RGB

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTCHARSET

 

This attribute defines the character set that will be used to draw the specified text object using the font specified by A_FONTNAME. The A_FONTNAME attribute defines a font name, character set, and pitch and family. This attribute can be used to change the character set only.

Type:

INT16

Valid Range:

Use a constant that is defined in your application platform that identifies a font character set (e.g., ANSI_CHARSET).

Default:

For Windows: ANSI_CHARSET. All others: Zero

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

If the selected character set does not exist in your application platform, the system will select a compatible character set that does exit.

Also See:

A_FONTNAME

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTCOLOR_NONE

 

This attribute can be used to make a text object transparent. If the text is transparent, the underlying elements are seen behind the text.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

This text object has no color; it is transparent.

 

FALSE=

This text object is not transparent; use the normal color settings.

Default:

FALSE

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

This attribute overrides A_FONTCOLOR_RGB when drawing occurs. If A_FONTCOLOR_NONE is TRUE, the font object will remain transparent regardless of A_FONTCOLOR_RGB.

 

3.

Care should be taken in making this attribute available at the user interface level. If a user sets a font to transparent, it will be very difficult to find the font instance again without selecting it since the object is effectively invisible.

Also See:

A_FONTBACKCOLOR, A_FONTCOLOR_RGB

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTCOLOR_RGB

 

This attribute can be used to assign a color to a text object (i.e., labels, titles, etc.).

Type:

typedef struct {
     UINT16 red;      //0...65535
     UINT16 green;    //0...65535
     UINT16 blue;     //0...65535
} RGB16, FAR *RGB16Ptr;

Valid Range:

See the RGB16 structure in Appendix A.

Default:

red = 0, green = 0, blue = 0 (Black)

Example:

static RGB16 aRGB[4] = {
{ 0, 0, 0},/* BLACK */
{FULL,FULL,FULL}, /* WHITE */
{FULL, 0, 0}, /* RED */
{ 0,FULL, 0}, /* GREEN */
{ 0, 0,FULL}}; /* BLUE */
if (wParam == IDM_TRED)SetGraphAttrSI(gpGraph,gpSelItem,
          A_FONTCOLOR_RGB,&aRGB[2]);
if (wParam == IDM_TGREEN)
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_FONTCOLOR_RGB,&aRGB[3]);

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

If an Object ID is not specified or SetGraphAttrSL is used to apply the attribute, the specified color will be applied to all text objects.

 

3.

For more accurate color representations with the ACM_COLOR_MODEL attribute, set this attribute after a DrawTheGraph() or DryRunTheGraph() function.

Also See:

A_FONTBACKCOLOR, A_FONTCOLOR_NONE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTDROPSHADOW

 

This attribute can be used to apply a drop shadow to a font object. The drop shadow is drawn with the color specified, offset from the text object by the virtual coordinates specified in nXoff and nYoff.

Type:

typedef struct {
     INT16 nXoff;
     INT16 nYoff;
     UINT16 nRed;
     UINT16 nGreen;
     UINT16 nBlue;
} DropShadowInstRec;

Valid Range:

See the DropShadowInstRec in Appendix A.

Default:

None

Example:

DropShadowInstRec Shadow;
Shadow.nXoff = 100;
Shadow.nYoff = 120;
SetGraphAttrSL(gpGraph,gpList,A_FONTDROPSHADOW,&Shadow);

 

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

Setting nXoff and nYoff to zero disables any previous drop shadow. Drop shadows are not objects and cannot be selected as a detection node (detnode), they are considered attributes of an object.

Also See:

A_AREADROPSHADOW

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTNAME

 

This attribute defines the font in which a text object will be drawn.

Type:

typedef struct _FontNameInfo {
     char fontName[LF_FACESIZE];
     BYTE pitchAndFamily;
     BYTE charSet;
     INT16 nFlags;
} FontNameInfo, FAR * FontNameInfoPtr;

Valid Range:

See the FontNameInfo structure in Appendix A.

Default:

None

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

The fontName, pitchAndFamily, and charSet values are application platform specific. They are not defined in the library. If the specified font, pitch and family, and/or character does not exist, the system will select a compatible font that does exist.

Example:

FontNameInfo HelvFont = {
     "Helv",DEFAULT_PITCH,ANSI_CHARSET,0};
FontNameInfo TimesFont = {
     "Tms Rmn",DEFAULT_PITCH,ANSI_CHARSET,0};
if (wParam == IDM_HELVETICA)
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_FONTNAME, &HelvFont);
else if (wParam == IDM_TIMES)
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_FONTNAME, &TimesFont);

Also See:

A_FONTCHARSET

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTNAME_MBC

 

It is now possible to mix single-byte fonts (Romance languages) and multi-byte fonts (Kanji, etc.) in the SAME label. This attribute sets the multi-byte font to use in this scenario.

Type:

typedef struct _FontNameInfo {
     char fontName[LF_FACESIZE];
     BYTE pitchAndFamily;
     BYTE charSet;
     INT16 nFlags;
} FontNameInfo, FAR * FontNameInfoPtr;

Valid Range:

See the FontNameInfo structure in Appendix A.

Default:

None

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

The fontName, pitchAndFamily, and charSet values are application platform specific. They are not defined in the library. If the specified font, pitch and family, and/or character does not exist, the system will select a compatible font that does exist.

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTORIENT

 

This attribute can be used to set the orientation of a text object.

Type:

INT16

Valid Range:

0...7

 

#define

Value

Description

 

FONTORIENT_NORMAL

0

Normal Horizontal Characters

 

FONTORIENT_HOTEL

1

Vertical/Hotel Mode Characters

 

FONTORIENT_ROTATE_90

2

Rotate Characters 90 Degrees

 

FONTORIENT_ROTATE_180

3

Rotate Characters 180 Degrees

 

FONTORIENT_ROTATE_270

4

Rotate Characters 270 Degrees

 

FONTORIENT_ROTATE_45

5

Rotate Characters 45 Degrees

 

FONTORIENT_ROTATE_315

6

Rotate Characters 315 Degrees

 

FONTORIENT_CUSTOM

7

Use value set by A_FONTORIENTCUSTOM

Default:

FONTORIENT_NORMAL

Example:

//Toggle Y1 Text from Normal to Hotel
SetGraphAttr ( gpGraph, GRAPH_LAYER,
     O2D_Y1_TITLE,NULL_SERIESID, NULL_GROUPID,
     A_FONTORIENT, bIsHotel );

 

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

This attribute only affects the title objects. It does not affect any other text objects.

Also See:

A_FONTALIGN, A_FONTORIENTCUSTOM

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTORIENTCUSTOM

 

This attribute can be used to apply a custom orientation to a Font Object. This attribute is only used if A_FONTORIENT is set to 7 (FONT_ORIENT_CUSTOM).

Type:

INT16

Valid Range:

0..359

Example:

int FontOrC = 93;
int FontOr = FONT_ORIENT_CUSTOM
SetGraphAttr ( gpGraph, GRAPH_LAYER,
     O2D_Y1_TITLE,NULL_SERIESID, NULL_GROUPID,
     A_FONTORIENT, (void FAR *) &FontOr );
SetGraphAttr(gpGraph,GRAPH_LAYER,
     O2D_Y1_TITLE, NULL_SERIESID,NULL_GROUPID,
     A_FONTOREINTCUSTOM, (void FAR *)&FontOrC);

Default:

0

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

This attribute only affects the title objects. It does not affect any other text objects.

Also See:

A_FONTORIENT, A_FONTALIGN

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTPATTERN

 

This attribute selects the pattern of a font.

Type:

INT16

Valid Range:

0...6

 

0 =

Solid

 

1 =

Horizontal with solid background

 

2 =

Vertical with solid background

 

3 =

Forward diagonal with solid background

 

4 =

Backward diagonal with solid background

 

5 =

Cross with solid background

 

6 =

Diagonal cross with solid background

Default:

0 (Solid)

Example:

int FontPat = 2;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     O5D_LBLTITLE, NULL_SERIESID,NULL_GROUPID,
     A_FONTPATTERN, (void FAR *)&FontPat);

Notes:

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

Also See:

A_AREAPATTERN, A_LINEPATTERN

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTSFX

 

This attribute assigns a special effect to a text object.

Type:

typedef struct
{
     INT16 effect;
     union
     {
          WashRecord wash;
          PictureRecord picture;
          BrushRecord brush;
          AdvancedWashRecord advwash;
     } info;
} FXStruct, *FXPtr;

Valid Range:

See the FXStruct data structure in Appendix A.

Default:

None

Also See:

A_AREASFX, A_LINESFX

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTSIZE_LIMIT

 

This attribute sets the maximum allowable font size when automatic fitting is enabled.

Type:

INT16

Valid Range:

Any INT16 value

Default:

None

Example:

int SizeLimit = 24;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     O5D_LBLTITLE, NULL_SERIESID,NULL_GROUPID,
     A_FONTSIZE_LIMIT, (void FAR *)&SizeLimit);

Notes:

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

Also See:

A_FONTSIZE_VC

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTSIZE_POINT_100

 

This attribute sets a font point size using 100th of a Point as a unit. When A_LOCK_FONTSIZE is set to TRUE, this attribute must be used to set the font point size of a text object. When A_LOCK_FONTSIZE is set to FALSE, use A_FONTSIZE_VC.

Type:

INT16

Valid Range:

Any INT16 value.

Default:

0

Also See:

A_FONTSIZE_VC, A_LOCK_FONTSIZE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

   

A_FONTSIZE_VC

 

When A_LOCK_FONTSIZE is FALSE, this attribute defines the size of the font that will be used for text object(s) in virtual coordinates.

Type:

INT16

Valid Range:

Any INT16 value. Values in the range 800...2400 are most reasonable.

Default:

A font instance record is initialized for each of the standard text type objects in a graph (e.g., Title, Subtitle, etc.). The size of the font is different for each text object (e.g., Title = 2360, SubTitle = 1240, etc.).

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

 

2.

If a text object has automatic fitting enabled by one of the auto-fit attributes, this attribute will be ignored. Automatic fitting can be enabled or disabled for the legend text, numeric and ordinal axis labels, and 3D text with A2D_AUTOFIT_ALL, A2D_AUTOFIT_LEGEND, A2D_AUTOFIT_O1/O2, A2D_AUTOFIT_X/Y1/Y2, and A3D_AUTOFIT_TEXT (the Default is automatic fitting enabled). You must specifically disable automatic fitting in order to change the size of these text objects. With automatic fitting disabled, the font size attribute will apply to all labels of the given axis or all legend text objects

 

3.

To convert from point size to virtual coordinates size:

   

nPtSize=12;
nVCSize=dvScaleHeight(pDE, nPtSize);
setGraphAttrSI(... &nVCSize);

 

4.

If A_LOCK_FONTSIZE is true, use A_FONTSIZE_POINT_100 to change the point size of a text object.

Also See:

A_FONTSIZE_LIMIT

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

         

A_FONTSTYLE

 

This attribute defines the style that will be used for the specified text object.

Type:

INT16

Valid Range:

One of the following:

 

#define

Value

Description

 

FONTSTYLE_BOLD

1

Bold

 

FONTSTYLE_ITALIC

2

Italic

 

FONTSTYLE_UNDERLINE

4

Underlined

 

FONTSTYLE_STRIKEOUT

8

Strike Out

 

For example: to display not bold, not italic, with underline use 0x04. to display bold, italic, no underline use 0x03

Default:

Zero (normal)

Example:

static int aFontStyle [4] = {
0, /* NORMAL */
1, /* BOLD */
2, /* ITALICS */
4};/* UNDERLINE */
case IDM_NORMAL:
     SetGraphAttrSI(gpGraph,gpSelItem,
     A_FONTSTYLE,&aFontStyle [0]);
     break;
case IDM_BOLD:
     SetGraphAttrSI(gpGraph,gpSelItem,
     A_FONTSTYLE, &aFontStyle [1]);
     break;

Notes:

If you use SetGraphAttr(), you must specify the object ID of a text object to indicate the object to which this attribute is to be applied. See Appendix B for a list of text objects.

Also See:

A_FONTALIGN, A_FONTCHARSET, A_FONTNAME, A_FONTORIENT, A_FONTSIZE_VC

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Text

Optional

Optional

All

A_GLOW

 

The value assigned to this attribute is assigned to the bGlow member of the glow instance record (GlowInstRec) associated with a given line object.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Enable glow

 

FALSE=

Disable glow

Default:

False

Example:

bGlow = TRUE;
SetGraphAttrSL( pGraph, pSelList, A_GLOW, &bGlow );

 

Also See:

A_GLOW_COLOR, A_GLOW_MODE, A_GLOW_THICKNESS, A3D_GLOW_RISER

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Any Riser Object

Optional

Optional

All

   

A_GLOW_COLOR

 

The value assigned to this attribute is assigned to the nRed, nGreen, and nBlue members of the glow instance record (GlowInstRec) associated with a given line object.

Type:

typedef struct {
     UINT16 red;      //0...65535
     UINT16 green;    //0...65535
     UINT16 blue;     //0...65535
} RGB16, FAR *RGB16Ptr;

Valid Range:

See the RGB16 structure in Appendix A.

Default:

None

Example:

glowColor = pVisualize->glowColor;
SetGraphAttrSL( pGraph, pSelList, A_GLOW_COLOR,
     &glowColor );

 

Also See:

A_GLOW, A_GLOW_MODE, A_GLOW_THICKNESS

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Any Riser Object

Optional

Optional

All

   

A_GLOW_MODE

 

The value assigned to this attribute is assigned to the nMode member of the glow instance record (GlowInstRec) associated with a given line object.

Type:

INT16

Valid Range:

1...3

 

#define

Value

Description

 

GLOW_INSIDE

1

Inside

 

GLOW_OUTSIDE

2

Outside

 

GLOW_INOUT

3

Inside and Outside

Default:

GLOW_INOUT

Example:

nMode = GLOW_OUTSIDE;
SetGraphAttrSL( pGraph, pSelList, A_GLOW_MODE, &nMode );

Also See:

A_GLOW, A_GLOW_COLOR, A_GLOW_THICKNESS

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Any Riser Object

Optional

Optional

All

   

A_GLOW_THICKNESS

 

The value assigned to this attribute is assigned to the nThick member of the glow instance record (GlowInstRec) associated with a given line object.

Type:

INT16

Valid Range:

0..32767 defines the thickness of the glow in pixels.

Default:

None

Example:

nGlowThick = 8;
SetGraphAttrSL( pGraph, pSelList,
     A_GLOW_THICKNESS, &nGlowThick );

Also See:

A_GLOW, A_GLOW_COLOR, A_GLOW_MODE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Any Riser Object

Optional

Optional

All

   

A_GRAPH_PRESET

 

This attribute is used to change the graph type. nMajorType selects the MAJOR graph type category; nMinorType selects the SUBTYPE for this category.

Type:

typedef struct{
     INT16 nMajorType;
     INT16 nMinorType;
} TDG_GraphPresetInfo

Valid Range:

See the TDG_GraphPresetInfo data structure in Appendix A.

Default:

nMajorType = 2, nMinorType = 0

Example:

void NEAR PASCAL ChangeGraphType (WORD graphID)
{
     int iGraph;
     TDG_GraphPresetInfo GraphCode;
     switch (graphID)
     {
          case IDM_BAR:
               iGraph = 0;
               break;
          case IDM_CUBE:
               iGraph = 1;
               break;
          case IDM_AREA:
               iGraph = 7;
               break;
          case IDM_SURFACE:
               iGraph = 15;
               break;
          case IDM_PYRAMID:
               iGraph = 5;
     }
     GraphCode.nMajorType = TDG_GRAPH_3D;
     GraphCode.nMinorType = iGraph;
     SetGraphAttrSL (gpGraph,NULL,
          A_GRAPH_PRESET, &GraphCode);
}

Notes:

Note that some graph type/subtype combinations are perfectly legal but produce a graph type that is not a useable graph in the real world. For example, since the Bar/Line/Area graphs use the same engine code, it is a valid combination to request a Side-by-Side Area chart. However, it is difficult to see what usable information could be derived from such a chart.

Also See:

A2D_ORIENTATION, A2D_DATAFORMAT, The PGSDK Programmer's Manual for an illustration of each graph type.

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

A_LINECOLOR_ALPHA

 

The value assigned to this attribute is assigned to the nAlpha (Alpha Channel) member of the color instance record (ColorInstRec) associated with a particular line object. The value of this attribute makes the object's color more opaque or transparent.

Type:

INT16

Valid Range:

0..255 (255 = opaque, 0 = transparent)

Default:

255

Also See:

A_AREACOLOR_ALPHA

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

   

A_LINECOLOR_NONE

 

This attribute can be used to make a line object transparent. If the line is transparent, the underlying elements will be seen behind it.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

This line has no color; it is transparent.

 

FALSE=

This line is not transparent; use the normal color settings.

Default:

FALSE

Example:

case IDM_SOLID:
{
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_LINECOLOR_NONE, &bFALSE);
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_AREACOLOR_NONE,&bFALSE);
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_AREAPATTERN, &Solid);
     SetGraphAttrSI(gpGraph,gpSelItem,
          A_AREABACKCOLOR,&aRGB[1]);
}

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a line object to indicate the object to which this attribute is to be applied. See Appendix B for a list of line objects.

 

2.

This attribute overrides A_LINECOLOR_RGB when drawing occurs. If A_LINECOLOR_NONE is TRUE, the line will remain transparent regardless of the value assigned to A_LINECOLOR_RGB. This attribute must be explicitly set to FALSE in order to see a line's color.

 

3.

Great care should be taken in making this attribute available at the user interface level. If a line is made transparent, it is effectively invisible and would be almost impossible to select.

 

4.

Lines are the borders that are drawn around areas. For example, bar risers, borders, and the chart frame are line objects. Lines can also be drawn by themselves, for example, the feelers on a pie chart

Also See:

A_LINECOLOR_RGB

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

         

A_LINECOLOR_RGB

 

This attribute sets the color value of a line in Red/Green/Blue increments.

Type:

typedef struct {
     UINT16 red;      //0...65535
     UINT16 green;    //0...65535
     UINT16 blue;     //0...65535
} RGB16, FAR *RGB16Ptr;

Valid Range:

See the RGB16 structure in Appendix A.

Default:

red = 0, green = 0, blue = 0 (Black)

Example:

static RGB16 aRGB[2]= {
{ 0, 0, 0}, /* BLACK */
{FULL,FULL,FULL}}; /* WHITE */
SetGraphAttrSL(gpGraph,gpList,A_LINECOLOR_RGB,&aRGB[i]);

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a line object to indicate the object to which this attribute is to be applied. See Appendix B for a list of line objects. If an Object ID is not specified or SetGraphAttrSL is used to apply the attribute, the specified color will be applied to all line objects.

 

2.

For API usage via Set/GetGraphAttr(), a copy of the structure RGB16 should be used (e.g., RGB16 myRGBstruct;).

 

3.

The library does not modify the system color palette. If your application requires colors in addition to those in the system palette, your application must create and realize a logical palette into the system palette.

 

4.

Lines are the borders drawn around areas, for example, bar risers or the chart frame. Lines can also be drawn by themselves, for example, the feelers on a pie chart.

 

5.

For more accurate color representations with the ACM_COLOR_MODEL attribute, set this attribute after a DrawTheGraph() or DryRunTheGraph() function.

Also See:

A_LINECOLOR_NONE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

         

A_LINEPATTERN (Windows Only)

 

This attribute is used to specify the style of a line object.

Type:

INT16

Valid Range:

0...15

 

Value

Line Pattern Type

Description

 

0 =

Solid

 

1 =

Dash

 

2 =

Dot

 

3 =

Dot and Dash

 

4 =

Dash and two Dots

 

5 =

Medium Dash

 

6 =

Short Dash

 

7=

Longest Dash

 

8=

Long Dot

 

9=

Dot Dot Dot

 

10=

Dash Dash Dot

 

11=

Dash Dash Dot, Dot

 

12=

Long Dash Dot

 

13=

Long Dash Dot Dot

 

14=

Long Dash Dash Dot

 

15=

Long Dash Dash Dot Dot

Default:

0 (Solid)

Example:

static INT16 pat[5] = {1, 2, 3, 4, 5};
SetGraphAttrSI (gpGraph,gpSelItem,
     A_LINEPATTERN, &pat[1]);

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a line object to indicate the object to which this attribute is to be applied. See Appendix B for a list of line objects. If an Object ID is not specified or SetGraphAttrSL is used to apply the attribute, the specified pattern will be applied to all line objects.

 

2.

Lines are the borders drawn around areas, for example, bar risers or the chart frame. Lines can also be drawn by themselves, for example, the feelers on a pie chart.

Also See:

A_LINESFX, A_LINEWIDTH

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

         

A_LINESFX

 

This attribute assigns a special effect to a line object.

Type:

typedef struct
{
     INT16 effect;
     union
     {
          WashRecord wash;
          PictureRecord picture;
          BrushRecord brush;
          AdvancedWashRecord advwash;
     } info;
} FXStruct, *FXPtr;

Valid Range:

See the FXStruct data structure in Appendix A.

Default:

None

Notes:

If you use SetGraphAttr(), you must specify the object ID of a line object to indicate the object to which this attribute is to be applied. See Appendix B for a list of line objects. If an Object ID is not specified or SetGraphAttrSL is used to apply the attribute, the specified special effect will be applied to all line objects.

Also See:

A_AREASFX

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

         

A_LINEWIDTH

 

When A_LOCK_FONTSIZE is FALSE, this attribute defines the width of a line object.

Type:

INT16

Valid Range:

Any positive INT16 value identifying the width of the line in virtual units. A value of 50...100 is roughly equivalent to one pixel.

Default:

1

Example:

int nSeriesID = 2;
int LineWidth = 50;
SetGraphAttr(gpGraph,GRAPH_LAYER,
     O2D_MOVAVGLINE, nSeriesID,
     NULL_GROUPID, A_LINEWIDTH,(void FAR *)&LineWidth);

Notes:

1.

If you use SetGraphAttr(), you must specify the object ID of a line object to indicate the object to which this attribute is to be applied. See Appendix B for a list of line objects. If an Object ID is not specified or SetGraphAttrSL is used to apply the attribute, the specified width will be applied to all line objects.

 

2.

To create a line that is three pixels wide:

   

nPixelWidth=3;
nvWidth = dvScleHeight(pDE, nPixelWidth);
setGraphAttr(... &nvWidth);

 

3.

If A_LOCK_FONTSIZE is true, use A_LINEWIDTH_POINT_100 to change the width of a line object.

Also See:

A_LINEPATTERN, A_LINESFX

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

   

A_LINEWIDTH_POINT_100

 

This attribute sets the width of a line object in 100th point units. When A_LOCK_FONTSIZE is TRUE, line width changes must be set using this attribute. When A_LOCK_FONTSIZE is FALSE, use A_LINEWIDTH.

Type:

INT16

Valid Range:

Any positive INT16

Default:

None

Example:

// Set Y1 Axis ZERO line to be 1.5 points:
//1.5 points measured in 100th's for accuracy.
INT16 nPointSize = 150;
SetGraphAttr(pGraph, GRAPH_LAYER, O2D_Y1_ZERO,
     -3, -3, A_LINEWIDTH_POINT_100, &nPointSize);

Also See:

A_LOCK_FONTSIZE, A_LINEWIDTH

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

Line

Optional

Optional

All

   

A_LOCATE_FOOTNOTE

 

This attribute defines the location and size of the bounding box of the footnote object (O5D_LBLFOOTNOTE). The location and size of the bounding box are specified in virtual coordinates.

Type:

typedef struct
{
     INT16 xULC, yULC;
     INT16 xLRC, yLRC;
} BoxInstRec, FAR *BoxInstPtr;

Valid Range:

See the BoxInstRec structure in Appendix A.

 

xLRC, yLRC: INT16 value in the range +/- 16383 identifying the lower right corner location in virtual coordinates (e.g., 16383, -16383 = lower-right most corner of window, 0,0 = center of window)

Default:

xULC = VirtualXMIN (-16383) + 1000,

 

yULC = VirtualYMIN (-16383) + 150

 

xLRC = VirtualXMAX (16383) - 100

 

yLRC = VirtualYMIN (16383) + 50

Example:

aRect = r2;
// Convert to Virtual Coordinates
dvRect(gpDrawEnv, &aRect);
if (gpSelItem->nObjectID == O5D_LBLFOOTNOTE)
     SetGraphAttrSI(gpGraph, gpSelItem,
     A_LOCATE_FOOTNOTE, &aRect);

Also See:

A_SHOW_FOOTNOTE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A_LOCATE_FRAME

 

This attribute defines the location to draw the chart frame within the drawing area. The chart is drawn within the frame defined by A_LOCATE_FRAME. The location is defined in virtual coordinates. The background of the chart occupies the entire area defined by the virtual coordinates

 

Type:

typedef struct {
     INT16 xULC,yULC;
     INT16 xLRC,yLRC;
} BoxInstRec, FAR *BoxInstPtr;

Valid Range:

See the BoxInstRec structure in Appendix A.

Default:

xULC = -10537, yULC = 10425, xLRC = 12640, yLRC = -6629

Notes:

1.

Do NOT put the Upper Left Corner below or to the right of the Lower Right Corner in an effort to mirror the chart. If you want the chart to be upside down, or mirrored, draw to a memory DC and manipulate the bitmap.

 

2.

The values of the coordinates cannot exceed the limits of the virtual coordinate rectangle defined by VirtualXMIN, VirtualXMAX, VirtualYMIN, and VirtualYMAX.

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

         

A_LOCATE_SUBTITLE

 

This attribute defines the position and size of the bounding box of the subtitle object (O5D_LBLSUBTITLE). The location and size of the bounding box are specified in virtual coordinates.

Type:

typedef struct {
     INT16 xULC, yULC;
     INT16 xLRC, yLRC;
} BoxInstRec, FAR *BoxInstPtr;

Valid Range:

See the BoxInstRec structure in Appendix A.

Default:

xULC = VirtualXMIN (-16383) + 1000

 

yULC = yLRC of Title object (O5D_LBLTITLE)

 

xLRC = VirtualXMAX (16383) - 1000

 

yLRC = yULC of Title object (O5D_LBLTITLE) - 200

Example:

aRect = r2;
// Convert to Virtual Coordinates
dvRect(gpDrawEnv, &aRect);
if (gpSelItem->nObjectID == O5D_LBLSUBTITLE)
     SetGraphAttrSI(gpGraph, gpSelItem,
     A_LOCATE_SUBTITLE, &aRect);

Also See:

A_SHOW_SUBTITLE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A_LOCATE_TITLE

 

This attribute defines the position and side of the bounding box of the title object (O5D_LBLTITLE). The position and size of the bounding box are specified in virtual coordinates.

Type:

typedef struct {
     INT16 xULC, yULC;
     INT16 xLRC, yLRC;
} BoxInstRec, FAR *BoxInstPtr;

Valid Range:

See the BoxInstRec structure in Appendix A.

Default:

xULC = VirtualXMIN (-16383) + 20

 

yULC = VirtualYMAX - 20

 

xLRC = VirtualXMAX (16383) - 20

 

yLRC = VirtualYMAX - 450

Example:

aRect = r2;
// Convert to Virtual Coordinates
dvRect(gpDrawEnv, &aRect);
if (gpSelItem->nObjectID == O5D_LBLTITLE)
     SetGraphAttrSI(gpGraph, gpSelItem,
     A_LOCATE_TITLE, &aRect);

Also See:

A_SHOW_TITLE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A_LOCK_FONTSIZE

 

This attribute enables/disables locked font size and line width changes. When this attribute is set to TRUE, you must use A_LINEWIDTH_POINT_100 to change line width and A_FONTSIZE_POINT_100 to change font sizes. When this attribute is set to FALSE, A_LINEWIDTH can be used to change line width and A_FONTSIZE_VC can be used to change font sizes.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Lock Line/Font Sizes. Fonts will keep their physical point size even if the document grows/shrinks.

 

FALSE=

Use line/font sizes set by A_LINEWIDTH and A_FONTSIZE_VC

Default:

False

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

         

A_SHOW_FOOTNOTE

 

This attribute enables/disables drawing of the footnote object (O5D_LBLFOOTNOTE)

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Draw footnote.

 

FALSE=

Do not draw footnote.

Default:

TRUE

Example:

SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID, NULL_SERIESID, NULL_GROUPID,
     A_SHOW_FOOTNOTE, (void FAR *)&bFALSE);

 

Also See:

A_LOCATE_FOOTNOTE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

   

A_SHOW_SUBTITLE

 

This attribute enables/disables drawing of the subtitle object (O5D_LBLSUBTITLE).

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Draw subtitle.

 

FALSE=

Do not draw subtitle.

Default:

TRUE

Example:

SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID, NULL_SERIESID, NULL_GROUPID,
     A_SHOW_SUBTITLE, (void FAR *)&bFALSE);

 

Also See:

A_LOCATE_SUBTITLE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

A_SHOW_TITLE

 

This attribute enables/disables drawing of the title object (O5D_LBLTITLE).

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Draw title.

 

FALSE=

Do not draw title.

Default:

TRUE

Example:

SetGraphAttr(gpGraph,GRAPH_LAYER,
     NULL_OBJECTID, NULL_SERIESID, NULL_GROUPID,
     A_SHOW_TITLE, (void FAR *)&bFALSE);

 

Also See:

A_LOCATE_TITLE

Usage

ObjectID

SeriesID

GroupID

GraphTypes

Requirements:

No

No

No

All

         

A_SUPPRESS

 

This attribute enables/disables suppression of an object.

Type:

BOOLEAN16

Valid Range:

TRUE/FALSE

 

TRUE=

Suppress object

 

FALSE=

Do not suppress object

Default:

FALSE

Example:

BOOLEAN16 bSuppress = TRUE;
SetGraphAttrSL(pGraph, pSelList,
     A_SUPPRESS, &bSuppress );

 

Usage ObjectID SeriesID GroupID GraphTypes
Requirements: Any Riser Object No No All