c4d.gui.BitmapButtonCustomGui

class c4d.gui.BitmapButtonCustomGui

Bitmap button custom GUI (CUSTOMGUI_BITMAPBUTTON). The settings are:

Key

Value Type

Description

BITMAPBUTTON_BORDER

int

Border type used for the pressed button state if BITMAPBUTTON_OUTBORDER is set

BORDER_NONE

No border.

BORDER_THIN_IN

Thin border inward.

BORDER_THIN_OUT

Thin border outward.

BORDER_IN

Normal border inward.

BORDER_OUT

Normal border outward.

BORDER_GROUP_IN

Group border inside.

BORDER_GROUP_OUT

Group border outside.

BORDER_OUT2

Outward border 2.

BORDER_OUT3

Outward border 3

BORDER_BLACK

Thin black line.

BORDER_ACTIVE_1

Active border 1.

BORDER_ACTIVE_2

Active border 2.

BORDER_ACTIVE_3

Active border 3.

BORDER_ACTIVE_4

Active border 4.

BORDER_GROUP_TOP

Border along the top.

BORDER_ROUND

Border with round corners.

BORDER_SCHEME_EDIT

Edit field border like the shortcut gadget for example.

BORDER_SCHEME_EDIT_NUMERIC

Edit field border that is open to the right like the link field for example.

BORDER_OUT3l

Outward border 3, open to the left.

BORDER_OUT3r

Outward border 3, open to the right.

BORDER_THIN_INb

Thin border inward, open to the botton.

BORDER_MASK

Masks out border type.

BORDER_TEXT_DOTTED

New in version R21:
Only used with GeDialog.AddStaticText().
Draws a dotted line at right of text, useful to visually connect the text with its parameter.

BORDER_WITH_TITLE_MONO

Display group title with monospaced font.

BORDER_WITH_TITLE_BOLD

Display group title with bold font.

BORDER_WITH_TITLE

Display group title in the border.

BITMAPBUTTON_BUTTON

bool

Clickable button. To detect when the button is pressed in a description check if the DESCFLAGS_SET_USERINTERACTION flag is set in the NodeData.SetDParameter() call.

BITMAPBUTTON_TOGGLE

bool

Toggle button, like a checkbox.

BITMAPBUTTON_IGNORE_BITMAP_WIDTH

bool

Ignore bitmap width.

BITMAPBUTTON_IGNORE_BITMAP_HEIGHT

bool

Ignore bitmap height.

BITMAPBUTTON_DRAWPOPUPBUTTON

bool

Draw popup button.

BITMAPBUTTON_TOOLTIP

str

Tooltip string. Only works if BITMAPBUTTON_BUTTON is True.

BITMAPBUTTON_ICONID1

int

Registered icon bitmap ID. On state for toggle buttons.

BITMAPBUTTON_ICONID2

int

Registered icon bitmap ID. Off state for toggle buttons.

BITMAPBUTTON_FORCE_SIZE

int

Forces the width and height of the icon in pixels if value is greater than 0.

BITMAPBUTTON_FORCE_SIZE_Y

int

Additionally forces the y size of the bitmap button. FORCE_SIZE is used for y size when not specified.

BITMAPBUTTON_SPECIAL

bool

Private.

BITMAPBUTTON_NOBORDERDRAW

bool

Disable border drawing.

BITMAPBUTTON_OUTBORDER

int

Out border type used if BITMAPBUTTON_BUTTON is True

BORDER_NONE

No border.

BORDER_THIN_IN

Thin border inward.

BORDER_THIN_OUT

Thin border outward.

BORDER_IN

Normal border inward.

BORDER_OUT

Normal border outward.

BORDER_GROUP_IN

Group border inside.

BORDER_GROUP_OUT

Group border outside.

BORDER_OUT2

Outward border 2.

BORDER_OUT3

Outward border 3

BORDER_BLACK

Thin black line.

BORDER_ACTIVE_1

Active border 1.

BORDER_ACTIVE_2

Active border 2.

BORDER_ACTIVE_3

Active border 3.

BORDER_ACTIVE_4

Active border 4.

BORDER_GROUP_TOP

Border along the top.

BORDER_ROUND

Border with round corners.

BORDER_SCHEME_EDIT

Edit field border like the shortcut gadget for example.

BORDER_SCHEME_EDIT_NUMERIC

Edit field border that is open to the right like the link field for example.

BORDER_OUT3l

Outward border 3, open to the left.

BORDER_OUT3r

Outward border 3, open to the right.

BORDER_THIN_INb

Thin border inward, open to the botton.

BORDER_MASK

Masks out border type.

BORDER_TEXT_DOTTED

New in version R21:
Only used with GeDialog.AddStaticText().
Draws a dotted line at right of text, useful to visually connect the text with its parameter.

BORDER_WITH_TITLE_MONO

Display group title with monospaced font.

BORDER_WITH_TITLE_BOLD

Display group title with bold font.

BORDER_WITH_TITLE

Display group title in the border.

BITMAPBUTTON_BACKCOLOR

int

Background color. See COLOR constants.

BITMAPBUTTON_MIRROR

bool

Mirror the button in an Arabic interface.

BITMAPBUTTON_STRING

str

New in version R20: Adds a string in bold font at left of the icon.

BITMAPBUTTON_DISABLE_FADING

bool

New in version S22: Disables the mouse over fading effect.

BITMAPBUTTON_FORCE_TOOLTIP

bool

New in version S26: Forces to show the defined tooltip when BITMAPBUTTON_BUTTON is false.

BITMAPBUTTON_NO_COLOR_INFO

bool

New in version S26: Hides the per-pixel color info that pops-up when holding CTRL key on mouse hover when BITMAPBUTTON_BUTTON is false.

Note

To format the bitmap’s button tooltip text (BITMAPBUTTON_TOOLTIP) use the <b> and <br> HTML tags.
For instance this is used internally to format the tooltip text for the palettes buttons.

For example.

bc.SetString(c4d.BITMAPBUTTON_TOOLTIP, "<b>Bold Text</b><br>New line")

Methods Signatures

BitmapButtonCustomGui.SetImage(self, obj[, copybmp, ...])

Sets the image.

BitmapButtonCustomGui.SetToggleState(self, set)

Sets the toggle state of the button.

BitmapButtonCustomGui.SetCommandDragId(self, cmdid)

Sets a command ID for the bitmap button.

BitmapButtonCustomGui.SetTooltip(self, tooltip)

Sets the tooltip string of the button.

Inheritance

Parent Class:

Methods Documentation

BitmapButtonCustomGui.SetImage(self, obj, copybmp=True, secondstate=False)

Sets the image.

Parameters
  • obj (Union[str, c4d.bitmaps.BaseBitmap, dict, c4d.IconData]) –

    The filename, bitmap or icon to load the image from.

    Changed in version 21: c4d.IconData is now supported.

  • copybmp (bool) – If this is True the bitmap is copied.

  • secondstate (bool) – If this is True the function stores a second state for toggle and clickable buttons.

Return type

bool

Returns

True if successful, otherwise False.

BitmapButtonCustomGui.SetToggleState(self, set)

Sets the toggle state of the button.

Parameters

set (bool) – New toggle state.

BitmapButtonCustomGui.SetCommandDragId(self, cmdid)
Sets a command ID for the bitmap button.
This enables drag and drop of the command into tool bars and menu manager. Used e.g. in the script manager.
Parameters

cmdid (int) – The ID of the command.

BitmapButtonCustomGui.SetTooltip(self, tooltip)

Sets the tooltip string of the button.

New in version 24.

Parameters

tooltip (str) – The new Tooltip state.