DrawClipRect Function (ROM Call 0x195)

graph.h

void DrawClipRect (const WIN_RECT *rect, const SCR_RECT *clip, short Attr);

Draws a clipped rectangle.

DrawClipRect draws a rectangle with (x0, y0) and (x1, y1) as corners, where coordinates (x0, y0) and (x1, y1) are given in a WIN_RECT structure rect. The rectangle will be clipped at the boundaries of the area given by parameter clip. See SetCurClip for more info about clipping areas. The interior of the rectangle remains intact (no fill). The border lines of the rectangle will be drawn using the attribute Attr. See DrawLine for a description of supported line atributes. In addition, the attribute may be ORed with one or more following constants (which are defined in enum BoxAttrs:

B_NORMALDraw a normal rectangle
B_DOUBLEDraw a double thick rectangle
B_ROUNDEDDraw a rectangle with rounded corners
B_CUTDraw a rectangle with the upper corners cut (like in toolboxes)

Note: I cannot conclude what the difference is if you OR the attribute with B_NORMAL or if you do not do so. Maybe I am stupid.


Uses: DrawClipPix, LineTo, MoveTo, SetCurAttr, SetCurClip
Used by: MenuKey, MenuOff, MenuOn, MenuTopRedef, MenuTopSelect, DrawWinBorder, WinRect, ROM Call 0x421