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 R26: Forces to show the defined tooltip when BITMAPBUTTON_BUTTON is false.

BITMAPBUTTON_NO_COLOR_INFO

bool

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

Parent Class:

c4d.gui.BaseCustomGui

Overview¶

Interaction Behavior
`BitmapButtonCustomGui.SetCommandDragId()`	Sets a command ID for the bitmap button.
`BitmapButtonCustomGui.SetToggleState()`	Sets the toggle state of the button.
Visual Configuration
`BitmapButtonCustomGui.SetImage()`	Sets the image.
`BitmapButtonCustomGui.SetTooltip()`	Sets the tooltip string of the button.

Members¶

Interaction Behavior¶

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.SetToggleState(self, set)¶

Sets the toggle state of the button.

Parameters: set (bool) – New toggle state.

Visual Configuration¶

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.SetTooltip(self, tooltip)¶

Sets the tooltip string of the button.

New in version 24.

Parameters: tooltip (str) – The new Tooltip state.

Category	Option	Description
Query	Words and phrases	Search is case-insensitive. Put a phrase in quotes for an exact match. Quoted phrases require every word and disable fuzzy matching.
Terms	OR / AND	Choose whether to match any term or require all terms.
Fuzzy	On / Off	Toggle approximate and prefix matches. Quoted phrases always use strict matching.
Results	Sparse / Dense	Sparse groups multiple hits for one entity and hides its owned API members when the class or module itself matches. Dense lists each match separately.
Sort by	Type / Relevance	Group results by entity type then rank within each group, or rank all results by relevance.
Content	All / API / Manuals / Examples / Resources	Search all documentation, API documentation, manuals, the examples index, or the resources index. Code examples embedded in other sections retain their own content area.
Entity	All / Page / Module / Class / Function / Attribute / Description / Node / Symbol / Icon	Page covers results without a specific entity type. Resource entity types are available with All or Resources; API entity types are available with All or API.
Location	All / Text / Code / Name / Signature	Text covers everything outside code, names, and signatures. Name and Signature are available with All or API.