[−][src]Trait gtk::prelude::ButtonExt
Trait containing all Button
methods.
Implementors
Button
, ColorButton
, FontButton
, LinkButton
, LockButton
, ModelButton
, ScaleButton
, ToggleButton
Required methods
fn clicked(&self)
Emits a Button::clicked
signal to the given Button
.
fn get_always_show_image(&self) -> bool
Returns whether the button will ignore the Settings:gtk-button-images
setting and always show the image, if available.
Returns
true
if the button will always show the image
fn get_event_window(&self) -> Option<Window>
Returns the button’s event window if it is realized, None
otherwise.
This function should be rarely needed.
Returns
self
’s event window.
fn get_focus_on_click(&self) -> bool
Returns whether the button grabs focus when it is clicked with the mouse.
See ButtonExt::set_focus_on_click
.
Deprecated since 3.20
Use WidgetExt::get_focus_on_click
instead
Returns
true
if the button grabs focus when it is clicked with
the mouse.
fn get_image(&self) -> Option<Widget>
Gets the widget that is currenty set as the image of self
.
This may have been explicitly set by ButtonExt::set_image
or constructed by Button::new_from_stock
.
Returns
a Widget
or None
in case
there is no image
fn get_image_position(&self) -> PositionType
fn get_label(&self) -> Option<GString>
Fetches the text from the label of the button, as set by
ButtonExt::set_label
. If the label text has not
been set the return value will be None
. This will be the
case if you create an empty button with Button::new
to
use as a container.
Returns
The text of the label widget. This string is owned by the widget and must not be modified or freed.
fn get_relief(&self) -> ReliefStyle
fn get_use_underline(&self) -> bool
Returns whether an embedded underline in the button label indicates a mnemonic. See gtk_button_set_use_underline ().
Returns
true
if an embedded underline in the button label
indicates the mnemonic accelerator keys.
fn set_always_show_image(&self, always_show: bool)
If true
, the button will ignore the Settings:gtk-button-images
setting and always show the image, if available.
Use this property if the button would be useless or hard to use without the image.
always_show
true
if the menuitem should always show the image
fn set_focus_on_click(&self, focus_on_click: bool)
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.
Deprecated since 3.20
Use WidgetExt::set_focus_on_click
instead
focus_on_click
whether the button grabs focus when clicked with the mouse
fn set_image<P: IsA<Widget>>(&self, image: Option<&P>)
Set the image of self
to the given widget. The image will be
displayed if the label text is None
or if
Button:always-show-image
is true
. You don’t have to call
WidgetExt::show
on image
yourself.
image
a widget to set as the image for the button, or None
to unset
fn set_image_position(&self, position: PositionType)
fn set_label(&self, label: &str)
Sets the text of the label of the button to str
. This text is
also used to select the stock item if Button::set_use_stock
is used.
This will also clear any previously set labels.
label
a string
fn set_relief(&self, relief: ReliefStyle)
Sets the relief style of the edges of the given Button
widget.
Two styles exist, ReliefStyle::Normal
and ReliefStyle::None
.
The default style is, as one can guess, ReliefStyle::Normal
.
The deprecated value ReliefStyle::Half
behaves the same as
ReliefStyle::Normal
.
relief
The ReliefStyle
as described above
fn set_use_underline(&self, use_underline: bool)
If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key.
use_underline
true
if underlines in the text indicate mnemonics
fn connect_activate<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
The ::activate signal on Button
is an action signal and
emitting it causes the button to animate press then release.
Applications should never connect to this signal, but use the
Button::clicked
signal.
fn emit_activate(&self)
fn connect_clicked<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
Emitted when the button has been activated (pressed and released).
fn emit_clicked(&self)
fn connect_property_always_show_image_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
&self,
f: F
) -> SignalHandlerId
fn connect_property_image_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
&self,
f: F
) -> SignalHandlerId
fn connect_property_image_position_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
&self,
f: F
) -> SignalHandlerId
fn connect_property_label_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
&self,
f: F
) -> SignalHandlerId
fn connect_property_relief_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
&self,
f: F
) -> SignalHandlerId
fn connect_property_use_underline_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
&self,
f: F
) -> SignalHandlerId
Implementors
impl<O: IsA<Button>> ButtonExt for O
[src]
fn clicked(&self)
[src]
fn get_always_show_image(&self) -> bool
[src]
fn get_event_window(&self) -> Option<Window>
[src]
fn get_focus_on_click(&self) -> bool
[src]
fn get_image(&self) -> Option<Widget>
[src]
fn get_image_position(&self) -> PositionType
[src]
fn get_label(&self) -> Option<GString>
[src]
fn get_relief(&self) -> ReliefStyle
[src]
fn get_use_underline(&self) -> bool
[src]
fn set_always_show_image(&self, always_show: bool)
[src]
fn set_focus_on_click(&self, focus_on_click: bool)
[src]
fn set_image<P: IsA<Widget>>(&self, image: Option<&P>)
[src]
fn set_image_position(&self, position: PositionType)
[src]
fn set_label(&self, label: &str)
[src]
fn set_relief(&self, relief: ReliefStyle)
[src]
fn set_use_underline(&self, use_underline: bool)
[src]
fn connect_activate<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
[src]
fn emit_activate(&self)
[src]
fn connect_clicked<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
[src]
fn emit_clicked(&self)
[src]
fn connect_property_always_show_image_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
[src]
&self,
f: F
) -> SignalHandlerId
fn connect_property_image_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
[src]
&self,
f: F
) -> SignalHandlerId
fn connect_property_image_position_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
[src]
&self,
f: F
) -> SignalHandlerId
fn connect_property_label_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
[src]
&self,
f: F
) -> SignalHandlerId
fn connect_property_relief_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
[src]
&self,
f: F
) -> SignalHandlerId
fn connect_property_use_underline_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
[src]
&self,
f: F
) -> SignalHandlerId