rb_property_view_new ()

RBPropertyView *
rb_property_view_new (RhythmDB *db,
                      guint propid,
                      const char *title);

Creates a new RBPropertyView displaying the specified property.

rb_property_view_append_column_custom ()

void
rb_property_view_append_column_custom (RBPropertyView *view,
                                       GtkTreeViewColumn *column);

Appends a custom created column to the view.

rb_property_view_set_selection_mode ()

void
rb_property_view_set_selection_mode (RBPropertyView *view,
                                     GtkSelectionMode mode);

Sets the selection mode (single or multiple) for the property view> The default selection mode is single.

rb_property_view_reset ()

void
rb_property_view_reset (RBPropertyView *view);

Clears the selection in the property view.

rb_property_view_set_selection ()

void
rb_property_view_set_selection (RBPropertyView *view,
                                const GList *vals);

Replaces the selection in the property view. All values in the list that are present in the view will be selected, and the view will be scrolled to show the last value selected.

rb_property_view_get_selection ()

GList *
rb_property_view_get_selection (RBPropertyView *view);

Returns a GList containing the selected property values. The list must be freed by the caller.

rb_property_view_get_model ()

RhythmDBPropertyModel *
rb_property_view_get_model (RBPropertyView *view);

Returns the RhythmDBPropertyModel backing the view; no reference is taken

rb_property_view_set_model ()

void
rb_property_view_set_model (RBPropertyView *view,
                            RhythmDBPropertyModel *model);

Replaces the model backing the property view.

rb_property_view_get_num_properties ()

guint
rb_property_view_get_num_properties (RBPropertyView *view);

Returns the number of property values present in the view.

rb_property_view_set_search_func ()

void
rb_property_view_set_search_func (RBPropertyView *view,
                                  GtkTreeViewSearchEqualFunc func,
                                  gpointer func_data,
                                  GDestroyNotify notify);

Sets the compare function for the interactive search capabilities. The function must return FALSE when the search key string matches the row it is passed.

struct RBPropertyView

struct RBPropertyView;

struct RBPropertyViewClass

struct RBPropertyViewClass {
	GtkScrolledWindowClass parent;

	void (*property_selected) (RBPropertyView *view, const char *name);
	void (*properties_selected) (RBPropertyView *view, GList *properties);
	void (*property_activated) (RBPropertyView *view, const char *name);
	void (*selection_reset)		(RBPropertyView *view);
	void (*show_popup)		(RBPropertyView *view);
};

The “db” property

  “db”                       RhythmDB *

RhythmDB instance

Flags: Read / Write / Construct Only

The “draggable” property

  “draggable”                gboolean

Whether the property view acts as a data source for drag and drop operations.

Flags: Read / Write / Construct Only

Default value: TRUE

The “prop” property

  “prop”                     RhythmDBPropType

The property that is displayed in this view

Flags: Read / Write / Construct Only

Default value: RHYTHMDB_PROP_TYPE

The “property-model” property

  “property-model”           RhythmDBPropertyModel *

The RhythmDBPropertyModel backing the view.

Flags: Read / Write

The “title” property

  “title”                    gchar *

The title displayed in the header of the property view

Flags: Read / Write / Construct Only

Default value: ""

The “properties-selected” signal

void
user_function (RBPropertyView *view,
               gpointer        properties,
               gpointer        user_data)

Emitted when the set of selected property values changes. This is only emitted for multiple selection property views. For single-selection views, use the property-selected signal.

Flags: Run Last

The “property-activated” signal

void
user_function (RBPropertyView *view,
               gchar          *name,
               gpointer        user_data)

Emitted when a row in a property view is activated by double clicking.

Flags: Run Last

The “property-selected” signal

void
user_function (RBPropertyView *view,
               gchar          *name,
               gpointer        user_data)

Emitted when an individual property value becomes selected. This is only emitted for single-selection property views. For multiple-selection views, use the properties-selected signal.

Flags: Run Last

The “property-selection-reset” signal

void
user_function (RBPropertyView *view,
               gpointer        user_data)

Emitted when the selection is reset. At this point, no property values are selected.

Flags: Run Last

The “show-popup” signal

void
user_function (RBPropertyView *view,
               gpointer        user_data)

Emitted when a popup menu should be displayed for the property view. The source containing the property view should connect a handler to this signal that * displays an appropriate popup.

Flags: Run Last