Button

Defines the [Normal/Toggle/Radio/Popup] nanogui.Button widget.

Constructors

this
this(Widget parent, string caption)

Creates a button attached to the specified parent.

this
this(Widget parent, string caption, dchar icon)

Creates a button attached to the specified parent.

this
this(Widget parent, string caption, const(NVGImage) image)

Creates a button attached to the specified parent.

Members

Enums

Flags
enum Flags

Flags to specify the button behavior (can be combined with binary OR)

IconPosition
enum IconPosition

The available icon positions.

Functions

backgroundColor
Color backgroundColor()

Returns the background color of this Button.

backgroundColor
void backgroundColor(Color backgroundColor)

Sets the background color of this Button.

buttonGroup
void buttonGroup(ButtonGroup buttonGroup)

Set the button group (for radio buttons).

buttonGroup
buttonGroup()

The current button group (for radio buttons).

callback
void delegate() callback()

The current callback to execute (for any type of button).

callback
void callback(void delegate() callback)

Set the push callback (for any type of button).

caption
string caption()

Returns the caption of this Button.

caption
void caption(string caption)

Sets the caption of this Button.

changeCallback
void delegate(bool) changeCallback()

The current callback to execute (for toggle buttons).

changeCallback
void changeCallback(void delegate(bool) callback)

Set the change callback (for toggle buttons).

draw
void draw(NanoContext ctx)

Responsible for drawing the Button.

flags
int flags()

The current flags of this Button (see nanogui.Button.Flags for options).

flags
void flags(int buttonFlags)

Sets the flags of this Button (see nanogui.Button.Flags for options).

icon
dchar icon()

Returns the icon of this Button. See nanogui.Button.mIcon.

icon
void icon(int icon)

Sets the icon of this Button. See nanogui.Button.mIcon.

iconPosition
IconPosition iconPosition()

The position of the icon for this Button.

iconPosition
void iconPosition(IconPosition iconPosition)

Sets the position of the icon for this Button.

mouseButtonEvent
bool mouseButtonEvent(Vector2i p, MouseButton button, bool down, int modifiers)

The callback that is called when any type of mouse button event is issued to this Button.

preferredSize
Vector2i preferredSize(NanoContext ctx)

The preferred size of this Button.

pushed
bool pushed()

Whether or not this Button is currently pushed.

pushed
void pushed(bool pushed)

Sets whether or not this Button is currently pushed.

textColor
Color textColor()

Returns the text color of the caption of this Button.

textColor
void textColor(Color textColor)

Sets the text color of the caption of this Button.

Variables

mBackgroundColor
Color mBackgroundColor;

The background color of this Button.

mButtonGroup
ButtonGroup mButtonGroup;

The button group for radio buttons.

mCallback
void delegate() mCallback;

The callback issued for all types of buttons.

mCaption
string mCaption;

The caption of this Button.

mChangeCallback
void delegate(bool) mChangeCallback;

The callback issued for toggle buttons.

mFlags
int mFlags;

The current flags of this button (see nanogui.Button.Flags for options).

mIcon
dchar mIcon;

The icon to display with this Button (0 means icon is represented by mImage).

mIconPosition
IconPosition mIconPosition;

The position to draw the icon at.

mImage
NVGImage mImage;

