GreAreaSetAttributes

This function is simulated by a handling routine in the graphics engine.

GreAreaSetAttributes is called by the graphics engine after processing a call to GreSetAttrs received inside an area or path bracket. The handling routine in the graphics engine does nothing. Its purpose is to provide an entry in the dispatch table that can be hooked by presentation drivers. This function must be hooked by presentation drivers that perform their own area or path simulations.

Syntax

fSuccess = GreAreaSetAttributes(hdc, lPrimType, flDefsMask, flAttrsMask, pAttrs, pInstance, lFunction);

Parameters

hdc (HDC) - input;Device context handle.

lPrimType (LONG) - input; Bundle primitive type.

PRIM_LINE Line attribute bundle

PRIM_CHAR Character attribute bundle

PRIM_MARKER Marker attribute bundle

PRIM_AREA Pattern attribute bundle

PRIM_IMAGE Image attribute bundle

flDefsMask (ULONG) - input; Flags attributes for default. Flags indicating which attributes are to be set to default.

flAttrsMask (ULONG) - input; Flags attributes for modification. Flags indicating which attributes are to be modified.

pAttrs (PBUNDLE) - input

Pointer to fixed-format record bundle.

This is a pointer to the fixed-format bundle record containing the attribute values to be set as specified by flAttrsMask. Only the attribute fields corresponding to attribute flags set in flAttrsMask, and not set in flDefsMask, contain valid values. This buffer must only be large enough to contain data for the highest offset attribute referenced.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreAreaSetAttributes.

Return Code

fSuccess (BOOL) - returns

This function returns BOOLEAN (fSuccess).

TRUE Successful

FALSE Error

Example Code

#define INCL_GRE_PATHS
#include <os2.h>
HDC    hdc;          /*  Device context handle. */
LONG   lPrimType;    /*  Bundle primitive type. */
ULONG  flDefsMask;   /*  Flags attributes for default. */
ULONG  flAttrsMask;  /*  Flags attributes for modification. */
PBUNDLE    pAttrs;       /*  Pointer to fixed-format record bundle. */
PVOID  pInstance;    /*  Pointer to instance data. */
ULONG  lFunction;    /*  High-order WORD=flags; low-order WORD=NGreAreaSetAttributes. */
BOOL   fSuccess;     /*  This function returns BOOLEAN (fSuccess). */

fSuccess = GreAreaSetAttributes(hdc, lPrimType, flDefsMask, flAttrsMask, pAttrs, pInstance, lFunction);