![]() |
![]() |
This widget is generally used with a signal handler that is called when the button is pressed. It can hold any valid child widget. The most commonly used child is the Gtk::Label.
Public Member Functions | |
virtual | ~Button () |
GtkButton* | gobj () |
Provides access to the underlying C GtkObject. | |
const GtkButton* | gobj () const |
Provides access to the underlying C GtkObject. | |
Button () | |
Create an empty button. | |
Button (const Glib::ustring& label, bool mnemonic=false) | |
Simple Push Button with label. | |
Button (const StockID& stock_id) | |
void | pressed () |
void | released () |
void | clicked () |
void | enter () |
void | leave () |
void | set_relief (ReliefStyle newstyle) |
ReliefStyle | get_relief () const |
void | set_label (const Glib::ustring& label) |
Sets the text of the label of the button to str . | |
Glib::ustring | get_label () const |
Fetches the text from the label of the button, as set by set_label(). | |
void | set_use_underline (bool use_underline=true) |
If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key. | |
bool | get_use_underline () const |
Returns whether an embedded underline in the button label indicates a mnemonic. | |
void | set_use_stock (bool use_stock=true) |
If true, the label set on the button is used as a stock id to select the stock item for the button. | |
bool | get_use_stock () const |
Returns whether the button label is a stock item. | |
void | set_focus_on_click (bool focus_on_click=true) |
Sets whether the button will grab focus when it is clicked with the mouse. | |
bool | get_focus_on_click () const |
Returns whether the button grabs focus when it is clicked with the mouse. | |
void | set_alignment (float xalign, float yalign) |
Sets the alignment of the child. | |
void | get_alignment (float& xalign, float& yalign) |
Gets the alignment of the child in the button. | |
void | set_image (Widget& image) |
Set the image of button to the given widget. | |
Widget* | get_image () |
Gets the widget that is currenty set as the image of button . | |
const Widget* | get_image () const |
Gets the widget that is currenty set as the image of button . | |
Glib::SignalProxy0<void> | signal_pressed () |
Glib::SignalProxy0<void> | signal_released () |
Glib::SignalProxy0<void> | signal_clicked () |
Glib::SignalProxy0<void> | signal_enter () |
Glib::SignalProxy0<void> | signal_leave () |
Glib::SignalProxy0<void> | signal_activate () |
Glib::PropertyProxy<Glib::ustring> | property_label () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_label () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<ReliefStyle> | property_relief () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< ReliefStyle > | property_relief () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<bool> | property_use_underline () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< bool > | property_use_underline () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<bool> | property_use_stock () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< bool > | property_use_stock () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<bool> | property_focus_on_click () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< bool > | property_focus_on_click () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<float> | property_xalign () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< float > | property_xalign () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<float> | property_yalign () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< float > | property_yalign () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy<Gtk::Widget*> | property_image () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly< Gtk::Widget* > | property_image () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Protected Member Functions | |
virtual void | on_pressed () |
virtual void | on_released () |
virtual void | on_clicked () |
virtual void | on_enter () |
virtual void | on_leave () |
virtual void | on_activate () |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::Button* | wrap (GtkButton* object, bool take_copy=false) |
|
|
|
Create an empty button. With an empty button, you can Gtk::Button::add() a widget such as a Gtk::Pixmap or Gtk::Box. If you just wish to add a Gtk::Label, you may want to use the Gtk::Button(const Glib::ustring& label) ctor directly instead. |
|
Simple Push Button with label. Create a button with the given label inside. You won't be able to add a widget in this button since it already has a Gtk::Label in it |
|
|
|
|
|
|
|
Gets the alignment of the child in the button. Since: 2.4
|
|
Returns whether the button grabs focus when it is clicked with the mouse. See set_focus_on_click().
|
|
Gets the widget that is currenty set as the image of button . This may have been explicitly set by set_image() or constructed by new_from_stock(). Since: 2.6 |
|
Gets the widget that is currenty set as the image of button . This may have been explicitly set by set_image() or constructed by new_from_stock(). Since: 2.6 |
|
Fetches the text from the label of the button, as set by set_label().
If the label text has not been set the return value will be
|
|
|
|
Returns whether the button label is a stock item.
|
|
Returns whether an embedded underline in the button label indicates a mnemonic. See set_use_underline().
|
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Bin. Reimplemented in Gtk::CheckButton, Gtk::ColorButton, Gtk::FontButton, Gtk::OptionMenu, Gtk::RadioButton, and Gtk::ToggleButton. |
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Bin. Reimplemented in Gtk::CheckButton, Gtk::ColorButton, Gtk::FontButton, Gtk::OptionMenu, Gtk::RadioButton, and Gtk::ToggleButton. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
|
|
Sets the alignment of the child. This property has no effect unless the child is a Gtk::Misc or a Gtk::Aligment. Since: 2.4
|
|
Sets whether the button will grab focus when it is clicked with the mouse. Making mouse clicks not grab focus is useful in places like toolbars where you don't want the keyboard focus removed from the main area of the application. Since: 2.4
|
|
Set the image of button to the given widget. Note that it depends on the show-button-images setting whether the image will be displayed or not. Since: 2.6
|
|
Sets the text of the label of the button to str . This text is also used to select the stock item if set_use_stock() is used. This will also clear any previously set labels.
|
|
|
|
If true, the label set on the button is used as a stock id to select the stock item for the button.
|
|
If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|