The icon to display with this Button (it's used if mIcon is 0 and mImage.valid returns true).

mPushed
bool mPushed;

Whether or not this Button is currently pushed.

mTextColor
Color mTextColor;

The color of the caption text of this Button.

Inherited Members

From Widget

parent
Widget parent()

Return the parent widget

parent
auto parent()

Return the parent widget

parent
void parent(Widget parent)

Set the parent widget

layout
Layout layout()

Return the used nanogui.layout.Layout generator

layout
auto layout()

Return the used nanogui.layout.Layout generator

layout
void layout(Layout layout)

Set the used nanogui.layout.Layout generator

theme
const(Theme) theme()

Return the nanogui.theme.Theme used to draw this widget

theme
void theme(Theme theme)

Set the nanogui.theme.Theme used to draw this widget

position
Vector2i position()

Return the position relative to the parent widget

position
void position(Vector2i pos)

Set the position relative to the parent widget

absolutePosition
Vector2i absolutePosition()

Return the absolute position on screen

size
Vector2i size()

Return the size of the widget

size
void size(Vector2i size)

set the size of the widget

width
int width()

Return the width of the widget

width
void width(int width)

Set the width of the widget

height
int height()

Return the height of the widget

height
void height(int height)

Set the height of the widget

fixedSize
void fixedSize(Vector2i fixedSize)

Set the fixed size of this widget

fixedSize
Vector2i fixedSize()

Return the fixed size

fixedWidth
int fixedWidth()

Return the fixed width (see fixedSize)

fixedHeight
int fixedHeight()

Return the fixed height (see fixedSize)

fixedWidth
void fixedWidth(int width)

Set the fixed width (see fixedSize)

fixedHeight
void fixedHeight(int height)

Set the fixed height (see fixedSize)

visible
bool visible()

Return whether or not the widget is currently visible (assuming all parents are visible)

visible
void visible(bool visible)

Set whether or not the widget is currently visible (assuming all parents are visible)

visibleRecursive
bool visibleRecursive()

Check if this widget is currently visible, taking parent widgets into account

childCount
int childCount()

Return the number of child widgets

children
auto children()

Return the list of child widgets of the current widget

addChild
void addChild(int index, Widget widget)

Add a child widget to the current widget at the specified index.

addChild
void addChild(Widget widget)

Convenience function which appends a widget at the end

removeChild
void removeChild(int index)

Remove a child widget by index

removeChild
void removeChild(Widget widget)

Remove a child widget by value

childAt
auto childAt(int index)

Retrieves the child at the specific position

childAt
auto childAt(int index)

Retrieves the child at the specific position

childIndex
int childIndex(Widget widget)

Returns the index of a specific child or -1 if not found

add
auto add(Args args)

Variadic shorthand notation to construct and add a child widget

window
Window window()

Walk up the hierarchy and return the parent window

screen
Screen screen()

Walk up the hierarchy and return the parent screen

setId
void setId(string id)

Associate this widget with an ID value (optional)

id
auto id()

Return the ID value associated with this widget, if any

enabled
bool enabled()

Return whether or not this widget is currently enabled

enabled
void enabled(bool enabled)

Set whether or not this widget is currently enabled

focused
bool focused()

Return whether or not this widget is currently focused

focused
void focused(bool focused)

Set whether or not this widget is currently focused

requestFocus
void requestFocus()

Request the focus to be moved to this widget

tooltip
string tooltip()
Undocumented in source. Be warned that the author may not have intended to support it.
tooltip
void tooltip(string tooltip)
Undocumented in source. Be warned that the author may not have intended to support it.
fontSize
int fontSize()

Return current font size. If not set the default of the current theme will be returned

fontSize
void fontSize(int fontSize)

Set the font size of this widget

hasFontSize
bool hasFontSize()

Return whether the font size is explicitly specified for this widget

iconExtraScale
float iconExtraScale()

The amount of extra scaling applied to *icon* fonts. See nanogui.Widget.mIconExtraScale.

iconExtraScale
void iconExtraScale(float scale)

Sets the amount of extra scaling applied to *icon* fonts. See nanogui.Widget.mIconExtraScale.

cursor
Cursor cursor()

Return a pointer to the cursor of the widget

cursor
void cursor(Cursor value)

Set the cursor of the widget

contains
bool contains(Vector2i p)

Check if the widget contains a certain position

findWidget
Widget findWidget(Vector2i p)

Determine the widget located at the given position value (recursive)

mouseButtonEvent
bool mouseButtonEvent(Vector2i p, MouseButton button, bool down, int modifiers)

Handle a mouse button event (default implementation: propagate to children)

mouseMotionEvent
bool mouseMotionEvent(Vector2i p, Vector2i rel, MouseButton button, int modifiers)

Handle a mouse motion event (default implementation: propagate to children)

mouseDragEvent
bool mouseDragEvent(Vector2i p, Vector2i rel, MouseButton button, int modifiers)

Handle a mouse drag event (default implementation: do nothing)

mouseEnterEvent
bool mouseEnterEvent(Vector2i p, bool enter)

Handle a mouse enter/leave event (default implementation: record this fact, but do nothing)

scrollEvent
bool scrollEvent(Vector2i p, Vector2f rel)

Handle a mouse scroll event (default implementation: propagate to children)

focusEvent
bool focusEvent(bool focused)

Handle a focus change event (default implementation: record the focus status, but do nothing)

keyboardEvent
bool keyboardEvent(int key, int scancode, KeyAction action, int modifiers)

Handle a keyboard event (default implementation: do nothing)

keyboardCharacterEvent
bool keyboardCharacterEvent(dchar codepoint)

Handle text input (UTF-32 format) (default implementation: do nothing)

preferredSize
Vector2i preferredSize(NanoContext ctx)

Compute the preferred size of the widget

preferredSize
Vector2i preferredSize(NanoContext ctx, Widget skipped)

Compute the preferred size of the widget considering its child except skipped one (for example button panel of window)

performLayout
void performLayout(NanoContext ctx)

Invoke the associated layout generator to properly place child widgets, if any

draw
void draw(NanoContext ctx)

Draw the widget (and all child widgets)

~this
~this()

Free all resources used by the widget and any children

icon_scale
float icon_scale()

Convenience definition for subclasses to get the full icon scale for this class of Widget. It simple returns the value mTheme.mIconScale * this.mIconExtraScale.

mParent
Widget mParent;
Undocumented in source.
mTheme
Theme mTheme;
Undocumented in source.
mLayout
Layout mLayout;
Undocumented in source.
mId
string mId;
Undocumented in source.
mPos
Vector2i mPos;
mSize
Vector2i mSize;
mFixedSize
Vector2i mFixedSize;
Undocumented in source.
mChildren
Array!Widget mChildren;
Undocumented in source.
mVisible
bool mVisible;

Whether or not this Widget is currently visible. When a Widget is not currently visible, no time is wasted executing its drawing method.

mEnabled
bool mEnabled;

Whether or not this Widget is currently enabled. Various different kinds of derived types use this to determine whether or not user input will be accepted. For example, when `mEnabled == false`, the state of a CheckBox cannot be changed, or a TextBox will not allow new input.

mFocused
bool mFocused;
mMouseFocus
bool mMouseFocus;
Undocumented in source.
mTooltip
string mTooltip;
Undocumented in source.
mFontSize
int mFontSize;
Undocumented in source.
mIconExtraScale
float mIconExtraScale;

The amount of extra icon scaling used in addition the the theme's default icon font scale. Default value is `1.0`, which implies that icon_scale simply returns the value of nanogui.Theme.mIconScale.

mCursor
Cursor mCursor;
Undocumented in source.

Meta