GT_SetGadgetAttrsA

change the attributes of a GadTools gadget. (V36)

GT_SetGadgetAttrs

varargs stub for GT_SetGadgetAttrsA(). (V36)

Change the attributes of the specified gadget, according to the attributes chosen in the tag list. If an attribute is not provided in the tag list, its value remains unchanged.

gad

pointer to the gadget in question. Starting with V39, this value may be NULL in which case this function does nothing

win

pointer to the window containing the gadget. Starting with V39, this value may be NULL in which case the internal attributes of the gadgets are altered but no rendering occurs.

req

reserved for future use, should always be NULL

tagList

pointer to an array of tags providing optional extra parameters, or NULL.

BUTTON_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise. (V36)

CHECKBOX_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise. (V36)

GTCB_Checked (BOOL)

State of checkbox. (V36)

CYCLE_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V37)

GTCY_Active (UWORD)

The ordinal number (counting from zero) of the active choice of a cycle gadget. (V36)

GTCY_Labels (STRPTR *)

Pointer to NULL-terminated array of strings that are the choices offered by the cycle gadget. (V37)

INTEGER_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V36)

GTIN_Number (ULONG)

New value of the integer gadget (V36)

LISTVIEW_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V39)

GTLV_Top (WORD)

Top item visible in the listview. This value will be made reasonable if out-of-range. (V36)

GTLV_MakeVisible (WORD)

Number of an item that should be forced within the visible area of the listview by doing minimal scrolling. This tag overrides GTLV_Top. (V39)

GTLV_Labels (struct List *)

List of nodes whose ln_Name fields are to be displayed in the listview. Use a value of ~0 to "detach" your List from the display. You must detach your list before modifying the List structure, since GadTools reserves the right to traverse it on another task's schedule. When you are done, attach the list by using the tag pair {GTLV_Labels, list}. (V36)

GTLV_Selected (UWORD)

Ordinal number of currently selected item. Starting with V39, you can provide ~0 to cause the currently selected item to be deselected. (V36)

MX_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V39)

GTMX_Active (UWORD)

The ordinal number (counting from zero) of the active choice of an mx gadget. (V36)

NUMBER_KIND:

GTNM_Number (LONG)

A signed long integer to be displayed in the number gadget. (V36)

GTNM_FrontPen (UBYTE)

The pen to use when rendering the number. (V39)

GTNM_BackPen (UBYTE)

The pen to use when rendering the background of the number. (V39)

GTNM_Justification (UBYTE)

Determines how the number is rendered within the gadget box. GTJ_LEFT will make the rendering be flush with the left side of the gadget, GTJ_RIGHT will make it flush with the right side, and GTJ_CENTER will center the number within the gadget box. (V39)

GTNM_Format (STRPTR)

C-Style formatting string to apply on the number before display. Be sure to use the 'l' (long) modifier. This string is processed using exec.library/RawDoFmt(), so refer to that function for details. (V39)

PALETTE_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V36)

GTPA_Color (UBYTE)

Selected color of the palette. This number is a pen number, and not the ordinal color number within the palette gadget itself. (V36)

GTPA_ColorOffset (UBYTE)

First color to use in palette (V39)

GTPA_ColorTable (UBYTE *)

Pointer to a table of pen numbers indicating which colors should be used and edited by the palette gadget. This array must contain as many entries as there are colors displayed in the palette gadget. The array provided with this tag must remain valid for the life of the gadget or until a new table is provided. A NULL table pointer causes a 1-to-1 mapping of pen numbers. (V39)

SCROLLER_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V36)

GTSC_Top (WORD)

Top visible in scroller. (V36)

GTSC_Total (WORD)

Total in scroller area. (V36)

GTSC_Visible (WORD)

Number visible in scroller. (V36)

SLIDER_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V36)

GTSL_Min (WORD)

Minimum level for slider. (V36)

GTSL_Max (WORD)

Maximum level for slider. (V36)

GTSL_Level (WORD)

Current level of slider. (V36)

GTSL_LevelFormat (STRPTR)

C-Style formatting string for slider level. Be sure to use the 'l' (long) modifier. This string is processed using exec.library/RawDoFmt(), so refer to that function for details. (V39)

GTSL_DispFunc ( LONG (*function)(struct Gadget *, LONG) ) - Function

GTSL_Justification (UBYTE)

Determines how the level display is to be justified within its alotted space. Choose one of GTJ_LEFT, GTJ_RIGHT, or GTJ_CENTER. (V39)

STRING_KIND:

GA_Disabled (BOOL)

Set to TRUE to disable gadget, FALSE otherwise (V36)

GTST_String (STRPTR)

New contents of the string gadget, or NULL to reset the gadget to the empty state. (V36)

TEXT_KIND:

GTTX_Text

New NULL terminated string to be displayed in the text gadget. NULL means to clear the gadget. (V36)

GTTX_FrontPen (UBYTE)

The pen to use when rendering the text. (V39)

GTTX_BackPen (UBYTE)

The pen to use when rendering the background of the text. (V39)

GTTX_Justification (UBYTE)

Determines how the text is rendered within the gadget box. GTJ_LEFT will make the rendering be flush with the left side of the gadget, GTJ_RIGHT will make it flush with the right side, and GTJ_CENTER will center the text within the gadget box. (V39)

This function may not be called inside of a GT_BeginRefresh() / GT_EndRefresh() session. (As always, restrict yourself to simple rendering functions).

The function set by the GTSL_DispFunc tag will be called with its two parameters passed on the stack. Note that these parameters are not passed in dedicated registers and you should make no assumptions about the register contents when it is called. Both parameters are passed as 32 bit values:

The level value is a signed 32 bit integer whose range is limited to -32768..32767. Previous versions of this documentation suggested that the level value may have been a signed 16 bit integer but this has never been the case.

GT_GetGadgetAttrs()