Class: Gtk::Grid

Inherits:
Widget
  • Object
show all
Defined in:
(unknown)

Instance Method Summary collapse

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

#initializeGtk::Widget

Creates a new grid widget.

Instance Method Details

#attach(child, column, row, width, height) ⇒ nil

Adds a widget to the grid.

The position of child is determined by column and row. The number of “cells” that child will occupy is determined by width and height.

Parameters:

  • child (Gtk::Widget)

    the widget to add

  • column (Integer)

    the column number to attach the left side of child to

  • row (Integer)

    the row number to attach the top side of child to

  • width (Integer)

    the number of columns that child will span

  • height (Integer)

    the number of rows that child will span

Returns:

  • (nil)

#attach_next_to(child, sibling, side, width, height) ⇒ nil

Adds a widget to the grid.

The widget is placed next to sibling, on the side determined by side. When sibling is nil, the widget is placed in row (for left or right placement) or column 0 (for top or bottom placement), at the end indicated by side.

Attaching widgets labeled [1], [2], [3] with <b>sibling</b> == nil and <b>side</b> == %GTK_POS_LEFT yields a layout of [3][2][1].

Parameters:

  • child (Gtk::Widget)

    the widget to add

  • sibling (Gtk::Widget)

    the child of grid that child will be placed next to, or nil to place child at the beginning or end

  • side (Gtk::PositionType)

    the side of sibling that child is positioned next to

  • width (Integer)

    the number of columns that child will span

  • height (Integer)

    the number of rows that child will span

Returns:

  • (nil)

#baseline_rowInteger

The row to align to the baseline when valign is using baseline alignment.

Returns:

  • (Integer)

    baseline-row

#baseline_row=(baseline_row) ⇒ Integer

The row to align to the baseline when valign is using baseline alignment.

Parameters:

  • baseline_row (Integer)

Returns:

  • (Integer)

    baseline-row

  • (Integer)

    baseline-row

#column_homogeneousBoolean

Returns whether all columns of grid have the same width.

Returns:

  • (Boolean)

    whether all columns of grid have the same width.

#column_homogeneous=(column_homogeneous) ⇒ Boolean

If true, the columns are all the same width.

Parameters:

  • column_homogeneous (Boolean)

Returns:

  • (Boolean)

    column-homogeneous

  • (Boolean)

    column-homogeneous

#column_homogeneous?Boolean

If true, the columns are all the same width.

Returns:

  • (Boolean)

    column-homogeneous

#column_spacingInteger

The amount of space between two consecutive columns.

Returns:

  • (Integer)

    column-spacing

#column_spacing=(column_spacing) ⇒ Integer

The amount of space between two consecutive columns.

Parameters:

  • column_spacing (Integer)

Returns:

  • (Integer)

    column-spacing

  • (Integer)

    column-spacing

#get_child_at(column, row) ⇒ Gtk::Widget

Gets the child of grid whose area covers the grid cell at column, row.

Parameters:

  • column (Integer)

    the left edge of the cell

  • row (Integer)

    the top edge of the cell

Returns:

#get_row_baseline_position(row) ⇒ Gtk::BaselinePosition

Returns the baseline position of row.

See [methodGtk.Grid.set_row_baseline_position].

Parameters:

  • row (Integer)

    a row index

Returns:

#insert_column(position) ⇒ nil

Inserts a column at the specified position.

Children which are attached at or to the right of this position are moved one column to the right. Children which span across this position are grown to span the new column.

Parameters:

  • position (Integer)

    the position to insert the column at

Returns:

  • (nil)

#insert_next_to(sibling, side) ⇒ nil

Inserts a row or column at the specified position.

The new row or column is placed next to sibling, on the side determined by side. If side is %GTK_POS_TOP or %GTK_POS_BOTTOM, a row is inserted. If side is %GTK_POS_LEFT of %GTK_POS_RIGHT, a column is inserted.

Parameters:

  • sibling (Gtk::Widget)

    the child of grid that the new row or column will be placed next to

  • side (Gtk::PositionType)

    the side of sibling that child is positioned next to

Returns:

  • (nil)

#insert_row(position) ⇒ nil

Inserts a row at the specified position.

Children which are attached at or below this position are moved one row down. Children which span across this position are grown to span the new row.

Parameters:

  • position (Integer)

    the position to insert the row at

Returns:

  • (nil)

#query_child(child, column, row, width, height) ⇒ nil

Queries the attach points and spans of child inside the given GtkGrid.

Parameters:

  • child (Gtk::Widget)

    a GtkWidget child of grid

  • column (Integer)

    the column used to attach the left side of child

  • row (Integer)

    the row used to attach the top side of child

  • width (Integer)

    the number of columns child spans

  • height (Integer)

    the number of rows child spans

Returns:

  • (nil)

#remove(child) ⇒ nil

Removes a child from grid.

The child must have been added with [methodGtk.Grid.attach] or [methodGtk.Grid.attach_next_to].

Parameters:

Returns:

  • (nil)

#remove_column(position) ⇒ nil

Removes a column from the grid.

Children that are placed in this column are removed, spanning children that overlap this column have their width reduced by one, and children after the column are moved to the left.

Parameters:

  • position (Integer)

    the position of the column to remove

Returns:

  • (nil)

#remove_row(position) ⇒ nil

Removes a row from the grid.

Children that are placed in this row are removed, spanning children that overlap this row have their height reduced by one, and children below the row are moved up.

Parameters:

  • position (Integer)

    the position of the row to remove

Returns:

  • (nil)

#row_homogeneousBoolean

Returns whether all rows of grid have the same height.

Returns:

  • (Boolean)

    whether all rows of grid have the same height.

#row_homogeneous=(row_homogeneous) ⇒ Boolean

If true, the rows are all the same height.

Parameters:

  • row_homogeneous (Boolean)

Returns:

  • (Boolean)

    row-homogeneous

  • (Boolean)

    row-homogeneous

#row_homogeneous?Boolean

If true, the rows are all the same height.

Returns:

  • (Boolean)

    row-homogeneous

#row_spacingInteger

The amount of space between two consecutive rows.

Returns:

  • (Integer)

    row-spacing

#row_spacing=(row_spacing) ⇒ Integer

The amount of space between two consecutive rows.

Parameters:

  • row_spacing (Integer)

Returns:

  • (Integer)

    row-spacing

  • (Integer)

    row-spacing

#set_row_baseline_position(row, pos) ⇒ nil

Sets how the baseline should be positioned on row of the grid, in case that row is assigned more space than is requested.

The default baseline position is %GTK_BASELINE_POSITION_CENTER.

Parameters:

Returns:

  • (nil)