Home / Autodocs / gadtools.library
NAME
- DrawBevelBoxA
-
draw a bevelled box. (V36)
- DrawBevelBox
-
varargs stub for DrawBevelBoxA(). (V36)
SYNOPSIS
DrawBevelBoxA(rport, left, top, width, height, tagList);
VOID DrawBevelBoxA(struct RastPort *, WORD, WORD, WORD, WORD,
DrawBevelBox(rport, left, top, width, height, firsttag, ...);
VOID DrawBevelBox(struct RastPort *, WORD, WORD, WORD, WORD,
A0 D0 D1 D2 D3 A1
struct TagItem *taglist);
VOID DrawBevelBox(struct RastPort *, WORD, WORD, WORD, WORD,
Tag, ...);
FUNCTION
This function renders a bevelled box of specified dimensions and type into the supplied RastPort.
INPUTS
- rport
-
RastPort into which the box is to be drawn.
- left
-
left edge of the box.
- top
-
top edge of the box.
- width
-
width of the box.
- height
-
height of the box.
- tagList
-
pointer to an array of tags providing extra parameters
TAGS
- GTBB_Recessed (BOOL)
-
Set to anything for a recessed-looking box. If absent, the box defaults, it would be raised. (V36)
- GTBB_FrameType (ULONG)
-
Determines what kind of box this function renders. BBFT_BUTTON generates a box like what is used around GadTools BUTTON_KIND gadgets. BBFT_RIDGE generates a box like what is used around GadTools STRING_KIND gadgets. BBFT_ICONDROPBOX generates a box suitable for a standard icon drop box imagery. (V39) BBFT_CTXTFRAME draws a frame with a headline, suitable for grouping GUI elements. The text for the headline is given by GTBB_Headline. (V47)
- GT_VisualInfo (APTR)
-
You MUST supply the value you obtained from an earlier call to GetVisualInfoA() with this tag. (V36)
- GTBB_Scale (BOOL)
-
If set, coordinates are scaled according to the VisualInfo design font, see SetDesignFontA() for the scaling algorithm. (V47)
- GTBB_Headline (UBYTE *)
-
Pointer to a NUL-terminated string for a headline that is centered on top of the context frame, i.e. GTBB_FrameType = BBFT_CTXTFRAME boxes (V47).
- GTBB_HeadlinePen (UBYTE)
-
Pen to use for rendering the headline, defaults to the HIGHLIGHTTEXTPEN. (V47)
- GTBB_HeadlineFont (struct TextAttr *)
-
Font to use to render the headline. Defaults to the font of the rastport. (V47)
NOTES
DrawBevelBox() is a rendering operation, not a gadget. That means you must refresh it at the appropriate time, like any other rendering operation. BBFT_CTXTFRAME requires intuition V47 to render anything.