Class: Gtk::LinkButton
- Extended by:
- GLib::Deprecatable
- Defined in:
- lib/gtk3/deprecated.rb
Overview
A GtkLinkButton is a button with a hyperlink.
It is useful to show quick links to resources.
A link button is created by calling either [ctorGtk.LinkButton.new] or [ctorGtk.LinkButton.new_with_label]. If using the former, the URI you pass to the constructor is used as a label for the widget.
The URI bound to a GtkLinkButton can be set specifically using
[methodGtk.LinkButton.set_uri].
By default, GtkLinkButton calls [methodGtk.FileLauncher.launch] when the button
is clicked. This behaviour can be overridden by connecting to the
[signalGtk.LinkButton::activate-link] signal and returning true from
the signal handler.
CSS nodes
GtkLinkButton has a single CSS node with name button. To differentiate
it from a plain GtkButton, it gets the .link style class.
Accessibility
GtkLinkButton uses the %GTK_ACCESSIBLE_ROLE_LINK role.
Instance Method Summary collapse
-
#initialize(uri, label) ⇒ Gtk::Widget
constructor
Creates a new
GtkLinkButtoncontaining a label. -
#uri ⇒ String
The URI bound to this button.
-
#uri=(uri) ⇒ String
The URI bound to this button.
-
#visited ⇒ Boolean
Retrieves the “visited” state of the
GtkLinkButton. -
#visited=(visited) ⇒ Boolean
The 'visited' state of this button.
-
#visited? ⇒ Boolean
The 'visited' state of this button.
Methods inherited from Button
#can_shrink, #can_shrink=, #can_shrink?, #child, #child=, #has_frame, #has_frame=, #has_frame?, #icon_name, #icon_name=, #initialize_raw, #label, #label=, #use_underline, #use_underline=, #use_underline?
Methods inherited from Widget
#accessible_role, #accessible_role=, #action_set_enabled, #activate, #activate_action, #activate_action_variant, #activate_default, #activate_signal, #activate_signal=, #activate_signal_from_name=, #add_binding, #add_binding_action, #add_binding_signal, #add_controller, #add_css_class, #add_events, #add_events_raw, #add_mnemonic_label, #add_shortcut, #add_tick_callback, #allocate, #allocated_baseline, #allocated_height, #allocated_width, #baseline, #bind_template_callback_full, #bind_template_child, #bind_template_child_full, #can_focus, #can_focus=, #can_focus?, #can_target, #can_target=, #can_target?, #child_focus, #child_visible, #child_visible=, #clipboard, #compute_bounds, #compute_expand, #compute_point, #compute_transform, #contains, #create_pango_context, #create_pango_layout, #css_classes, #css_classes=, #css_name, #css_name=, #cursor, #cursor=, #cursor_from_name=, default_direction, default_direction=, #direction, #direction=, #display, #dispose_template, #drag_check_threshold, #drag_dest_set, #drag_dest_set_raw, #drag_source_set, #drag_source_set_raw, #error_bell, #events, #events_raw, #first_child, #focus_child, #focus_child=, #focus_on_click, #focus_on_click=, #focus_on_click?, #focusable, #focusable=, #focusable?, #font_map, #font_map=, #font_options, #font_options=, #frame_clock, #get_allocation, #get_ancestor, #get_color, #get_preferred_size, #get_size, #get_size_request, #get_template_child, #grab_focus, #halign, #halign=, #has_css_class, #has_default, #has_default=, #has_default?, #has_focus, #has_focus=, #has_focus?, #has_tooltip, #has_tooltip=, #has_tooltip?, #has_visible_focus, have_template?, #height, #height_request, #height_request=, #hexpand, #hexpand=, #hexpand?, #hexpand_set, #hexpand_set=, #hexpand_set?, #hide, #in_destruction, #init_template, #insert_action_group, #insert_action_group_raw, #insert_after, #insert_before, #install_action, #install_property_action, #is_ancestor, #is_drawable, #is_focus, #is_sensitive, #is_visible, #keynav_failed, #last_child, #layout_manager, #layout_manager=, #layout_manager_type, #layout_manager_type=, #list_mnemonic_labels, #map, #mapped, #margin_bottom, #margin_bottom=, #margin_end, #margin_end=, #margin_start, #margin_start=, #margin_top, #margin_top=, #measure, #mnemonic_activate, #name, #name=, #native, #next_sibling, #observe_children, #observe_controllers, #opacity, #opacity=, #overflow, #overflow=, #pango_context, #parent, #parent=, #pick, #prev_sibling, #primary_clipboard, #query_action, #queue_allocate, #queue_draw, #queue_resize, #realize, #realized, #receives_default, #receives_default=, #receives_default?, #remove_controller, #remove_css_class, #remove_mnemonic_label, #remove_tick_callback, #render_icon_pixbuf, #render_icon_pixbuf_raw, #request_mode, #root, #root=, #scale_factor, #scale_factor=, #sensitive, #sensitive=, #sensitive?, #set_allocation, set_connect_func, set_connect_func_raw, #set_events, #set_events_raw, #set_size_request, #set_size_request_raw, #set_state_flags, #set_template, #set_template_raw, #settings, #should_layout, #show, #size_allocate, #snapshot_child, #state_flags, #style_context, #style_context_raw, #style_get_property, #style_get_property_raw, #template=, template_children, #template_from_resource=, #template_scope=, #tooltip_markup, #tooltip_markup=, #tooltip_text, #tooltip_text=, #translate_coordinates, #translate_coordinates_raw, #trigger_tooltip_query, #unmap, #unparent, #unrealize, #unset_state_flags, #valign, #valign=, #vexpand, #vexpand=, #vexpand?, #vexpand_set, #vexpand_set=, #vexpand_set?, #visible, #visible=, #visible?, #width, #width_request, #width_request=
Constructor Details
#initialize(uri, label) ⇒ Gtk::Widget
Creates a new GtkLinkButton containing a label.
Instance Method Details
#uri ⇒ String
The URI bound to this button.
#uri=(uri) ⇒ String
The URI bound to this button.
#visited ⇒ Boolean
Retrieves the “visited” state of the GtkLinkButton.
The button becomes visited when it is clicked. If the URI is changed on the button, the “visited” state is unset again.
The state may also be changed using [methodGtk.LinkButton.set_visited].
#visited=(visited) ⇒ Boolean
The 'visited' state of this button.
A visited link is drawn in a different color.
#visited? ⇒ Boolean
The 'visited' state of this button.
A visited link is drawn in a different color.