GreSetGlobalAttribute

GreSetGlobalAttribute sets the specified attribute in the pen, pattern, character, image, and marker bundles.

This function is supported by the graphics engine.

Syntax
GreSetGlobalAttribute(hdc, lAttrType, lAttribute, flOptions, pInstance, lFunction);

Parameters

 * hdc (HDC) - input
 * Device context handle.


 * lAttrType (LONG) - input
 * Specifies the attribute type.


 * Attribute types:


 * ATYPE_COLOR Foreground color
 * ATYPE_BACK_COLOR Background color
 * ATYPE_MIX_MODE Foreground mix
 * ATYPE_BACK_MIX_MODE Background mix


 * Note: ATYPE_BACK_COLOR and ATYPE_BACK_MIX_MODE do not apply to the line bundle.


 * lAttribute (LONG) - input
 * New attribute value.


 * flOptions (ULONG) - input
 * The only allowable option flag is GATTR_DEFAULT, which specifies that the attribute indicated by lAttrType should be set to its default value. If the GATTR_DEFAULT flag is not set, the function sets the attribute to the value specified by lAttribute.


 * pInstance (PVOID) - input
 * Pointer to instance data.


 * lFunction (ULONG) - input
 * High-order WORD=flags; low-order WORD=NGreSetGlobalAttribute.

Return Code

 * fSuccess (BOOL) - returns
 * Return codes.


 * On completion, the handling routine must return BOOLEAN (fSuccess).


 * TRUE Successful
 * FALSE Error


 * Possible Errors Detected:  When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:


 * PMERR_DEV_FUNC_NOT_INSTALLED
 * PMERR_HDC_BUSY
 * PMERR_INV_BACKGROUND_COL_ATTR
 * PMERR_INV_BACKGROUND_MIX_ATTR
 * PMERR_INV_COLOR_ATTR
 * PMERR_INV_HDC
 * PMERR_INV_IN_AREA
 * PMERR_INV_MIX_ATTR
 * PMERR_INV_RESET_OPTIONS


 * Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Remarks
The attribute can be set to its default value or to a specified value.

Sample Code

 * 1) define INCL_GRE_DEVSUPPORT
 * 2) include 

HDC     hdc;         /*  Device context handle. */ LONG    lAttrType;   /*  Specifies the attribute type. */ LONG    lAttribute;  /*  New attribute value. */ ULONG   flOptions; PVOID   pInstance;   /*  Pointer to instance data. */ ULONG   lFunction;   /*  High-order WORD=flags; low-order WORD=NGreSetGlobalAttribute. */ BOOL    fSuccess;    /*  Return codes. */

fSuccess = GreSetGlobalAttribute(hdc, lAttrType,            lAttribute, flOptions, pInstance,             lFunction); 