2000-10-05 01:04:57 +00:00
|
|
|
/* gtktreeprivate.h
|
|
|
|
* Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford <jrb@redhat.com>
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Library General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Library General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Library General Public
|
|
|
|
* License along with this library; if not, write to the
|
|
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
* Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __GTK_TREE_PRIVATE_H__
|
|
|
|
#define __GTK_TREE_PRIVATE_H__
|
|
|
|
|
|
|
|
|
2005-06-21 05:35:43 +00:00
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
#include <gtk/gtktreeview.h>
|
|
|
|
#include <gtk/gtktreeselection.h>
|
|
|
|
#include <gtk/gtkrbtree.h>
|
2004-04-11 19:15:24 +00:00
|
|
|
|
2001-03-02 00:49:32 +00:00
|
|
|
#define TREE_VIEW_DRAG_WIDTH 6
|
|
|
|
|
Merge from stable.
Mon Aug 25 23:21:43 2003 Kristian Rietveld <kris@gtk.org>
Merge from stable.
Fixes #115871, reported by Michael Natterer.
* gtk/gtktreeprivate.h: added GtkTreeSelectMode enum,
added ctrl_pressed and shift_pressed bitfields,
(_gtk_tree_selection_internal_select_node): replace GdkModifierType
arg with GtkTreeSelectMode.
* gtk/gtktreeselection.c (gtk_tree_selection_set_mode),
(gtk_tree_selection_select_path), (gtk_tree_selection_unselect_path),
(_gtk_tree_selection_internal_select_node): all updated for
GdkModifierType -> GtkTreeSelectMode move.
* gtk/gtktreeview.c (gtk_tree_view_button_press): set ctrl_pressed
and shift_pressed around selection handling block,
(gtk_tree_view_real_select_cursor_row),
(gtk_tree_view_real_toggle_cursor_row),
(gtk_tree_view_real_selection_cursor_parent),
(gtk_tree_view_real_set_cursor): use ctrl_pressed and shift_pressed,
instead of checking the event state. And also updates for the
GdkModifierType -> GtkTreeSelectMode move.
2003-08-25 21:33:00 +00:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
GTK_TREE_SELECT_MODE_TOGGLE = 1 << 0,
|
|
|
|
GTK_TREE_SELECT_MODE_EXTEND = 1 << 1
|
|
|
|
}
|
|
|
|
GtkTreeSelectMode;
|
|
|
|
|
2001-04-23 23:03:53 +00:00
|
|
|
typedef struct _GtkTreeViewColumnReorder GtkTreeViewColumnReorder;
|
|
|
|
struct _GtkTreeViewColumnReorder
|
|
|
|
{
|
|
|
|
gint left_align;
|
|
|
|
gint right_align;
|
|
|
|
GtkTreeViewColumn *left_column;
|
|
|
|
GtkTreeViewColumn *right_column;
|
|
|
|
};
|
|
|
|
|
2000-10-05 01:04:57 +00:00
|
|
|
struct _GtkTreeViewPrivate
|
|
|
|
{
|
|
|
|
GtkTreeModel *model;
|
|
|
|
|
|
|
|
guint flags;
|
|
|
|
/* tree information */
|
|
|
|
GtkRBTree *tree;
|
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Container info */
|
2000-10-05 01:04:57 +00:00
|
|
|
GList *children;
|
|
|
|
gint width;
|
|
|
|
gint height;
|
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Adjustments */
|
2000-10-05 01:04:57 +00:00
|
|
|
GtkAdjustment *hadjustment;
|
|
|
|
GtkAdjustment *vadjustment;
|
2010-10-18 04:21:39 +00:00
|
|
|
gint min_display_width;
|
|
|
|
gint min_display_height;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Sub windows */
|
2000-10-05 01:04:57 +00:00
|
|
|
GdkWindow *bin_window;
|
|
|
|
GdkWindow *header_window;
|
2001-10-22 18:24:29 +00:00
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Scroll position state keeping */
|
2002-01-10 00:11:32 +00:00
|
|
|
GtkTreeRowReference *top_row;
|
|
|
|
gint top_row_dy;
|
2002-01-21 23:30:17 +00:00
|
|
|
/* dy == y pos of top_row + top_row_dy */
|
|
|
|
/* we cache it for simplicity of the code */
|
2001-10-22 18:24:29 +00:00
|
|
|
gint dy;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2001-12-04 23:49:57 +00:00
|
|
|
guint presize_handler_timer;
|
|
|
|
guint validate_rows_timer;
|
2002-03-16 23:30:44 +00:00
|
|
|
guint scroll_sync_timer;
|
2001-03-08 22:38:59 +00:00
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Indentation and expander layout */
|
|
|
|
gint expander_size;
|
|
|
|
GtkTreeViewColumn *expander_column;
|
|
|
|
|
|
|
|
gint level_indentation;
|
|
|
|
|
|
|
|
/* Key navigation (focus), selection */
|
|
|
|
gint cursor_offset;
|
2001-03-08 22:38:59 +00:00
|
|
|
|
2001-01-27 00:50:38 +00:00
|
|
|
GtkTreeRowReference *anchor;
|
|
|
|
GtkTreeRowReference *cursor;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
GtkTreeViewColumn *focus_column;
|
|
|
|
|
|
|
|
/* Current pressed node, previously pressed, prelight */
|
|
|
|
GtkRBNode *button_pressed_node;
|
|
|
|
GtkRBTree *button_pressed_tree;
|
|
|
|
|
|
|
|
gint pressed_button;
|
|
|
|
gint press_start_x;
|
|
|
|
gint press_start_y;
|
|
|
|
|
2009-11-26 20:05:01 +00:00
|
|
|
gint event_last_x;
|
|
|
|
gint event_last_y;
|
|
|
|
|
2009-11-27 12:40:30 +00:00
|
|
|
guint last_button_time;
|
|
|
|
gint last_button_x;
|
|
|
|
gint last_button_y;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
GtkRBNode *prelight_node;
|
|
|
|
GtkRBTree *prelight_tree;
|
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Cell Editing */
|
|
|
|
GtkTreeViewColumn *edited_column;
|
|
|
|
|
2001-07-22 20:09:00 +00:00
|
|
|
/* The node that's currently being collapsed or expanded */
|
|
|
|
GtkRBNode *expanded_collapsed_node;
|
|
|
|
GtkRBTree *expanded_collapsed_tree;
|
|
|
|
guint expand_collapse_timeout;
|
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Auto expand/collapse timeout in hover mode */
|
|
|
|
guint auto_expand_timeout;
|
|
|
|
|
2000-10-05 01:04:57 +00:00
|
|
|
/* Selection information */
|
|
|
|
GtkTreeSelection *selection;
|
|
|
|
|
|
|
|
/* Header information */
|
Port to GObject, can go back in gdk-pixbuf after setting up a
2000-12-16 Havoc Pennington <hp@pobox.com>
* gtk/gdk-pixbuf-loader.h, gtk/gdk-pixbuf-loader.c:
Port to GObject, can go back in gdk-pixbuf after setting up
a gdk-pixbuf-marshal.h header over there.
* gtk/gtktreeview.c: s/SEPERATOR/SEPARATOR/g;
(gtk_tree_view_class_init): specify GTK_TYPE_ADJUSTMENT for signal
args
(gtk_tree_view_init): don't unset GTK_NO_WINDOW, it shouldn't be
set
(gtk_tree_view_realize_buttons): don't gtk_widget_show() buttons
here, do it when we create the buttons later
(gtk_tree_view_realize_buttons): add some g_return_if_fail
(gtk_tree_view_map): paranoia checks that column->button is shown
and unmapped
(gtk_tree_view_size_request): only request visible children.
Move header size calculation in here, for cleanliness, and
to maintain invariants for child widgets if we eventually
let users set different children inside the buttons
(gtk_tree_view_map_buttons): factor out code to map buttons,
since it was being called several times
(gtk_tree_view_size_allocate_buttons): move_resize the drag
windows instead of just moving them; their height may change
if we allow random widgets in there, or the theme changes.
(gtk_tree_view_size_allocate): move button size allocation
above emitting the scroll signals, to ensure a sane state when we
hit user code
(gtk_tree_view_button_release): remove queue_resize after
tree_view_set_size(), set_size() will handle any resize queuing
that's needed
(gtk_tree_view_focus_in): just queue a draw, don't fool with
draw_focus goo
(gtk_tree_view_focus): use gtk_get_current_event() and
gdk_event_get_state()
(gtk_tree_view_deleted): don't queue_resize() after calling set_size()
(gtk_tree_view_build_tree): fix a "if (foo); {}" bug - i.e. remove
semicolon
(gtk_tree_view_create_button): show the button here
(gtk_tree_view_button_clicked): actually emit the clicked signal
on the column
(_gtk_tree_view_set_size): return right away if the size is
unchanged, as a cheesy optimization
(gtk_tree_view_setup_model): rename set_model_realized to
setup_model to match the flag that indicates whether we've
called it
(gtk_tree_view_get_hadjustment): create adjustment if it doesn't
exist, because set_scroll_adjustment does that and it shouldn't
matter what order you call these in
(gtk_tree_view_get_vadjustment): ditto
(gtk_tree_view_set_headers_visible): canonicalize the bool,
for paranoia
(gtk_tree_view_set_headers_visible): call
gtk_tree_view_map_buttons() instead of using cut-and-paste code
(gtk_tree_view_append_column): clarify whether the return value
is the count of columns before or after, and do the increment
separately from the return statement so you can tell from the code.
(gtk_tree_view_remove_column): ditto
(gtk_tree_view_insert_column): ditto
(gtk_tree_view_get_column): remove g_return_if_fail for columns
outside the existing range, the docs say that outside-range
columns are allowed, so we handle them as documented. (Presumably
this allows a nice loop with column != NULL as test.)
(gtk_tree_view_move_to): document what 0.0, 0.5, 1.0 alignments
mean (left/right/center etc.).
(gtk_tree_view_collapse_all): only queue a draw if we're mapped
(gtk_tree_view_expand_row): add docs
(gtk_tree_view_collapse_row): add docs
* gtk/gtktreeviewcolumn.c (gtk_tree_view_column_clicked): new
function to emit the clicked signal on a column
* gdk/gdkevents.c (gdk_event_get_state): new function, to get the
state of an event
(gdk_event_get_time): don't treat GDK_SCROLL
as a button event, remove default case from switch so gcc
will whine if we don't explicitly handle all event types
* gtk/gtktreeselection.h: added some FIXME
* gtk/gtktreeprivate.h (struct _GtkTreeViewPrivate): rename
"columns" to "n_columns" and "column" to "columns" for clarity
2000-12-17 23:50:00 +00:00
|
|
|
gint n_columns;
|
|
|
|
GList *columns;
|
2000-10-05 01:04:57 +00:00
|
|
|
gint header_height;
|
2001-04-23 23:03:53 +00:00
|
|
|
|
2001-05-25 15:43:53 +00:00
|
|
|
GtkTreeViewColumnDropFunc column_drop_func;
|
2001-05-09 22:23:12 +00:00
|
|
|
gpointer column_drop_func_data;
|
2008-06-18 09:12:32 +00:00
|
|
|
GDestroyNotify column_drop_func_data_destroy;
|
2001-04-12 16:11:54 +00:00
|
|
|
GList *column_drag_info;
|
2001-04-23 23:03:53 +00:00
|
|
|
GtkTreeViewColumnReorder *cur_reorder;
|
2001-01-19 22:39:19 +00:00
|
|
|
|
2009-12-21 21:33:59 +00:00
|
|
|
gint prev_width_before_expander;
|
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Interactive Header reordering */
|
|
|
|
GdkWindow *drag_window;
|
|
|
|
GdkWindow *drag_highlight_window;
|
|
|
|
GtkTreeViewColumn *drag_column;
|
|
|
|
gint drag_column_x;
|
|
|
|
|
|
|
|
/* Interactive Header Resizing */
|
|
|
|
gint drag_pos;
|
|
|
|
gint x_drag;
|
|
|
|
|
|
|
|
/* Non-interactive Header Resizing, expand flag support */
|
|
|
|
gint prev_width;
|
|
|
|
|
|
|
|
gint last_extra_space;
|
|
|
|
gint last_extra_space_per_column;
|
|
|
|
gint last_number_of_expand_columns;
|
|
|
|
|
2001-06-26 17:01:53 +00:00
|
|
|
/* ATK Hack */
|
|
|
|
GtkTreeDestroyCountFunc destroy_count_func;
|
|
|
|
gpointer destroy_count_data;
|
2008-06-18 09:12:32 +00:00
|
|
|
GDestroyNotify destroy_count_destroy;
|
2001-06-26 17:01:53 +00:00
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Scroll timeout (e.g. during dnd, rubber banding) */
|
2001-01-19 22:39:19 +00:00
|
|
|
guint scroll_timeout;
|
2001-03-08 22:38:59 +00:00
|
|
|
|
2001-01-19 22:39:19 +00:00
|
|
|
/* Row drag-and-drop */
|
2001-01-27 00:50:38 +00:00
|
|
|
GtkTreeRowReference *drag_dest_row;
|
2001-01-19 22:39:19 +00:00
|
|
|
GtkTreeViewDropPosition drag_dest_pos;
|
|
|
|
guint open_dest_timeout;
|
2001-03-08 22:38:59 +00:00
|
|
|
|
2009-11-26 19:31:29 +00:00
|
|
|
/* Rubber banding */
|
Rubber banding for GtkTreeView, #80127. Uses same method as GtkIconView.
2006-06-02 Kristian Rietveld <kris@imendio.com>
Rubber banding for GtkTreeView, #80127. Uses same method as
GtkIconView.
* gtk/gtktreeview.c (gtk_tree_view_class_init),
(gtk_tree_view_init), (gtk_tree_view_get_property),
(gtk_tree_view_set_property), (gtk_tree_view_set_rubber_banding),
(gtk_tree_view_get_rubber_banding): add property,
(gtk_tree_view_button_press): start rubber banding if enabled and
press is on a non-selected node,
(gtk_tree_view_button_release): stop rubber banding,
(gtk_tree_view_motion_bin_window), (scrool_row_timeout): enable/update
the rubber band,
(gtk_tree_view_bin_expose): draw rubber band if active,
(gtk_tree_view_stop_rubberband),
(gtk_tree_view_update_rubber_band_selection_range),
(gtk_tree_view_update_rubber_band_selection),
(gtk_tree_view_update_rubber_band),
(gtk_tree_view_paint_rubber_band): new functions.
* gtk/gtktreeview.h: add new set/get function for rubber banding
property.
* gtk/gtktreeprivate.h: add a bunch of new private fields.
2006-06-02 20:40:33 +00:00
|
|
|
gint rubber_band_status;
|
|
|
|
gint rubber_band_x;
|
|
|
|
gint rubber_band_y;
|
|
|
|
gint rubber_band_shift;
|
|
|
|
gint rubber_band_ctrl;
|
|
|
|
|
|
|
|
GtkRBNode *rubber_band_start_node;
|
|
|
|
GtkRBTree *rubber_band_start_tree;
|
|
|
|
|
|
|
|
GtkRBNode *rubber_band_end_node;
|
|
|
|
GtkRBTree *rubber_band_end_tree;
|
|
|
|
|
Yay! Fixed height mode! Hooray! (Part 2 of #80868).
Wed Dec 17 21:23:01 2003 Kristian Rietveld <kris@gtk.org>
Yay! Fixed height mode! Hooray! (Part 2 of #80868).
* gtk/gtktreeview.c (gtk_tree_view_class_init),
(gtk_tree_view_init), (gtk_tree_view_set_property),
(gtk_tree_view_get_property), (gtk_tree_view_set_model): add a
fixed_height_mode property,
(intialize_fixed_height_mode), (do_validate_rows),
(column_sizing_notify), (gtk_tree_view_set_fixed_height_mode),
(gtk_tree_view_style_set), (gtk_tree_view_row_changed),
(gtk_tree_view_row_inserted), (gtk_tree_view_remove_column),
(gtk_tree_view_insert_column): implement fixed height mode,
(gtk_tree_view_append_column), (gtk_tree_view_insert_column),
(gtk_tree_view_insert_column_with_attributes),
(gtk_tree_view_insert_column_with_data_func): update docs.
* gtk/gtktreeprivate.h: add two fields to GtkTreePrivate.
2003-12-17 20:29:43 +00:00
|
|
|
/* fixed height */
|
|
|
|
gint fixed_height;
|
|
|
|
|
2001-01-21 18:45:20 +00:00
|
|
|
/* Scroll-to functionality when unrealized */
|
2002-02-23 21:53:04 +00:00
|
|
|
GtkTreeRowReference *scroll_to_path;
|
2001-01-21 18:45:20 +00:00
|
|
|
GtkTreeViewColumn *scroll_to_column;
|
|
|
|
gfloat scroll_to_row_align;
|
|
|
|
gfloat scroll_to_col_align;
|
2009-11-26 19:31:29 +00:00
|
|
|
|
|
|
|
/* Interactive search */
|
|
|
|
gint selected_iter;
|
|
|
|
gint search_column;
|
|
|
|
GtkTreeViewSearchPositionFunc search_position_func;
|
|
|
|
GtkTreeViewSearchEqualFunc search_equal_func;
|
|
|
|
gpointer search_user_data;
|
|
|
|
GDestroyNotify search_destroy;
|
|
|
|
gpointer search_position_user_data;
|
|
|
|
GDestroyNotify search_position_destroy;
|
|
|
|
GtkWidget *search_window;
|
|
|
|
GtkWidget *search_entry;
|
2010-10-08 00:37:23 +00:00
|
|
|
gulong search_entry_changed_id;
|
2009-11-26 19:31:29 +00:00
|
|
|
guint typeselect_flush_timeout;
|
|
|
|
|
|
|
|
/* Grid and tree lines */
|
|
|
|
GtkTreeViewGridLines grid_lines;
|
2010-07-15 03:04:46 +00:00
|
|
|
double grid_line_dashes[2];
|
|
|
|
int grid_line_width;
|
2009-11-26 19:31:29 +00:00
|
|
|
|
|
|
|
gboolean tree_lines_enabled;
|
2010-07-15 03:04:46 +00:00
|
|
|
double tree_line_dashes[2];
|
|
|
|
int tree_line_width;
|
2009-11-26 19:31:29 +00:00
|
|
|
|
|
|
|
/* Row separators */
|
|
|
|
GtkTreeViewRowSeparatorFunc row_separator_func;
|
|
|
|
gpointer row_separator_data;
|
|
|
|
GDestroyNotify row_separator_destroy;
|
|
|
|
|
|
|
|
/* Tooltip support */
|
|
|
|
gint tooltip_column;
|
|
|
|
|
|
|
|
/* Here comes the bitfield */
|
2001-08-24 20:09:26 +00:00
|
|
|
guint scroll_to_use_align : 1;
|
remove validation idle
2001-02-08 Havoc Pennington <hp@redhat.com>
* gtk/gtktextview.c (gtk_text_view_destroy_layout): remove
validation idle
* demos/gtk-demo/main.c (create_tree): adjust to changes in text
cell renderer
* demos/pixbuf-demo.c (timeout): remove deprecated
gtk_widget_draw
* demos/testpixbuf-save.c (main): remove deprecated
gtk_drawing_area_size
* gtk/gtktreeview.c (gtk_tree_view_size_allocate): allocate
buttons even if the model isn't setup. gtk_tree_view_check_dirty()
at the start of the allocation.
(gtk_tree_view_check_dirty): handle column->button == NULL, handle
unsetup or NULL model.
* gtk/gtkstyle.c (gtk_default_draw_flat_box): drawing for the
even/odd/sorted cells in the tree view.
* gtk/gtktreeselection.c (gtk_tree_selection_real_unselect_all):
bugfixes
* gtk/gtktreeview.c: assorted bugfixy stuff. Draw the row
backgrounds with draw_flat_box using different detail for even/odd
rows.
* gtk/gtkrbtree.c, gtkrbtree.h: Keep track of the parity of each
row, so we can draw the alternating colors thing
* gtk/gtktexttag.c (gtk_text_tag_set_property): if we change a
property from a synonym property, notify for the synonym.
Also, nuke the background_gdk_set and foreground_gdk_set synonyms
(gtk_text_tag_get_property): Always return the font, even if
all its fields aren't set
* gtk/gtkcellrenderertext.h (struct _GtkCellRendererText): don't
store the attr list; it leaves us with no way to change attributes
in _render according to the render flags, and no way to implement
get_property. Instead store all the specific text attributes.
Separate whether an attribute is enabled from its value. Sync all
properties with GtkTextTag, make them all consistent, etc.
* gtk/gtkcellrenderer.h: Add a flag GTK_CELL_RENDERER_SORTED so
renderers can highlight the sort row/column
* gtk/gtktreeviewcolumn.c (gtk_tree_view_column_get_property): use
accessor functions to get values; this has the side effect of
showing up which accessor functions were missing. Added those.
* gtk/gtktreeviewcolumn.h: Replace set_justification with
set_alignment, to be consistent with GtkLabel, GtkMisc
* gtk/gtktreeviewcolumn.c: Added code to display sort indicator
arrow.
* gtk/Makefile.am (gtk_public_h_sources): add gtktreesortable.h
* gtk/gtktreesortable.h: updates in here
2001-02-08 23:36:53 +00:00
|
|
|
|
Yay! Fixed height mode! Hooray! (Part 2 of #80868).
Wed Dec 17 21:23:01 2003 Kristian Rietveld <kris@gtk.org>
Yay! Fixed height mode! Hooray! (Part 2 of #80868).
* gtk/gtktreeview.c (gtk_tree_view_class_init),
(gtk_tree_view_init), (gtk_tree_view_set_property),
(gtk_tree_view_get_property), (gtk_tree_view_set_model): add a
fixed_height_mode property,
(intialize_fixed_height_mode), (do_validate_rows),
(column_sizing_notify), (gtk_tree_view_set_fixed_height_mode),
(gtk_tree_view_style_set), (gtk_tree_view_row_changed),
(gtk_tree_view_row_inserted), (gtk_tree_view_remove_column),
(gtk_tree_view_insert_column): implement fixed height mode,
(gtk_tree_view_append_column), (gtk_tree_view_insert_column),
(gtk_tree_view_insert_column_with_attributes),
(gtk_tree_view_insert_column_with_data_func): update docs.
* gtk/gtktreeprivate.h: add two fields to GtkTreePrivate.
2003-12-17 20:29:43 +00:00
|
|
|
guint fixed_height_mode : 1;
|
2002-03-20 22:06:05 +00:00
|
|
|
guint fixed_height_check : 1;
|
|
|
|
|
2001-05-16 00:23:30 +00:00
|
|
|
guint reorderable : 1;
|
2001-05-09 13:18:46 +00:00
|
|
|
guint header_has_focus : 1;
|
|
|
|
guint drag_column_window_state : 3;
|
remove validation idle
2001-02-08 Havoc Pennington <hp@redhat.com>
* gtk/gtktextview.c (gtk_text_view_destroy_layout): remove
validation idle
* demos/gtk-demo/main.c (create_tree): adjust to changes in text
cell renderer
* demos/pixbuf-demo.c (timeout): remove deprecated
gtk_widget_draw
* demos/testpixbuf-save.c (main): remove deprecated
gtk_drawing_area_size
* gtk/gtktreeview.c (gtk_tree_view_size_allocate): allocate
buttons even if the model isn't setup. gtk_tree_view_check_dirty()
at the start of the allocation.
(gtk_tree_view_check_dirty): handle column->button == NULL, handle
unsetup or NULL model.
* gtk/gtkstyle.c (gtk_default_draw_flat_box): drawing for the
even/odd/sorted cells in the tree view.
* gtk/gtktreeselection.c (gtk_tree_selection_real_unselect_all):
bugfixes
* gtk/gtktreeview.c: assorted bugfixy stuff. Draw the row
backgrounds with draw_flat_box using different detail for even/odd
rows.
* gtk/gtkrbtree.c, gtkrbtree.h: Keep track of the parity of each
row, so we can draw the alternating colors thing
* gtk/gtktexttag.c (gtk_text_tag_set_property): if we change a
property from a synonym property, notify for the synonym.
Also, nuke the background_gdk_set and foreground_gdk_set synonyms
(gtk_text_tag_get_property): Always return the font, even if
all its fields aren't set
* gtk/gtkcellrenderertext.h (struct _GtkCellRendererText): don't
store the attr list; it leaves us with no way to change attributes
in _render according to the render flags, and no way to implement
get_property. Instead store all the specific text attributes.
Separate whether an attribute is enabled from its value. Sync all
properties with GtkTextTag, make them all consistent, etc.
* gtk/gtkcellrenderer.h: Add a flag GTK_CELL_RENDERER_SORTED so
renderers can highlight the sort row/column
* gtk/gtktreeviewcolumn.c (gtk_tree_view_column_get_property): use
accessor functions to get values; this has the side effect of
showing up which accessor functions were missing. Added those.
* gtk/gtktreeviewcolumn.h: Replace set_justification with
set_alignment, to be consistent with GtkLabel, GtkMisc
* gtk/gtktreeviewcolumn.c: Added code to display sort indicator
arrow.
* gtk/Makefile.am (gtk_public_h_sources): add gtktreesortable.h
* gtk/gtktreesortable.h: updates in here
2001-02-08 23:36:53 +00:00
|
|
|
/* hint to display rows in alternating colors */
|
|
|
|
guint has_rules : 1;
|
2001-12-04 23:49:57 +00:00
|
|
|
guint mark_rows_col_dirty : 1;
|
Merge from stable.
Mon Aug 25 23:21:43 2003 Kristian Rietveld <kris@gtk.org>
Merge from stable.
Fixes #115871, reported by Michael Natterer.
* gtk/gtktreeprivate.h: added GtkTreeSelectMode enum,
added ctrl_pressed and shift_pressed bitfields,
(_gtk_tree_selection_internal_select_node): replace GdkModifierType
arg with GtkTreeSelectMode.
* gtk/gtktreeselection.c (gtk_tree_selection_set_mode),
(gtk_tree_selection_select_path), (gtk_tree_selection_unselect_path),
(_gtk_tree_selection_internal_select_node): all updated for
GdkModifierType -> GtkTreeSelectMode move.
* gtk/gtktreeview.c (gtk_tree_view_button_press): set ctrl_pressed
and shift_pressed around selection handling block,
(gtk_tree_view_real_select_cursor_row),
(gtk_tree_view_real_toggle_cursor_row),
(gtk_tree_view_real_selection_cursor_parent),
(gtk_tree_view_real_set_cursor): use ctrl_pressed and shift_pressed,
instead of checking the event state. And also updates for the
GdkModifierType -> GtkTreeSelectMode move.
2003-08-25 21:33:00 +00:00
|
|
|
|
Big TreeView DnD fixage, makes drops on empty models work, makes TreeStore
Wed Sep 10 01:06:44 2003 Kristian Rietveld <kris@gtk.org>
Big TreeView DnD fixage, makes drops on empty models work, makes
TreeStore DnD work and gets rid of gtk-tree-model-drop-append.
Related bugs #95362 and #113314. I don't want to touch this code
ever again.
* gtk/gtktreeprivate.h (GtkTreePrivate): add empty_view_drop field.
* gtk/gtktreednd.c (gtk_tree_get_row_drag_data): add check
for selection_data->length.
* gtk/gtktreeview.c (struct DestRow), (dest_row_free),
(set_dest_row), (get_dest_row): we don't store just the row ref
anymore, but a struct with the row ref and additional info,
(set_destination_row): handle drops on empty space and some
style fixes,
(get_logical_dest_row): also return path_down_mode/drop_append_mode
flags, handle dropping childs on their new parents, rewrite
drop append handling into something saner,
(gtk_tree_view_drag_motion): show a "drop possible arrow" on empty
spaces,
(gtk_tree_view_drag_drop): updates for updated backend,
(gtk_tree_view_drag_data_received): updates for updated backend,
path down mode (treestore DnD) handling,
(gtk_tree_view_set_drag_dest_row): set empty_view_drop flag,
when we are trying to drop a row on an empty model,
(gtk_tree_view_get_drag_dest_row): handle empty_view_drop flag.
* gtk/gtkliststore.c (gtk_list_store_drag_data_received),
(gtk_list_store_row_drop_possible): style and drop-append fixes.
* gtk/gtktreestore.c (gtk_tree_store_drag_data_received): ditto.
2003-09-09 23:13:39 +00:00
|
|
|
/* for DnD */
|
|
|
|
guint empty_view_drop : 1;
|
|
|
|
|
Merge from stable.
Mon Aug 25 23:21:43 2003 Kristian Rietveld <kris@gtk.org>
Merge from stable.
Fixes #115871, reported by Michael Natterer.
* gtk/gtktreeprivate.h: added GtkTreeSelectMode enum,
added ctrl_pressed and shift_pressed bitfields,
(_gtk_tree_selection_internal_select_node): replace GdkModifierType
arg with GtkTreeSelectMode.
* gtk/gtktreeselection.c (gtk_tree_selection_set_mode),
(gtk_tree_selection_select_path), (gtk_tree_selection_unselect_path),
(_gtk_tree_selection_internal_select_node): all updated for
GdkModifierType -> GtkTreeSelectMode move.
* gtk/gtktreeview.c (gtk_tree_view_button_press): set ctrl_pressed
and shift_pressed around selection handling block,
(gtk_tree_view_real_select_cursor_row),
(gtk_tree_view_real_toggle_cursor_row),
(gtk_tree_view_real_selection_cursor_parent),
(gtk_tree_view_real_set_cursor): use ctrl_pressed and shift_pressed,
instead of checking the event state. And also updates for the
GdkModifierType -> GtkTreeSelectMode move.
2003-08-25 21:33:00 +00:00
|
|
|
guint ctrl_pressed : 1;
|
|
|
|
guint shift_pressed : 1;
|
2004-04-11 19:15:24 +00:00
|
|
|
|
|
|
|
guint init_hadjust_value : 1;
|
|
|
|
|
2008-01-10 09:24:11 +00:00
|
|
|
guint in_top_row_to_dy : 1;
|
|
|
|
|
Add heavily modified patch from Kristian Rietveld to handle interactive
Fri Aug 17 19:30:14 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtktreeprivate.h:
* gtk/gtktreeview.c: (gtk_tree_view_class_init),
(gtk_tree_view_init), (gtk_tree_view_set_property),
(gtk_tree_view_get_property), (gtk_tree_view_destroy),
(gtk_tree_view_key_press), (gtk_tree_view_leave_notify),
(gtk_tree_view_focus_out), (gtk_tree_view_set_model),
(gtk_tree_view_set_destroy_count_func),
(gtk_tree_view_set_enable_search),
(gtk_tree_view_get_enable_search),
(gtk_tree_view_get_search_column),
(gtk_tree_view_set_search_column),
(gtk_tree_view_get_search_equal_func),
(gtk_tree_view_set_search_equal_func),
(gtk_tree_view_search_dialog_destroy),
(gtk_tree_view_search_position_func),
(gtk_tree_view_interactive_search),
(gtk_tree_view_search_delete_event),
(gtk_tree_view_search_button_press_event),
(gtk_tree_view_search_key_press_event),
(gtk_tree_view_search_move), (gtk_tree_view_search_equal_func),
(gtk_tree_view_search_iter), (gtk_tree_view_search_init):
* gtk/gtktreeview.h:
Add heavily modified patch from Kristian Rietveld to handle
interactive searching.
2001-08-17 23:35:52 +00:00
|
|
|
/* interactive search */
|
|
|
|
guint enable_search : 1;
|
2002-02-22 21:36:48 +00:00
|
|
|
guint disable_popdown : 1;
|
2006-01-24 10:49:29 +00:00
|
|
|
guint search_custom_entry_set : 1;
|
2004-05-10 21:10:28 +00:00
|
|
|
|
|
|
|
guint hover_selection : 1;
|
2004-08-02 19:11:32 +00:00
|
|
|
guint hover_expand : 1;
|
2004-08-01 03:32:19 +00:00
|
|
|
guint imcontext_changed : 1;
|
2004-04-11 19:15:24 +00:00
|
|
|
|
Rubber banding for GtkTreeView, #80127. Uses same method as GtkIconView.
2006-06-02 Kristian Rietveld <kris@imendio.com>
Rubber banding for GtkTreeView, #80127. Uses same method as
GtkIconView.
* gtk/gtktreeview.c (gtk_tree_view_class_init),
(gtk_tree_view_init), (gtk_tree_view_get_property),
(gtk_tree_view_set_property), (gtk_tree_view_set_rubber_banding),
(gtk_tree_view_get_rubber_banding): add property,
(gtk_tree_view_button_press): start rubber banding if enabled and
press is on a non-selected node,
(gtk_tree_view_button_release): stop rubber banding,
(gtk_tree_view_motion_bin_window), (scrool_row_timeout): enable/update
the rubber band,
(gtk_tree_view_bin_expose): draw rubber band if active,
(gtk_tree_view_stop_rubberband),
(gtk_tree_view_update_rubber_band_selection_range),
(gtk_tree_view_update_rubber_band_selection),
(gtk_tree_view_update_rubber_band),
(gtk_tree_view_paint_rubber_band): new functions.
* gtk/gtktreeview.h: add new set/get function for rubber banding
property.
* gtk/gtktreeprivate.h: add a bunch of new private fields.
2006-06-02 20:40:33 +00:00
|
|
|
guint rubber_banding_enable : 1;
|
|
|
|
|
2006-07-18 12:33:25 +00:00
|
|
|
guint in_grab : 1;
|
|
|
|
|
2008-07-11 14:17:49 +00:00
|
|
|
guint post_validation_flag : 1;
|
|
|
|
|
bgo#580560 - Make Backspace work in the file chooser to to to the parent directory
GtkFileChooserDefault actually implements a binding signal for
Backspace, to make it go to the parent directory. However,
GtkTreeView was eating our Backspace, and thus the file chooser was
not getting a chance to execute its binding signal.
GtkTreeView implements a Backspace binding itself, which it uses to
move to the parent node of the current cursor node. However, the
binding handler would return TRUE even if there was no parent to the
current node. Now the binding handler only returns TRUE if it
actually changed the cursor.
Additionally, gtk_tree_view_key_press() sees if no bindings handled a
key press; in that case, it re-sends the key press to the treeview's
search entry. However, sending a Backspace to an empty entry makes
the entry beep. Thus, we add a flag that gets set from GtkTreeView's
Backspace binding handler, to tell gtk_tree_view_key_press() when it
should *not* re-emit the key press on the search entry. Sort of,
"yeah, I didn't handle this key press, but I don't want you to send it
to the search entry, either!".
Signed-off-by: Federico Mena Quintero <federico@novell.com>
2009-06-15 17:37:07 +00:00
|
|
|
/* Whether our key press handler is to avoid sending an unhandled binding to the search entry */
|
|
|
|
guint search_entry_avoid_unhandled_binding : 1;
|
2010-10-26 00:59:02 +00:00
|
|
|
|
|
|
|
/* GtkScrollablePolicy needs to be checked when
|
|
|
|
* driving the scrollable adjustment values */
|
|
|
|
guint hscroll_policy : 1;
|
|
|
|
guint vscroll_policy : 1;
|
2000-10-05 01:04:57 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/* functions that shouldn't be exported */
|
|
|
|
void _gtk_tree_selection_internal_select_node (GtkTreeSelection *selection,
|
|
|
|
GtkRBNode *node,
|
|
|
|
GtkRBTree *tree,
|
|
|
|
GtkTreePath *path,
|
Merge from stable.
Mon Aug 25 23:21:43 2003 Kristian Rietveld <kris@gtk.org>
Merge from stable.
Fixes #115871, reported by Michael Natterer.
* gtk/gtktreeprivate.h: added GtkTreeSelectMode enum,
added ctrl_pressed and shift_pressed bitfields,
(_gtk_tree_selection_internal_select_node): replace GdkModifierType
arg with GtkTreeSelectMode.
* gtk/gtktreeselection.c (gtk_tree_selection_set_mode),
(gtk_tree_selection_select_path), (gtk_tree_selection_unselect_path),
(_gtk_tree_selection_internal_select_node): all updated for
GdkModifierType -> GtkTreeSelectMode move.
* gtk/gtktreeview.c (gtk_tree_view_button_press): set ctrl_pressed
and shift_pressed around selection handling block,
(gtk_tree_view_real_select_cursor_row),
(gtk_tree_view_real_toggle_cursor_row),
(gtk_tree_view_real_selection_cursor_parent),
(gtk_tree_view_real_set_cursor): use ctrl_pressed and shift_pressed,
instead of checking the event state. And also updates for the
GdkModifierType -> GtkTreeSelectMode move.
2003-08-25 21:33:00 +00:00
|
|
|
GtkTreeSelectMode mode,
|
2002-04-09 19:48:32 +00:00
|
|
|
gboolean override_browse_mode);
|
2005-11-29 19:34:15 +00:00
|
|
|
void _gtk_tree_selection_emit_changed (GtkTreeSelection *selection);
|
2000-10-05 01:04:57 +00:00
|
|
|
gboolean _gtk_tree_view_find_node (GtkTreeView *tree_view,
|
|
|
|
GtkTreePath *path,
|
|
|
|
GtkRBTree **tree,
|
|
|
|
GtkRBNode **node);
|
|
|
|
GtkTreePath *_gtk_tree_view_find_path (GtkTreeView *tree_view,
|
|
|
|
GtkRBTree *tree,
|
|
|
|
GtkRBNode *node);
|
2001-09-18 22:49:02 +00:00
|
|
|
void _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
|
|
|
|
GtkWidget *widget,
|
|
|
|
gint x,
|
|
|
|
gint y,
|
|
|
|
gint width,
|
|
|
|
gint height);
|
2002-01-02 23:51:03 +00:00
|
|
|
void _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
|
|
|
|
GtkRBTree *tree,
|
|
|
|
GtkRBNode *node,
|
2008-01-25 09:30:40 +00:00
|
|
|
const GdkRectangle *clip_rect);
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2010-11-28 18:01:49 +00:00
|
|
|
void _gtk_tree_view_add_editable (GtkTreeView *tree_view,
|
|
|
|
GtkTreeViewColumn *column,
|
|
|
|
GtkTreePath *path,
|
|
|
|
GtkCellEditable *cell_editable,
|
|
|
|
GdkRectangle *cell_area);
|
|
|
|
void _gtk_tree_view_remove_editable (GtkTreeView *tree_view,
|
|
|
|
GtkTreeViewColumn *column,
|
|
|
|
GtkCellEditable *cell_editable);
|
|
|
|
|
2010-11-30 05:29:45 +00:00
|
|
|
void _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view);
|
2010-11-30 06:28:14 +00:00
|
|
|
void _gtk_tree_view_column_autosize (GtkTreeView *tree_view,
|
|
|
|
GtkTreeViewColumn *column);
|
|
|
|
gint _gtk_tree_view_get_header_height (GtkTreeView *tree_view);
|
2010-11-30 05:29:45 +00:00
|
|
|
|
|
|
|
GtkTreeSelection* _gtk_tree_selection_new (void);
|
|
|
|
GtkTreeSelection* _gtk_tree_selection_new_with_tree_view (GtkTreeView *tree_view);
|
|
|
|
void _gtk_tree_selection_set_tree_view (GtkTreeSelection *selection,
|
|
|
|
GtkTreeView *tree_view);
|
|
|
|
gboolean _gtk_tree_selection_row_is_selectable (GtkTreeSelection *selection,
|
|
|
|
GtkRBNode *node,
|
|
|
|
GtkTreePath *path);
|
|
|
|
|
|
|
|
|
2001-03-02 00:49:32 +00:00
|
|
|
void _gtk_tree_view_column_realize_button (GtkTreeViewColumn *column);
|
|
|
|
void _gtk_tree_view_column_unrealize_button (GtkTreeViewColumn *column);
|
|
|
|
void _gtk_tree_view_column_set_tree_view (GtkTreeViewColumn *column,
|
|
|
|
GtkTreeView *tree_view);
|
2010-11-28 18:01:49 +00:00
|
|
|
void _gtk_tree_view_column_set_width (GtkTreeViewColumn *column,
|
2010-11-29 09:04:47 +00:00
|
|
|
int width,
|
|
|
|
int internal_width);
|
API additions: _move, _reorder and _swap for stores, path constructor.
Fri Jul 26 22:53:37 2002 Kristian Rietveld <kris@gtk.org>
API additions: _move, _reorder and _swap for stores, path
constructor.
* gtk/gtktreemodel.[ch] (gtk_tree_path_new_from_indices): new function.
* gtk/gtkliststore.[ch]: added gtk_list_store_reorder_func (private),
gtk_list_store_reorder, gtk_list_store_swap, gtk_list_store_move.
* gtk/gtktreestore.[ch]: added gtk_tree_store_reorder_func (private),
gtk_tree_store_reorder, gtk_tree_store_swap, gtk_tree_store_move.
Fri Jul 26 22:32:57 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreestore.c (node_free): return FALSE,
(gtk_tree_store_finalize): use g_node_traverse instead of
g_node_children_foreach, so the whole tree will be freed (#88854,
patch from Emmanuel Briot).
Fri Jul 26 22:32:24 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_button_press): fix some memleaks,
(#84426, patch from Matthias Clasen).
Fri Jul 26 22:31:25 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_unref_tree_helper): _iter_children
check shouldn't be in g_return_return_val_if_fail (pointed out by
Josh Green, #88997),
(gtk_tree_view_set_model): call _gtk_tree_view_column_unset_model
for each column when we unset the model (part of #82484),
(gtk_tree_view_get_cell_area): return if we ran out of tree or
if we got an invalid path (#82376).
* gtk/gtktreeprivate.h: add _gtk_tree_view_column_unset_model.
* gtk/gtktreeviewcolumn.c: implement _gtk_tree_view_column_unset_model
which disconnects the sort_column_changed_signal (part of #82484).
* gtk/gtkliststore.c (gtk_list_store_insert): append row if the
given postion is off the end of the tree (#85813).
* gtk/gtkentry.c (gtk_cell_editable_key_press_event): let's use
2-space indent, commit changes if up/down keys has been pressed,
this overrides the focus key foo so the user won't be surprised
(#84665).
2002-07-26 20:51:13 +00:00
|
|
|
void _gtk_tree_view_column_unset_model (GtkTreeViewColumn *column,
|
|
|
|
GtkTreeModel *old_model);
|
2001-03-02 00:49:32 +00:00
|
|
|
void _gtk_tree_view_column_unset_tree_view (GtkTreeViewColumn *column);
|
2001-04-12 16:11:54 +00:00
|
|
|
void _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
|
2010-05-25 22:38:44 +00:00
|
|
|
GtkTreeViewColumn *column,
|
|
|
|
GdkDevice *device);
|
2001-09-18 16:15:10 +00:00
|
|
|
gboolean _gtk_tree_view_column_cell_event (GtkTreeViewColumn *tree_column,
|
|
|
|
GtkCellEditable **editable_widget,
|
|
|
|
GdkEvent *event,
|
|
|
|
gchar *path_string,
|
2008-01-25 09:30:40 +00:00
|
|
|
const GdkRectangle *background_area,
|
|
|
|
const GdkRectangle *cell_area,
|
2001-09-18 16:15:10 +00:00
|
|
|
guint flags);
|
2010-11-30 05:29:45 +00:00
|
|
|
gboolean _gtk_tree_view_column_has_editable_cell(GtkTreeViewColumn *column);
|
|
|
|
GtkCellRenderer *_gtk_tree_view_column_get_edited_cell (GtkTreeViewColumn *column);
|
|
|
|
GtkCellRenderer *_gtk_tree_view_column_get_cell_at_pos (GtkTreeViewColumn *column,
|
|
|
|
gint x);
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2008-01-25 09:30:40 +00:00
|
|
|
void _gtk_tree_view_column_cell_render (GtkTreeViewColumn *tree_column,
|
2010-08-24 13:45:41 +00:00
|
|
|
cairo_t *cr,
|
2008-01-25 09:30:40 +00:00
|
|
|
const GdkRectangle *background_area,
|
|
|
|
const GdkRectangle *cell_area,
|
2010-11-28 18:01:49 +00:00
|
|
|
guint flags,
|
|
|
|
gboolean draw_focus);
|
2008-01-25 09:30:40 +00:00
|
|
|
void _gtk_tree_view_column_get_focus_area (GtkTreeViewColumn *tree_column,
|
|
|
|
const GdkRectangle *background_area,
|
|
|
|
const GdkRectangle *cell_area,
|
|
|
|
GdkRectangle *focus_area);
|
|
|
|
gboolean _gtk_tree_view_column_cell_focus (GtkTreeViewColumn *tree_column,
|
2010-11-28 18:01:49 +00:00
|
|
|
gint count,
|
2008-01-25 09:30:40 +00:00
|
|
|
gboolean left,
|
|
|
|
gboolean right);
|
|
|
|
void _gtk_tree_view_column_cell_set_dirty (GtkTreeViewColumn *tree_column,
|
|
|
|
gboolean install_handler);
|
2010-11-30 05:29:45 +00:00
|
|
|
gboolean _gtk_tree_view_column_cell_get_dirty (GtkTreeViewColumn *tree_column);
|
|
|
|
GdkWindow *_gtk_tree_view_column_get_window (GtkTreeViewColumn *column);
|
|
|
|
|
|
|
|
void _gtk_tree_view_column_set_requested_width (GtkTreeViewColumn *column,
|
|
|
|
gint width);
|
|
|
|
gint _gtk_tree_view_column_get_requested_width (GtkTreeViewColumn *column);
|
|
|
|
void _gtk_tree_view_column_set_resized_width (GtkTreeViewColumn *column,
|
|
|
|
gint width);
|
|
|
|
gint _gtk_tree_view_column_get_resized_width (GtkTreeViewColumn *column);
|
|
|
|
void _gtk_tree_view_column_set_use_resized_width (GtkTreeViewColumn *column,
|
|
|
|
gboolean use_resized_width);
|
|
|
|
gboolean _gtk_tree_view_column_get_use_resized_width (GtkTreeViewColumn *column);
|
|
|
|
gint _gtk_tree_view_column_get_drag_x (GtkTreeViewColumn *column);
|
|
|
|
GtkCellAreaContext *_gtk_tree_view_column_get_context (GtkTreeViewColumn *column);
|
2001-02-28 21:37:50 +00:00
|
|
|
|
2005-06-21 05:35:43 +00:00
|
|
|
G_END_DECLS
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
|
|
|
|
#endif /* __GTK_TREE_PRIVATE_H__ */
|
|
|
|
|