Graphics Functions

Graphics Functions (GDI+)

The Graphics functions provide methods for drawing lines, curves, figures, images, and text. A Graphics object stores attributes of the display device and attributes of the items to be drawn.

Return Values

If the function succeeds, it returns Ok, which is an element of the Status enumeration.

If the function fails, it returns one of the other elements of the Status enumeration.

GdipEndContainer

Description

Closes a graphics container that was previously opened by the GdipBeginContainer method.

Syntax

GpStatus WINGDIPAPI GdipEndContainer(

GpGraphics *graphics,

GraphicsContainer state

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEndContainer ( _

BYVAL graphics AS DWORD, _

BYVAL pState AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

state

[in] Value (previously returned by GdipBeginContainer) that identifies the container to be closed.

Remarks

When you call the GdipBeginContainer function, an information block that holds the state of the Graphics object is put on a stack. The GdipBeginContainer method returns a value that identifies that information block. When you pass the identifying value to the GdipEndContainer method, the information block is removed from the stack and is used to restore the Graphics object to the state it was in at the time of the GdipBeginContainer call.

Containers can be nested; that is, you can call the GdipBeginContainer function several times before you call the GdipEndContainer function. Each time you call the GdipBeginContainer function, an information block is put on the stack, and you receive an identifier for the information block. When you pass one of those identifiers to the GdipEndContainer function, the Graphics object is returned to the state it was in at the time of the GdipBeginContainer call that returned that particular identifier. The information block placed on the stack by that GdipBeginContainer call is removed from the stack, and all information blocks placed on that stack after that GdipBeginContainer call are also removed.

Calls to the GdipSaveGraphics function place information blocks on the same stack as calls to the GdipBeginContainer function. Just as an GdipEndContainer call is paired with a GdipBeginContainer call, a GdipRestoreGraphics call is paired with a GdipSaveGraphics call.

Caution When you call GdipEndContainer, all information blocks placed on the stack (by GdipSaveGraphics or by GdipBeginContainer) after the corresponding call to GdipBeginContainer are removed from the stack. Likewise, when you call GdipRestoreGraphics, all information blocks placed on the stack (by GdipSaveGraphics or by GdipBeginContainer) after the corresponding call to GdipSaveGraphics are removed from the stack.

GdipEnumerateMetafileDestPoint

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileDestPoint(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST PointF & destPoint,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileDestPoint ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoint AS PointF, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoint

[in] Reference to a point that specifies the upper-left corner of the displayed metafile.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileDestPointI

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileDestPointI(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST Point & destPoint,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileDestPointI ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoint AS PointL, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoint

[in] Reference to a point that specifies the upper-left corner of the displayed metafile.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileDestPoints

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileDestPoints(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST PointF * destPoints,

    INT count,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileDestPoints ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoints AS PointF, _

    BYVAL count AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoints

[in] Pointer to an array of destination points. This is an array of three points that defines the destination parallelogram for the displayed metafile.

count

[in] Long integer value that specifies the number of points in the destPoints array.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileDestPointsI

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileDestPointsI(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST Point * destPoints,

    INT count,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileDestPointsI ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoints AS PointL, _

    BYVAL count AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoints

[in] Pointer to an array of destination points. This is an array of three points that defines the destination parallelogram for the displayed metafile.

count

[in] Long integer value that specifies the number of points in the destPoints array.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileDestRect

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileDestRect(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST RectF & destRect,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileDestRect ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destRect AS RECTF, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destRect

[in] Reference to a RectF structure that specifies the rectangle in which the metafile is displayed.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileDestRectI

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileDestRectI(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST Rect & destRect,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileDestRectI ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destRect AS RECTL, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destRect

[in] Reference to a RectL structure that specifies the rectangle in which the metafile is displayed.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileSrcRectDestPoint

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileSrcRectDestPoint(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST PointF & destPoint,

    GDIPCONST RectF & srcRect,

    Unit srcUnit,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileSrcRectDestPoint ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoint AS PointF, _

    BYREF srcRect AS RECTF, _

    BYVAL srcUnit AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoint

[in] Reference to a point that specifies the upper-left corner of the displayed metafile.

srcRect

[in] Reference to a rectangle that specifies the portion of the metafile that is displayed.

srcUnit

[in] Element of the Unit enumeration that specifies the unit of measure for the source rectangle.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileSrcRectDestPointI

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileSrcRectDestPointI(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST Point & destPoint,

    GDIPCONST Rect & srcRect,

    Unit srcUnit,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileSrcRectDestPoint ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoint AS PointL, _

    BYREF srcRect AS RECTL, _

    BYVAL srcUnit AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoint

[in] Reference to a point that specifies the upper-left corner of the displayed metafile.

srcRect

[in] Reference to a rectangle that specifies the portion of the metafile that is displayed.

srcUnit

[in] Element of the Unit enumeration that specifies the unit of measure for the source rectangle.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileSrcRectDestPoints

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileSrcRectDestPoints(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST PointF * destPoints,

    INT count,

    GDIPCONST RectF & srcRect,

    Unit srcUnit,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileSrcRectDestPoints ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoints AS PointF, _

    BYVAL count AS LONG, _

    BYREF srcRect AS RECTF, _

    BYVAL srcUnit AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoints

[in] Pointer to an array of destination points. This is an array of three points that defines the destination parallelogram for the displayed metafile.

count

[in] Long integer value that specifies the number of points in the destPoints array.

srcRect

[in] Reference to a rectangle that specifies the portion of the metafile that is displayed.

srcUnit

[in] Element of the Unit enumeration that specifies the unit of measure for the source rectangle.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileSrcRectDestPointsI

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileSrcRectDestPointsI(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST Point * destPoints,

    INT count,

    GDIPCONST Rect & srcRect,

    Unit srcUnit,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileSrcRectDestPointsI ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destPoints AS PointL, _

    BYVAL count AS LONG, _

    BYREF srcRect AS RECTL, _

    BYVAL srcUnit AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destpoints

[in] Pointer to an array of destination points. This is an array of three points that defines the destination parallelogram for the displayed metafile.

count

[in] Long integer value that specifies the number of points in the destPoints array.

srcRect

[in] Reference to a rectangle that specifies the portion of the metafile that is displayed.

srcUnit

[in] Element of the Unit enumeration that specifies the unit of measure for the source rectangle.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileSrcRectDestRect

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileSrcRectDestRect(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST RectF & destRect,

    GDIPCONST RectF & srcRect,

    Unit srcUnit,

    EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileSrcRectDestRect ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destRect AS RECTF, _

    BYREF srcRect AS RECTF, _

    BYVAL srcUnit AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destRect

[in] Pointer to an array of destination points. This is an array of three points that defines the destination parallelogram for the displayed metafile.

srcRect

[in] Reference to a rectangle that specifies the portion of the metafile that is displayed.

srcUnit

[in] Element of the Unit enumeration that specifies the unit of measure for the source rectangle.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipEnumerateMetafileSrcRectDestRectI

Description

Calls an application-defined callback function for each record in a specified metafile. You can use this method to display a metafile by calling GdipPlayMetafileRecord in the callback function.

Syntax

GpStatus WINGDIPAPI GdipEnumerateMetafileSrcRectDestRectI(

    GpGraphics * graphics,

    GDIPCONST GpMetafile * metafile,

    GDIPCONST Rect & destRect,

    GDIPCONST Rect & srcRect,

    Unit srcUnit, EnumerateMetafileProc callback,

    VOID * callbackData,

    GDIPCONST GpImageAttributes * imageAttributes

);

PowerBASIC Syntax

DECLARE FUNCTION GdipEnumerateMetafileSrcRectDestRectI ( _

    BYVAL graphics AS DWORD, _

    BYVAL metafile AS DWORD, _

    BYREF destRect AS RECTL, _

    BYREF srcRect AS RECTL, _

    BYVAL srcUnit AS LONG, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD, _

    BYVAL imageAttributes AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

metafile

[in] Pointer to a metafile to be enumerated.

destRect

[in] Pointer to an array of destination points. This is an array of three points that defines the destination parallelogram for the displayed metafile.

srcRect

[in] Reference to a rectangle that specifies the portion of the metafile that is displayed.

srcUnit

[in] Element of the Unit enumeration that specifies the unit of measure for the source rectangle.

callback

[in] Pointer to an application-defined callback function. The prototype for the callback function is given in Gdiplustypes.h.

callbackData

[in] Pointer to a block of data that is passed to the callback function. The default value is NULL.

imageAttributes

[in] Pointer to an ImageAttributes object that specifies color adjustments for the displayed metafile. The default value is NULL.

GdipFillClosedCurve

Description

Creates a closed cardinal spline from an array of points and uses a brush to fill the interior of the spline.

Syntax

GpStatus WINGDIPAPI GdipFillClosedCurve(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPointF *points,

    INT count

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillClosedCurve ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF pPoints AS PointF, _

    BYVAL count AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the spline.

points

[in] Pointer to an array of points that this method uses to create a closed cardinal spline. Each point in the array is a point on the spline.

count

[in] Long integer value that specifies the number of points in the points array.

GdipFillClosedCurve2

Description

Creates a closed cardinal spline from an array of points and uses a brush to fill, according to a specified mode, the interior of the spline.

Syntax

GpStatus WINGDIPAPI GdipFillClosedCurve2(

    GpGraphics *graphics,

    GpBrush *brush,

  GDIPCONST GpPointF *points,

    INT count,

    REAL tension,

    GpFillMode fillMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillClosedCurve2 ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF pPoints AS PointF, _

    BYVAL count AS LONG, _

    BYVAL tension AS SINGLE, _

    BYVAL fillMode AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the spline.

points

[in] Pointer to an array of points that this method uses to create a closed cardinal spline. Each point in the array is a point on the spline.

count

[in] Long integer value that specifies the number of points in the points array.

tension

[in] Nonnegative real number that specifies how tightly the spline bends as it passes through the points. A value of 0 specifies that the spline is a sequence of straight lines. As the value increases, the curve becomes fuller. The default value is 0.5f.

fillmode

[in] Element of the FillMode enumeration that specifies how to fill a closed area that is created when the curve passes over itself.

GdipFillClosedCurve2I

Description

Creates a closed cardinal spline from an array of points and uses a brush to fill, according to a specified mode, the interior of the spline.

Syntax

GpStatus WINGDIPAPI GdipFillClosedCurve2I(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPoint *points,

    INT count,

    REAL tension,

    GpFillMode fillMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillClosedCurve2I ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF pPoints AS PointL, _

    BYVAL count AS LONG, _

    BYVAL tension AS SINGLE, _

    BYVAL fillMode AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the spline.

points

[in] Pointer to an array of points that this method uses to create a closed cardinal spline. Each point in the array is a point on the spline.

count

[in] Long integer value that specifies the number of points in the points array.

tension

[in] Nonnegative real number that specifies how tightly the spline bends as it passes through the points. A value of 0 specifies that the spline is a sequence of straight lines. As the value increases, the curve becomes fuller. The default value is 0.5f.

fillmode

[in] Element of the FillMode enumeration that specifies how to fill a closed area that is created when the curve passes over itself.

GdipFillClosedCurveI

Description

Creates a closed cardinal spline from an array of points and uses a brush to fill the interior of the spline.

Syntax

GpStatus WINGDIPAPI GdipFillClosedCurveI(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPoint *points,

    INT count

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillClosedCurveI ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF pPoints AS PointL, _

    BYVAL count AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the spline.

points

[in] Pointer to an array of points that this method uses to create a closed cardinal spline. Each point in the array is a point on the spline.

count

[in] Long integer value that specifies the number of points in the points array.

GdipFillEllipse

Description

Uses a brush to fill the interior of an ellipse that is specified by coordinates and dimensions.

Syntax

GpStatus WINGDIPAPI GdipFillEllipse(

    GpGraphics *graphics,

    GpBrush *brush,

    REAL x,

    REAL y,

    REAL width,

    REAL height

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillEllipse ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL x AS SINGLE, _

    BYVAL y AS SINGLE, _

    BYVAL nWidth AS SINGLE, _

    BYVAL nHeight AS SINGLE _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the ellipse.

[in] Simple precision value that specifies the x-coordinate of the upper-left corner of the rectangle that specifies the boundaries of the ellipse.

[in] Simple precision value that specifies the y-coordinate of the upper-left corner of the rectangle that specifies the boundaries of the ellipse.

width

[in] Simple precision value that specifies the width of the rectangle that specifies the boundaries of the ellipse.

height

[in] Simple precision value that specifies the height of the rectangle that specifies the boundaries of the ellipse.

GdipFillEllipseI

Description

Uses a brush to fill the interior of an ellipse that is specified by coordinates and dimensions.

Syntax

GpStatus WINGDIPAPI GdipFillEllipseI(

    GpGraphics *graphics,

    GpBrush *brush,

    INT x,

    INT y,

    INT width,

    INT height

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillEllipseI ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL x AS LONG, _

    BYVAL y AS LONG, _

    BYVAL nWidth AS LONG, _

    BYVAL nHeight AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the ellipse.

[in] Long integer value that specifies the x-coordinate of the upper-left corner of the rectangle that specifies the boundaries of the ellipse.

[in] Long integer value that specifies the y-coordinate of the upper-left corner of the rectangle that specifies the boundaries of the ellipse.

width

[in] Long integer value that specifies the width of the rectangle that specifies the boundaries of the ellipse.

height

[in] Long integer value that specifies the height of the rectangle that specifies the boundaries of the ellipse.

GdipFillPath

Description

Uses a brush to fill the interior of a path. If a figure in the path is not closed, this method treats the nonclosed figure as if it were closed by a straight line that connects the figure's starting and ending points.

Syntax

GpStatus WINGDIPAPI GdipFillPath(

    GpGraphics *graphics,

    GpBrush *brush,

    GpPath *path

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPath ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL path AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the path.

path

[in] Pointer to a GraphicsPath object that specifies the path.

GdipFillPie

Description

Uses uses a brush to fill the interior of a pie.

Syntax

GpStatus WINGDIPAPI GdipFillPie(

    GpGraphics *graphics,

    GpBrush *brush,

    REAL x,

    REAL y,

    REAL width,

    REAL height,

    REAL startAngle,

    REAL sweepAngle

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPie ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL x AS SINGLE, _

    BYVAL y AS SINGLE, _

    BYVAL nWidth AS SINGLE, _

    BYVAL nHeight AS SINGLE, _

    BYVAL startAngle AS SINGLE, _

    BYVAL sweepAngle AS SINGLE _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the pie.

[in] Simple precision value that specifies the x-coordinate of the upper-left corner of the rectangle that bounds the ellipse. A curved portion of the ellipse is the arc of the pie.

[in] Simple precision value that specifies the y-coordinate of the upper-left corner of the rectangle that bounds the ellipse.

width

[in] Simple precision value that specifies the width of the rectangle that bounds the ellipse.

heigth

[in] Simple precision value that specifies the height of the rectangle that bounds the ellipse.

startAngle

[in]Simple precision value that specifies the angle, in degrees, between the x-axis and the starting point of the pie's arc.

sweepAngle

[in] Simple precision value that specifies the angle, in degrees, between the starting and ending points of the pie's arc.

Remarks

A pie is a portion of the interior of an ellipse (it is bounded by an elliptical curve and two radial lines). The startAngle and sweepAngle specify the portion of the ellipse to be used.

GdipFillPieI

Description

Uses uses a brush to fill the interior of a pie.

Syntax

GpStatus WINGDIPAPI GdipFillPieI(

    GpGraphics *graphics,

    GpBrush *brush,

    INT x,

    INT y,

    INT width,

    INT height,

    REAL startAngle,

    REAL sweepAngle

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPieI ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL x AS LONG, _

    BYVAL y AS LONG, _

    BYVAL nWidth AS LONG, _

    BYVAL nHeight AS LONG, _

    BYVAL startAngle AS SINGLE, _

    BYVAL sweepAngle AS SINGLE _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the pie.

[in] Long integer value that specifies the x-coordinate of the upper-left corner of the rectangle that bounds the ellipse. A curved portion of the ellipse is the arc of the pie.

[in] Long integer value that specifies the y-coordinate of the upper-left corner of the rectangle that bounds the ellipse.

width

[in] Long integer value that specifies the width of the rectangle that bounds the ellipse.

heigth

[in] Long integer value that specifies the height of the rectangle that bounds the ellipse.

startAngle

[in] Simple precision value that specifies the angle, in degrees, between the x-axis and the starting point of the pie's arc.

sweepAngle

[in] Simple precision value that specifies the angle, in degrees, between the starting and ending points of the pie's arc.

Remarks

A pie is a portion of the interior of an ellipse (it is bounded by an elliptical curve and two radial lines). The startAngle and sweepAngle specify the portion of the ellipse to be used.

GdipFillPolygon

Description

Uses uses a brush to fill the interior of a polygon.

Syntax

GpStatus WINGDIPAPI GdipFillPolygon(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPointF *points,

    INT count,

    GpFillMode fillMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPolygon ( _

    BYVAL graphics AS DWORD _

    BYVAL brush AS DWORD _

    BYREF pPoints AS PointF _

    BYVAL count AS LONG _

    BYVAL fillMode AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the polygon.

points

[in] Pointer to an array of points that make up the vertices of the polygon. The first two points in the array specify the first side of the polygon. Each additional point specifies a new side, the vertices of which include the point and the previous point. If the last point and the first point do not coincide, they specify the last side of the polygon.

count

[in] Long integer value that specifies the number of points in the points array.

fillmode

[in] Element of the FillMode enumeration that specifies how to fill a closed area that is within another closed area and that is created when the curve or path passes over itself.

GdipFillPolygon2

Description

Uses uses a brush to fill the interior of a polygon.

Syntax

GpStatus WINGDIPAPI GdipFillPolygon2(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPointF *points,

    INT count

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPolygon2 ( _

    BYVAL graphics AS DWORD _

    BYVAL brush AS DWORD _

    BYREF pPoints AS PointF _

    BYVAL count AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the polygon.

points

[in] Pointer to an array of points that make up the vertices of the polygon. The first two points in the array specify the first side of the polygon. Each additional point specifies a new side, the vertices of which include the point and the previous point. If the last point and the first point do not coincide, they specify the last side of the polygon.

count

[in] Long integer value that specifies the number of points in the points array.

GdipFillPolygon2I

Description

Uses uses a brush to fill the interior of a polygon.

Syntax

GpStatus WINGDIPAPI GdipFillPolygon2I(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPoint *points,

    INT count

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPolygon2I ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF pPoints AS PointL, _

    BYVAL count AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the polygon.

points

[in] Pointer to an array of points that make up the vertices of the polygon. The first two points in the array specify the first side of the polygon. Each additional point specifies a new side, the vertices of which include the point and the previous point. If the last point and the first point do not coincide, they specify the last side of the polygon.

count

[in] Long integer value that specifies the number of points in the points array.

GdipFillPolygonI

Description

Uses uses a brush to fill the interior of a polygon.

Syntax

GpStatus WINGDIPAPI GdipFillPolygonI(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpPoint *points,

    INT count,

    GpFillMode fillMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillPolygonI ( _

    BYVAL graphics AS DWORD _

    BYVAL brush AS DWORD _

    BYREF pPoints AS PointL _

    BYVAL count AS LONG _

    BYVAL fillMode AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the polygon.

points

[in] Pointer to an array of points that make up the vertices of the polygon. The first two points in the array specify the first side of the polygon. Each additional point specifies a new side, the vertices of which include the point and the previous point. If the last point and the first point do not coincide, they specify the last side of the polygon.

count

[in] Long integer value that specifies the number of points in the points array.

fillmode

[in] Element of the FillMode enumeration that specifies how to fill a closed area that is within another closed area and that is created when the curve or path passes over itself.

GdipFillRectangle

Description

Uses uses a brush to fill the interior of a rectangle.

Syntax

GpStatus WINGDIPAPI GdipFillRectangle(

    GpGraphics *graphics,

    GpBrush *brush,

    REAL x,

    REAL y,

    REAL width,

    REAL height

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillRectangle ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL x AS SINGLE, _

    BYVAL y AS SINGLE, _

    BYVAL nWidth AS SINGLE, _

    BYVAL nHeight AS SINGLE _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the rectangle.

[in] Simple precision value that specifies the x-coordinate of the upper-left corner of the rectangle to be filled.

[in] Simple precision value that specifies the y-coordinate of the upper-left corner of the rectangle to be filled.

width

[in] Simple precision value that specifies the width of the rectangle to be filled.

height

[in] Real number that specifies the height of the rectangle to be filled.

GdipFillRectangleI

Description

Uses uses a brush to fill the interior of a rectangle.

Syntax

GpStatus WINGDIPAPI GdipFillRectangleI(

    GpGraphics *graphics,

    GpBrush *brush,

    INT x,

    INT y,

    INT width,

    INT height

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillRectangleI ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL x AS LONG, _

    BYVAL y AS LONG, _

    BYVAL nidth AS LONG, _

    BYVAL nHeight AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the rectangle.

[in] Long integer value that specifies the x-coordinate of the upper-left corner of the rectangle to be filled.

[in] Long integer value that specifies the y-coordinate of the upper-left corner of the rectangle to be filled.

width

[in] Long integer value that specifies the width of the rectangle to be filled.

height

[in] Long integer value that specifies the height of the rectangle to be filled.

GdipFillRectangles

Description

Uses uses a brush to fill the interior of a rectangle.

Syntax

GpStatus WINGDIPAPI GdipFillRectangles(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpRectF *rects,

    INT count

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillRectangles ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF rects AS RECTF, _

    BYVAL count AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the rectangle.

rects

[in] Pointer to an array of rectangles to be filled.

count

[in] Long integer value that specifies the number of rectangles in the rects array.

GdipFillRectanglesI

Description

Uses uses a brush to fill the interior of a rectangle.

Syntax

GpStatus WINGDIPAPI GdipFillRectanglesI(

    GpGraphics *graphics,

    GpBrush *brush,

    GDIPCONST GpRect *rects,

    INT count

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillRectanglesI ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYREF rects AS RECTL, _

    BYVAL count AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the interior of the rectangle.

rects

[in] Pointer to an array of rectangles to be filled.

count

[in] Long integer value that specifies the number of rectangles in the rects array.

GdipFillRegion

Description

Uses uses a brush to fill a specified region.

Syntax

GpStatus WINGDIPAPI GdipFillRegion(

    GpGraphics *graphics,

    GpBrush *brush,

    GpRegion *region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFillRegion ( _

    BYVAL graphics AS DWORD, _

    BYVAL brush AS DWORD, _

    BYVAL region AS DWORD _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

brush

[in] Pointer to a Brush object that is used to paint the region.

region

[in] Pointer to a region to be filled.

Remarks

Because a region describes a set of pixels, a pixel is considered either fully inside, or fully outside the region. Consequently, GdipFillRegion does not antialias the edges of the region.

GdipFlush

Description

Flushes all pending graphics operations.

Syntax

GpStatus WINGDIPAPI GdipFlush(

GpGraphics *graphics,

GpFlushIntention intention

);

PowerBASIC Syntax

DECLARE FUNCTION GdipFlush ( _

BYVAL graphics AS DWORD, _

BYVAL intention AS LONG _

) AS LONG

Parameters

graphics

[in] Pointer to the Graphics object.

intention

[in] Element of the FlushIntention enumeration that specifies whether pending operations are flushed immediately (not executed) or executed as soon as possible.

Page last updated on Monday, 11 December 2006 11:02:43 +0100