|
Wt
4.10.0
|
A split button. More...
#include <Wt/WSplitButton.h>
Public Member Functions | |
| WSplitButton () | |
| Constructor. | |
| WSplitButton (const WString &label) | |
| Constructor passing the label. | |
| WPushButton * | actionButton () const |
| Returns the action button. | |
| WPushButton * | dropDownButton () const |
| Returns the drop down button. | |
| void | setMenu (std::unique_ptr< WPopupMenu > menu) |
| Sets the menu for the drop-down button. | |
| WPopupMenu * | menu () const |
| Returns the menu for the drop-down button. | |
Public Member Functions inherited from Wt::WCompositeWidget | |
| WCompositeWidget () | |
| Creates a WCompositeWidget. | |
| WCompositeWidget (std::unique_ptr< WWidget > implementation) | |
| Creates a WCompositeWidget with given implementation. | |
| virtual std::vector< WWidget * > | children () const override |
| Returns child widgets. | |
| virtual std::unique_ptr< WWidget > | removeWidget (WWidget *widget) override |
| Removes a child widget. | |
| virtual void | setObjectName (const std::string &name) override |
| Sets an object name. | |
| virtual std::string | objectName () const override |
| Returns the object name. | |
| virtual const std::string | id () const override |
| Returns the (unique) identifier for this object. | |
| virtual void | setPositionScheme (PositionScheme scheme) override |
| Sets the CSS position scheme. | |
| virtual PositionScheme | positionScheme () const override |
| Returns the CSS position scheme. | |
| virtual void | setOffsets (const WLength &offset, WFlags< Side > sides=AllSides) override |
| Sets CSS offsets for a non-statically positioned widget. | |
| virtual WLength | offset (Side s) const override |
| Returns a CSS offset. | |
| virtual void | resize (const WLength &width, const WLength &height) override |
| Resizes the widget. | |
| virtual WLength | width () const override |
| Returns the width. | |
| virtual WLength | height () const override |
| Returns the height. | |
| virtual void | setMinimumSize (const WLength &width, const WLength &height) override |
| Sets a minimum size. | |
| virtual WLength | minimumWidth () const override |
| Returns the minimum width. | |
| virtual WLength | minimumHeight () const override |
| Returns the minimum height. | |
| virtual void | setMaximumSize (const WLength &width, const WLength &height) override |
| Sets a maximum size. | |
| virtual WLength | maximumWidth () const override |
| Returns the maximum width. | |
| virtual WLength | maximumHeight () const override |
| Returns the maximum height. | |
| virtual void | setLineHeight (const WLength &height) override |
| Sets the CSS line height for contained text. | |
| virtual WLength | lineHeight () const override |
| Returns the CSS line height for contained text. | |
| virtual void | setFloatSide (Side s) override |
| Specifies a CSS float side. | |
| virtual Side | floatSide () const override |
| Returns the CSS float side. | |
| virtual void | setClearSides (WFlags< Side > sides) override |
| Sets the sides that should be cleared of floats. | |
| virtual WFlags< Side > | clearSides () const override |
| Returns the sides that should remain empty. | |
| virtual void | setMargin (const WLength &margin, WFlags< Side > sides=AllSides) override |
| Sets CSS margins around the widget. | |
| virtual WLength | margin (Side side) const override |
| Returns a CSS margin set. | |
| virtual void | setHiddenKeepsGeometry (bool enabled) override |
| Sets whether the widget keeps its geometry when hidden. | |
| virtual bool | hiddenKeepsGeometry () const override |
| Returns whether the widget keeps its geometry when hidden. | |
| virtual void | setHidden (bool hidden, const WAnimation &animation=WAnimation()) override |
| Hides or shows the widget. | |
| virtual bool | isHidden () const override |
| Returns whether the widget is set hidden. | |
| virtual bool | isVisible () const override |
| Returns whether the widget is visible. | |
| virtual void | setDisabled (bool disabled) override |
| Sets whether the widget is disabled. | |
| virtual bool | isDisabled () const override |
| Returns whether the widget is set disabled. | |
| virtual bool | isEnabled () const override |
| Returns whether the widget is enabled. | |
| virtual void | setPopup (bool popup) override |
| Lets the widget overlay over other sibling widgets. | |
| virtual bool | isPopup () const override |
| Returns whether the widget is overlayed. | |
| virtual void | setInline (bool isInline) override |
| Sets whether the widget is displayed inline or as a block. | |
| virtual bool | isInline () const override |
| Returns whether the widget is displayed inline or as block. | |
| virtual void | setDecorationStyle (const WCssDecorationStyle &style) override |
| Sets a CSS decoration style. | |
| virtual WCssDecorationStyle & | decorationStyle () override |
| Returns the decoration style of this widget. | |
| virtual void | setStyleClass (const WString &styleClass) override |
| Sets (one or more) CSS style classes. | |
| virtual WString | styleClass () const override |
| Returns the CSS style class. | |
| virtual void | addStyleClass (const WString &styleClass, bool force=false) override |
| Adds a CSS style class. | |
| virtual void | removeStyleClass (const WString &styleClass, bool force=false) override |
| Removes a CSS style class. | |
| virtual bool | hasStyleClass (const WString &styleClass) const override |
| Returns whether the widget has a style class. | |
| virtual void | setVerticalAlignment (AlignmentFlag alignment, const WLength &length=WLength::Auto) override |
| Sets the vertical alignment. | |
| virtual AlignmentFlag | verticalAlignment () const override |
| Returns the vertical alignment. | |
| virtual WLength | verticalAlignmentLength () const override |
| Returns the fixed vertical alignment that was set. | |
| virtual void | setToolTip (const WString &text, TextFormat textFormat=TextFormat::Plain) override |
| Sets a tooltip. | |
| virtual WString | toolTip () const override |
| Returns the tooltip. | |
| virtual void | setDeferredToolTip (bool enable, TextFormat textFormat=TextFormat::Plain) override |
| Enable deferred tooltip. | |
| virtual void | refresh () override |
| Refresh the widget. | |
| virtual void | setAttributeValue (const std::string &name, const WString &value) override |
| Sets an attribute value. | |
| virtual WString | attributeValue (const std::string &name) const override |
| Returns an attribute value. | |
| virtual void | setJavaScriptMember (const std::string &name, const std::string &value) override |
| Sets a JavaScript member. | |
| virtual std::string | javaScriptMember (const std::string &name) const override |
| Returns the value of a JavaScript member. | |
| virtual void | callJavaScriptMember (const std::string &name, const std::string &args) override |
| Calls a JavaScript member. | |
| virtual void | load () override |
| Loads content just before the widget is used. | |
| virtual bool | loaded () const override |
| Returns whether this widget has been loaded. | |
| virtual void | setCanReceiveFocus (bool enabled) override |
| Sets whether the widget can receive focus. | |
| virtual bool | canReceiveFocus () const override |
| Returns whether the widget can receive focus. | |
| virtual void | setFocus (bool focus) override |
| Sets focus. | |
| virtual bool | setFirstFocus () override |
| Set focus on the widget's first descendant. | |
| virtual bool | hasFocus () const override |
| Returns whether the widget currently has the focus. | |
| virtual void | setTabIndex (int index) override |
| Sets the tab index. | |
| virtual int | tabIndex () const override |
| Returns the tab index. | |
| virtual void | setId (const std::string &id) override |
| Sets the CSS Id. | |
| virtual WWidget * | find (const std::string &name) override |
| Finds a descendent widget by name. | |
| virtual WWidget * | findById (const std::string &name) override |
| Finds a descendent widget by id. | |
| virtual void | setSelectable (bool selectable) override |
| Sets as selectable. | |
| virtual void | doJavaScript (const std::string &js) override |
| Executes the given JavaScript statements when the widget is rendered or updated. | |
| virtual void | propagateSetEnabled (bool enabled) override |
| Propagates that a widget was enabled or disabled through children. | |
| virtual bool | scrollVisibilityEnabled () const final override |
| Returns whether scroll visibility detection is enabled for this widget. | |
| virtual void | setScrollVisibilityEnabled (bool enabled) final override |
| Sets whether scroll visibility detection is enabled for this widget. | |
| virtual int | scrollVisibilityMargin () const final override |
| Returns the margin around the viewport within which the widget is considered visible. | |
| virtual void | setScrollVisibilityMargin (int margin) final override |
| Sets the margin around the viewport within which the widget is considered visible. | |
| virtual Signal< bool > & | scrollVisibilityChanged () final override |
| Signal triggered when the scroll visibility of this widget changes. | |
| virtual bool | isScrollVisible () const final override |
| Returns whether this widget is currently considered scroll visible. | |
| virtual void | setThemeStyleEnabled (bool enabled) final override |
| Sets whether theme styling for a widget is enabled or disabled. | |
| virtual bool | isThemeStyleEnabled () const final override |
| Returns whether this widget is currently styled by the chosen theme. | |
| virtual std::unique_ptr< WWidget > | removeWidget (WWidget *widget) |
| Removes a child widget. | |
| template<typename Widget > | |
| std::unique_ptr< Widget > | removeWidget (Widget *widget) |
| Removes a child widget. | |
| void | setFocus () |
| Sets focus. | |
| virtual void | setFocus (bool focus)=0 |
| Sets focus. | |
Public Member Functions inherited from Wt::WWidget | |
| virtual | ~WWidget () |
| Destructor. | |
| WWidget * | parent () const |
| Returns the parent widget. | |
| virtual std::vector< WWidget * > | children () const =0 |
| Returns child widgets. | |
| virtual std::unique_ptr< WWidget > | removeWidget (WWidget *widget) |
| Removes a child widget. | |
| template<typename Widget > | |
| std::unique_ptr< Widget > | removeWidget (Widget *widget) |
| Removes a child widget. | |
| std::unique_ptr< WWidget > | removeFromParent () |
| Removes the widget from its parent. | |
| virtual void | setPositionScheme (PositionScheme scheme)=0 |
| Sets the CSS position scheme. | |
| virtual PositionScheme | positionScheme () const =0 |
| Returns the CSS position scheme. | |
| virtual void | setOffsets (const WLength &offset, WFlags< Side > sides=AllSides)=0 |
| Sets CSS offsets for a non-statically positioned widget. | |
| virtual WLength | offset (Side side) const =0 |
| Returns a CSS offset. | |
| virtual void | resize (const WLength &width, const WLength &height) |
| Resizes the widget. | |
| virtual WLength | width () const =0 |
| Returns the width. | |
| void | setWidth (const WLength &width) |
| Sets the width. | |
| virtual WLength | height () const =0 |
| Returns the height. | |
| void | setHeight (const WLength &height) |
| Sets the height. | |
| virtual void | setMinimumSize (const WLength &width, const WLength &height)=0 |
| Sets a minimum size. | |
| virtual WLength | minimumWidth () const =0 |
| Returns the minimum width. | |
| virtual WLength | minimumHeight () const =0 |
| Returns the minimum height. | |
| virtual void | setMaximumSize (const WLength &width, const WLength &height)=0 |
| Sets a maximum size. | |
| virtual WLength | maximumWidth () const =0 |
| Returns the maximum width. | |
| virtual WLength | maximumHeight () const =0 |
| Returns the maximum height. | |
| virtual void | positionAt (const WWidget *widget, Orientation orientation=Orientation::Vertical) |
| Positions a widget next to another widget. | |
| virtual void | setLineHeight (const WLength &height)=0 |
| Sets the CSS line height for contained text. | |
| virtual WLength | lineHeight () const =0 |
| Returns the CSS line height for contained text. | |
| virtual void | setFloatSide (Side s)=0 |
| Specifies a CSS float side. | |
| virtual Side | floatSide () const =0 |
| Returns the CSS float side. | |
| virtual void | setClearSides (WFlags< Side > sides)=0 |
| Sets the sides that should be cleared of floats. | |
| virtual WFlags< Side > | clearSides () const =0 |
| Returns the sides that should remain empty. | |
| virtual void | setMargin (const WLength &margin, WFlags< Side > sides=AllSides)=0 |
| Sets CSS margins around the widget. | |
| virtual WLength | margin (Side side) const =0 |
| Returns a CSS margin set. | |
| virtual void | setHiddenKeepsGeometry (bool enabled)=0 |
| Sets whether the widget keeps its geometry when hidden. | |
| virtual bool | hiddenKeepsGeometry () const =0 |
| Returns whether the widget keeps its geometry when hidden. | |
| virtual void | setHidden (bool hidden, const WAnimation &animation=WAnimation())=0 |
| Hides or shows the widget. | |
| virtual bool | isHidden () const =0 |
| Returns whether the widget is set hidden. | |
| virtual bool | isVisible () const =0 |
| Returns whether the widget is visible. | |
| virtual void | setDisabled (bool disabled)=0 |
| Sets whether the widget is disabled. | |
| virtual bool | isDisabled () const =0 |
| Returns whether the widget is set disabled. | |
| virtual bool | isEnabled () const =0 |
| Returns whether the widget is enabled. | |
| virtual void | setPopup (bool popup)=0 |
| Lets the widget overlay over other sibling widgets. | |
| virtual bool | isPopup () const =0 |
| Returns whether the widget is overlayed. | |
| virtual void | setInline (bool inlined)=0 |
| Sets whether the widget is displayed inline or as a block. | |
| virtual bool | isInline () const =0 |
| Returns whether the widget is displayed inline or as block. | |
| virtual void | setDecorationStyle (const WCssDecorationStyle &style)=0 |
| Sets a CSS decoration style. | |
| virtual WCssDecorationStyle & | decorationStyle ()=0 |
| Returns the decoration style of this widget. | |
| virtual void | setStyleClass (const WString &styleClass)=0 |
| Sets (one or more) CSS style classes. | |
| virtual WString | styleClass () const =0 |
| Returns the CSS style class. | |
| virtual void | addStyleClass (const WString &styleClass, bool force=false)=0 |
| Adds a CSS style class. | |
| virtual void | removeStyleClass (const WString &styleClass, bool force=false)=0 |
| Removes a CSS style class. | |
| virtual void | toggleStyleClass (const WString &styleClass, bool add, bool force=false) |
| Toggles a CSS style class. | |
| virtual bool | hasStyleClass (const WString &styleClass) const =0 |
| Returns whether the widget has a style class. | |
| virtual void | setVerticalAlignment (AlignmentFlag alignment, const WLength &length=WLength::Auto)=0 |
| Sets the vertical alignment. | |
| virtual AlignmentFlag | verticalAlignment () const =0 |
| Returns the vertical alignment. | |
| virtual WLength | verticalAlignmentLength () const =0 |
| Returns the fixed vertical alignment that was set. | |
| virtual void | setToolTip (const WString &text, TextFormat textFormat=TextFormat::Plain)=0 |
| Sets a tooltip. | |
| virtual WString | toolTip () const =0 |
| Returns the tooltip. | |
| virtual void | setDeferredToolTip (bool enable, TextFormat textFormat=TextFormat::Plain)=0 |
| Enable deferred tooltip. | |
| virtual void | refresh () |
| Refresh the widget. | |
| std::string | jsRef () const |
| Returns a JavaScript expression to the corresponding DOM node. | |
| virtual void | setAttributeValue (const std::string &name, const WString &value)=0 |
| Sets an attribute value. | |
| virtual WString | attributeValue (const std::string &name) const =0 |
| Returns an attribute value. | |
| virtual void | setJavaScriptMember (const std::string &name, const std::string &value)=0 |
| Sets a JavaScript member. | |
| virtual std::string | javaScriptMember (const std::string &name) const =0 |
| Returns the value of a JavaScript member. | |
| virtual void | callJavaScriptMember (const std::string &name, const std::string &args)=0 |
| Calls a JavaScript member. | |
| virtual void | load ()=0 |
| Loads content just before the widget is used. | |
| virtual bool | loaded () const =0 |
| Returns whether this widget has been loaded. | |
| virtual void | setCanReceiveFocus (bool enabled)=0 |
| Sets whether the widget can receive focus. | |
| virtual bool | canReceiveFocus () const =0 |
| Returns whether the widget can receive focus. | |
| void | setFocus () |
| Sets focus. | |
| virtual void | setFocus (bool focus)=0 |
| Sets focus. | |
| virtual bool | setFirstFocus ()=0 |
| Set focus on the widget's first descendant. | |
| virtual bool | hasFocus () const =0 |
| Returns whether the widget currently has the focus. | |
| virtual void | setTabIndex (int index)=0 |
| Sets the tab index. | |
| virtual int | tabIndex () const =0 |
| Returns the tab index. | |
| virtual void | acceptDrops (const std::string &mimeType, const WString &hoverStyleClass=WString()) |
| Sets a mime type to be accepted for dropping. | |
| virtual void | stopAcceptDrops (const std::string &mimeType) |
| Indicates that a mime type is no longer accepted for dropping. | |
| virtual void | setId (const std::string &id)=0 |
| Sets the CSS Id. | |
| virtual WWidget * | find (const std::string &name)=0 |
| Finds a descendent widget by name. | |
| virtual WWidget * | findById (const std::string &id)=0 |
| Finds a descendent widget by id. | |
| virtual void | htmlText (std::ostream &out) |
| Streams the (X)HTML representation. | |
| virtual void | setSelectable (bool selectable)=0 |
| Sets as selectable. | |
| virtual void | doJavaScript (const std::string &js)=0 |
| Executes the given JavaScript statements when the widget is rendered or updated. | |
| bool | isRendered () const |
| Returns whether the widget is rendered. | |
| void | hide () |
| Hides the widget. | |
| void | animateHide (const WAnimation &animation) |
| Hides the widget using an animation. | |
| void | show () |
| Shows the widget. | |
| void | animateShow (const WAnimation &animation) |
| Shows the widget using an animation. | |
| void | enable () |
| Enables the widget. | |
| void | disable () |
| Disable thes widget. | |
| bool | layoutSizeAware () const |
| Returns whether the widget is layout size aware. | |
| virtual bool | scrollVisibilityEnabled () const =0 |
| Returns whether scroll visibility detection is enabled for this widget. | |
| virtual void | setScrollVisibilityEnabled (bool enabled)=0 |
| Sets whether scroll visibility detection is enabled for this widget. | |
| virtual int | scrollVisibilityMargin () const =0 |
| Returns the margin around the viewport within which the widget is considered visible. | |
| virtual void | setScrollVisibilityMargin (int margin)=0 |
| Sets the margin around the viewport within which the widget is considered visible. | |
| virtual Signal< bool > & | scrollVisibilityChanged ()=0 |
| Signal triggered when the scroll visibility of this widget changes. | |
| virtual bool | isScrollVisible () const =0 |
| Returns whether this widget is currently considered scroll visible. | |
| virtual void | setThemeStyleEnabled (bool enabled)=0 |
| Sets whether theme styling for a widget is enabled or disabled. | |
| virtual bool | isThemeStyleEnabled () const =0 |
| Returns whether this widget is currently styled by the chosen theme. | |
Public Member Functions inherited from Wt::WObject | |
| void | addChild (std::unique_ptr< WObject > child) |
| Add a child WObject whose lifetime is determined by this WObject. | |
| template<typename Child > | |
| Child * | addChild (std::unique_ptr< Child > child) |
| Add a child WObject, returning a raw pointer. | |
| std::unique_ptr< WObject > | removeChild (WObject *child) |
| Remove a child WObject, so its lifetime is no longer determined by this WObject. | |
| template<typename Child > | |
| std::unique_ptr< Child > | removeChild (Child *child) |
| Remove a child WObject, so its lifetime is no longer determined by this WObject. | |
| virtual const std::string | id () const |
| Returns the (unique) identifier for this object. | |
| virtual void | setObjectName (const std::string &name) |
| Sets an object name. | |
| virtual std::string | objectName () const |
| Returns the object name. | |
| void | resetLearnedSlots () |
| Resets learned stateless slot implementations. | |
| template<class T > | |
| void | resetLearnedSlot (void(T::*method)()) |
| Resets a learned stateless slot implementation. | |
| template<class T > | |
| WStatelessSlot * | implementStateless (void(T::*method)()) |
| Declares a slot to be stateless and learn client-side behaviour on first invocation. | |
| template<class T > | |
| WStatelessSlot * | implementStateless (void(T::*method)(), void(T::*undoMethod)()) |
| Declares a slot to be stateless and learn client-side behaviour in advance. | |
| void | isNotStateless () |
| Marks the current function as not stateless. | |
| template<class T > | |
| WStatelessSlot * | implementJavaScript (void(T::*method)(), const std::string &jsCode) |
| Provides a JavaScript implementation for a method. | |
Public Member Functions inherited from Wt::Core::observable | |
| observable () noexcept | |
| Default constructor. | |
| virtual | ~observable () |
| Destructor. | |
| template<typename... Args, typename C > | |
| auto | bindSafe (void(C::*method)(Args...)) noexcept |
| Protects a method call against object destruction. | |
| template<typename... Args, typename C > | |
| auto | bindSafe (void(C::*method)(Args...) const) const noexcept |
| Protects a const method call against object destruction. | |
| template<typename Function > | |
| auto | bindSafe (const Function &function) noexcept |
| Protects a function against object destruction. | |
Additional Inherited Members | |
Public Types inherited from Wt::WObject | |
| typedef void(WObject::* | Method) () |
| Typedef for a WObject method without arguments. | |
Static Public Member Functions inherited from Wt::WWidget | |
| static WString | tr (const char *key) |
| Short hand for WString::tr() | |
Protected Member Functions inherited from Wt::WCompositeWidget | |
| virtual void | enableAjax () override |
| Progresses to an Ajax-enabled widget. | |
| void | setImplementation (std::unique_ptr< WWidget > widget) |
| Set the implementation widget. | |
| template<typename Widget > | |
| Widget * | setImplementation (std::unique_ptr< Widget > widget) |
| Sets the implementation widget, returning a raw pointer. | |
| template<typename W , typename... Args> | |
| W * | setNewImplementation (Args &&... args) |
| Creates the implementation widget and sets it, returning a raw pointer. | |
| WWidget * | implementation () |
| Get the implementation widget. | |
| virtual int | boxPadding (Orientation orientation) const override |
| Returns the widget's built-in padding. | |
| virtual int | boxBorder (Orientation orientation) const override |
| Returns the widget's built-in border width. | |
| virtual void | render (WFlags< RenderFlag > flags) override |
| Renders the widget. | |
Protected Member Functions inherited from Wt::WWidget | |
| void | setLayoutSizeAware (bool sizeAware) |
| Sets the widget to be aware of its size set by a layout manager. | |
| virtual void | layoutSizeChanged (int width, int height) |
| Virtual method that indicates a size change. | |
| WWidget () | |
| Creates a widget. | |
| virtual void | dropEvent (WDropEvent dropEvent) |
| Handles a drop event. | |
| virtual void | enableAjax ()=0 |
| Progresses to an Ajax-enabled widget. | |
| virtual int | boxPadding (Orientation orientation) const |
| Returns the widget's built-in padding. | |
| virtual int | boxBorder (Orientation orientation) const |
| Returns the widget's built-in border width. | |
| virtual void | propagateSetEnabled (bool enabled)=0 |
| Propagates that a widget was enabled or disabled through children. | |
| void | scheduleRender (WFlags< RepaintFlag > flags=None) |
| Schedules rerendering of the widget. | |
| virtual void | render (WFlags< RenderFlag > flags) |
| Renders the widget. | |
| virtual WStatelessSlot * | getStateless (Method method) override |
| On-demand stateless slot implementation. | |
| virtual WStatelessSlot * | getStateless (Method method) |
| On-demand stateless slot implementation. | |
A split button.
A split button combines a button and a drop down menu. Typically, the button represents an action, with related alternative actions accessible from the drop down menu.
| WPushButton * Wt::WSplitButton::actionButton | ( | ) | const |
Returns the action button.
This is the button that represents the main action.
| WPushButton * Wt::WSplitButton::dropDownButton | ( | ) | const |
Returns the drop down button.
This represents the button that represents the drop-down action.