gtkmm: Gtk::ColumnViewColumn Class Reference

The column added to Gtk::ColumnView. More...

#include <gtkmm/columnviewcolumn.h>

Inheritance diagram for Gtk::ColumnViewColumn:

Public Member Functions

 ColumnViewColumn (ColumnViewColumn&& src) noexcept
 
ColumnViewColumnoperator= (ColumnViewColumn&& src) noexcept
 
 ~ColumnViewColumn () noexcept override
 
GtkColumnViewColumn* gobj ()
 Provides access to the underlying C GObject. More...

 
const GtkColumnViewColumn* gobj () const
 Provides access to the underlying C GObject. More...

 
GtkColumnViewColumn* gobj_copy ()
 Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

 
ColumnViewget_column_view ()
 Gets the column view that's currently displaying this column. More...

 
const ColumnViewget_column_view () const
 Gets the column view that's currently displaying this column. More...

 
void set_factory (const Glib::RefPtr< ListItemFactory >& factory)
 Sets the Gtk::ListItemFactory to use for populating list items for this column. More...

 
Glib::RefPtr< ListItemFactoryget_factory ()
 Gets the factory that's currently used to populate list items for this column. More...

 
Glib::RefPtr< const ListItemFactoryget_factory () const
 Gets the factory that's currently used to populate list items for this column. More...

 
void set_title (const Glib::ustring& title)
 Sets the title of this column. More...

 
Glib::ustring get_title () const
 Returns the title set with set_title(). More...

 
void set_sorter (const Glib::RefPtr< Sorter >& sorter)
 Associates a sorter with the column. More...

 
Glib::RefPtr< Sorterget_sorter ()
 Returns the sorter that is associated with the column. More...

 
Glib::RefPtr< const Sorterget_sorter () const
 Returns the sorter that is associated with the column. More...

 
void set_visible (bool visible=true)
 Sets whether this column should be visible in views. More...

 
bool get_visible () const
 Returns whether this column is visible. More...

 
void set_header_menu (const Glib::RefPtr< Gio::MenuModel >& model)
 Sets the menu model that is used to create the context menu for the column header. More...

 
Glib::RefPtr< Gio::MenuModelget_header_menu ()
 Gets the menu model that is used to create the context menu for the column header. More...

 
Glib::RefPtr< const Gio::MenuModelget_header_menu () const
 Gets the menu model that is used to create the context menu for the column header. More...

 
void set_fixed_width (int fixed_width)
 If fixed_width is not -1, sets the fixed width of column; otherwise unsets it. More...

 
int get_fixed_width () const
 Gets the fixed width of the column. More...

 
void set_resizable (bool resizable=true)
 Sets whether this column should be resizable by dragging. More...

 
bool get_resizable () const
 Returns whether this column is resizable. More...

 
void set_expand (bool expand=true)
 Sets the column to take available extra space. More...

 
bool get_expand () const
 Returns whether this column should expand. More...

 
Glib::PropertyProxy_ReadOnly< ColumnView* > property_column_view () const
 Gtk::ColumnView this column is a part of. More...

 
Glib::PropertyProxy< Glib::RefPtr< ListItemFactory > > property_factory ()
 Factory for populating list items. More...

 
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< ListItemFactory > > property_factory () const
 Factory for populating list items. More...

 
Glib::PropertyProxy< Glib::ustringproperty_title ()
 Title displayed in the header. More...

 
Glib::PropertyProxy_ReadOnly< Glib::ustringproperty_title () const
 Title displayed in the header. More...

 
Glib::PropertyProxy< Glib::RefPtr< Sorter > > property_sorter ()
 Sorter for sorting items according to this column. More...

 
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Sorter > > property_sorter () const
 Sorter for sorting items according to this column. More...

 
Glib::PropertyProxy< bool > property_visible ()
 Whether this column is visible. More...

 
Glib::PropertyProxy_ReadOnly< bool > property_visible () const
 Whether this column is visible. More...

 
Glib::PropertyProxy< Glib::RefPtr< Gio::MenuModel > > property_header_menu ()
 Menu model used to create the context menu for the column header. More...

 
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gio::MenuModel > > property_header_menu () const
 Menu model used to create the context menu for the column header. More...

 
Glib::PropertyProxy< bool > property_resizable ()
 Whether this column is resizable. More...

 
Glib::PropertyProxy_ReadOnly< bool > property_resizable () const
 Whether this column is resizable. More...

 
Glib::PropertyProxy< bool > property_expand ()
 Column gets share of extra width allocated to the view. More...

 
Glib::PropertyProxy_ReadOnly< bool > property_expand () const
 Column gets share of extra width allocated to the view. More...

 
Glib::PropertyProxy< int > property_fixed_width ()
 If not -1, this is the width that the column is allocated, regardless of the size of its content. More...

 
Glib::PropertyProxy_ReadOnly< int > property_fixed_width () const
 If not -1, this is the width that the column is allocated, regardless of the size of its content. More...

 
- Public Member Functions inherited from Glib::Object
 Object (const Object &)=delete
 
Objectoperator= (const Object &)=delete
 
 Object (Object &&src) noexcept
 
Objectoperator= (Object &&src) noexcept
 
void * get_data (const QueryQuark &key)
 
void set_data (const Quark &key, void *data)
 
void set_data (const Quark &key, void *data, DestroyNotify notify)
 
void remove_data (const QueryQuark &quark)
 
void * steal_data (const QueryQuark &quark)
 
Glib::RefPtr< Glib::Objectwrap (GObject *object, bool take_copy=false)
 
- Public Member Functions inherited from Glib::ObjectBase
 ObjectBase (const ObjectBase &)=delete
 
ObjectBaseoperator= (const ObjectBase &)=delete
 
void set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value)
 
void get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const
 
void set_property (const Glib::ustring &property_name, const PropertyType &value)
 
void get_property (const Glib::ustring &property_name, PropertyType &value) const
 
PropertyType get_property (const Glib::ustring &property_name) const
 
sigc::connection connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void()> &slot)
 
sigc::connection connect_property_changed (const Glib::ustring &property_name, sigc::slot< void()> &&slot)
 
void freeze_notify ()
 
void thaw_notify ()
 
virtual void reference () const
 
virtual void unreference () const
 
GObject * gobj ()
 
const GObject * gobj () const
 
GObject * gobj_copy () const
 
- Public Member Functions inherited from sigc::trackable
 trackable () noexcept
 
 trackable (const trackable &src) noexcept
 
 trackable (trackable &&src) noexcept
 
 ~trackable ()
 
void add_destroy_notify_callback (notifiable *data, func_destroy_notify func) const
 
void notify_callbacks ()
 
trackableoperator= (const trackable &src)
 
trackableoperator= (trackable &&src) noexcept
 
void remove_destroy_notify_callback (notifiable *data) const
 

Static Public Member Functions

static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system. More...

 
static Glib::RefPtr< ColumnViewColumncreate (const Glib::ustring& title, const Glib::RefPtr< ListItemFactory >& factory={})
 

Protected Member Functions

 ColumnViewColumn (const Glib::ustring& title, const Glib::RefPtr< ListItemFactory >& factory={})
 
- Protected Member Functions inherited from Glib::Object
 Object ()
 
 Object (const Glib::ConstructParams &construct_params)
 
 Object (GObject *castitem)
 
 ~Object () noexcept override
 
- Protected Member Functions inherited from Glib::ObjectBase
 ObjectBase ()
 
 ObjectBase (const char *custom_type_name)
 
 ObjectBase (const std::type_info &custom_type_info)
 
 ObjectBase (ObjectBase &&src) noexcept
 
ObjectBaseoperator= (ObjectBase &&src) noexcept
 
virtual ~ObjectBase () noexcept=0
 
void initialize (GObject *castitem)
 
void initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper)
 

Related Functions

(Note that these are not member functions.)

Glib::RefPtr< Gtk::ColumnViewColumnwrap (GtkColumnViewColumn* object, bool take_copy=false)
 A Glib::wrap() method for this object. More...

 

Additional Inherited Members

- Public Types inherited from Glib::Object
typedef void(*)(gpointer data DestroyNotify)
 
- Public Types inherited from sigc::trackable
typedef internal::func_destroy_notify func_destroy_notify
 
- Public Types inherited from sigc::notifiable
typedef internal::func_destroy_notify func_destroy_notify
 

Detailed Description

The column added to Gtk::ColumnView.

Gtk::ColumnViewColumn represents the columns being added to Gtk::ColumnView.

Columns have a title, and can optionally have a header menu set with set_header_menu().

A sorter can be associated with a column using set_sorter(), to let users influence sorting by clicking on the column header.

See also
Gtk::ColumnView

Constructor & Destructor Documentation

Gtk::ColumnViewColumn::ColumnViewColumn ( ColumnViewColumn&&  src)
noexcept
Gtk::ColumnViewColumn::~ColumnViewColumn ( )
overridenoexcept
Gtk::ColumnViewColumn::ColumnViewColumn ( const Glib::ustring title,
const Glib::RefPtr< ListItemFactory >&  factory = {} 
)
explicitprotected

Member Function Documentation

static Glib::RefPtr<ColumnViewColumn> Gtk::ColumnViewColumn::create ( const Glib::ustring title,
const Glib::RefPtr< ListItemFactory >&  factory = {} 
)
static
ColumnView* Gtk::ColumnViewColumn::get_column_view ( )

Gets the column view that's currently displaying this column.

If self has not been added to a column view yet, nullptr is returned.

Returns
The column view displaying self.
const ColumnView* Gtk::ColumnViewColumn::get_column_view ( ) const

Gets the column view that's currently displaying this column.

If self has not been added to a column view yet, nullptr is returned.

Returns
The column view displaying self.
bool Gtk::ColumnViewColumn::get_expand ( ) const

Returns whether this column should expand.

Returns
true if this column expands.
Glib::RefPtr<ListItemFactory> Gtk::ColumnViewColumn::get_factory ( )

Gets the factory that's currently used to populate list items for this column.

Returns
The factory in use.
Glib::RefPtr<const ListItemFactory> Gtk::ColumnViewColumn::get_factory ( ) const

Gets the factory that's currently used to populate list items for this column.

Returns
The factory in use.
int Gtk::ColumnViewColumn::get_fixed_width ( ) const

Gets the fixed width of the column.

Returns
The fixed with of the column.
Glib::RefPtr<Gio::MenuModel> Gtk::ColumnViewColumn::get_header_menu ( )

Gets the menu model that is used to create the context menu for the column header.

Returns
The Gio::MenuModel, or nullptr.
Glib::RefPtr<const Gio::MenuModel> Gtk::ColumnViewColumn::get_header_menu ( ) const

Gets the menu model that is used to create the context menu for the column header.

Returns
The Gio::MenuModel, or nullptr.
bool Gtk::ColumnViewColumn::get_resizable ( ) const

Returns whether this column is resizable.

Returns
true if this column is resizable.
Glib::RefPtr<Sorter> Gtk::ColumnViewColumn::get_sorter ( )

Returns the sorter that is associated with the column.

Returns
The Gtk::Sorter of self.
Glib::RefPtr<const Sorter> Gtk::ColumnViewColumn::get_sorter ( ) const

Returns the sorter that is associated with the column.

Returns
The Gtk::Sorter of self.
Glib::ustring Gtk::ColumnViewColumn::get_title ( ) const

Returns the title set with set_title().

Returns
The column's title.
static GType Gtk::ColumnViewColumn::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

bool Gtk::ColumnViewColumn::get_visible ( ) const

Returns whether this column is visible.

Returns
true if this column is visible.
GtkColumnViewColumn* Gtk::ColumnViewColumn::gobj ( )
inline

Provides access to the underlying C GObject.

const GtkColumnViewColumn* Gtk::ColumnViewColumn::gobj ( ) const
inline

Provides access to the underlying C GObject.

GtkColumnViewColumn* Gtk::ColumnViewColumn::gobj_copy ( )

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

ColumnViewColumn& Gtk::ColumnViewColumn::operator= ( ColumnViewColumn&&  src)
noexcept
Glib::PropertyProxy_ReadOnly< ColumnView* > Gtk::ColumnViewColumn::property_column_view ( ) const

Gtk::ColumnView this column is a part of.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< bool > Gtk::ColumnViewColumn::property_expand ( )

Column gets share of extra width allocated to the view.

Default value: false

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< bool > Gtk::ColumnViewColumn::property_expand ( ) const

Column gets share of extra width allocated to the view.

Default value: false

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<ListItemFactory> > Gtk::ColumnViewColumn::property_factory ( )

Factory for populating list items.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<ListItemFactory> > Gtk::ColumnViewColumn::property_factory ( ) const

Factory for populating list items.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< int > Gtk::ColumnViewColumn::property_fixed_width ( )

If not -1, this is the width that the column is allocated, regardless of the size of its content.

Default value: -1

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< int > Gtk::ColumnViewColumn::property_fixed_width ( ) const

If not -1, this is the width that the column is allocated, regardless of the size of its content.

Default value: -1

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Gio::MenuModel> > Gtk::ColumnViewColumn::property_header_menu ( )

Menu model used to create the context menu for the column header.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gio::MenuModel> > Gtk::ColumnViewColumn::property_header_menu ( ) const

Menu model used to create the context menu for the column header.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< bool > Gtk::ColumnViewColumn::property_resizable ( )

Whether this column is resizable.

Default value: false

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< bool > Gtk::ColumnViewColumn::property_resizable ( ) const

Whether this column is resizable.

Default value: false

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Sorter> > Gtk::ColumnViewColumn::property_sorter ( )

Sorter for sorting items according to this column.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Sorter> > Gtk::ColumnViewColumn::property_sorter ( ) const

Sorter for sorting items according to this column.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::ustring > Gtk::ColumnViewColumn::property_title ( )

Title displayed in the header.

Default value: ""

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::ColumnViewColumn::property_title ( ) const

Title displayed in the header.

Default value: ""

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< bool > Gtk::ColumnViewColumn::property_visible ( )

Whether this column is visible.

Default value: true

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< bool > Gtk::ColumnViewColumn::property_visible ( ) const

Whether this column is visible.

Default value: true

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
void Gtk::ColumnViewColumn::set_expand ( bool  expand = true)

Sets the column to take available extra space.

The extra space is shared equally amongst all columns that have the expand set to true.

Parameters
expandtrue if this column should expand to fill available sace.
void Gtk::ColumnViewColumn::set_factory ( const Glib::RefPtr< ListItemFactory >&  factory)

Sets the Gtk::ListItemFactory to use for populating list items for this column.

Parameters
factoryThe factory to use or nullptr for none.
void Gtk::ColumnViewColumn::set_fixed_width ( int  fixed_width)

If fixed_width is not -1, sets the fixed width of column; otherwise unsets it.

Setting a fixed width overrides the automatically calculated width. Interactive resizing also sets the “fixed-width” property.

Parameters
fixed_widthThe new fixed width, or -1.
void Gtk::ColumnViewColumn::set_header_menu ( const Glib::RefPtr< Gio::MenuModel > &  model)

Sets the menu model that is used to create the context menu for the column header.

Parameters
modelA Gio::MenuModel, or nullptr.
void Gtk::ColumnViewColumn::set_resizable ( bool  resizable = true)

Sets whether this column should be resizable by dragging.

Parameters
resizableWhether this column should be resizable.
void Gtk::ColumnViewColumn::set_sorter ( const Glib::RefPtr< Sorter >&  sorter)

Associates a sorter with the column.

If sorter is nullptr, the column will not let users change the sorting by clicking on its header.

This sorter can be made active by clicking on the column header, or by calling sort_by_column().

See get_sorter() for the necessary steps for setting up customizable sorting for Gtk::ColumnView.

Parameters
sorterThe Gtk::Sorter to associate with column.
void Gtk::ColumnViewColumn::set_title ( const Glib::ustring title)

Sets the title of this column.

The title is displayed in the header of a Gtk::ColumnView for this column and is therefore user-facing text that should be translated.

Parameters
titleTitle to use for this column.
void Gtk::ColumnViewColumn::set_visible ( bool  visible = true)

Sets whether this column should be visible in views.

Parameters
visibleWhether this column should be visible.

Friends And Related Function Documentation

Glib::RefPtr< Gtk::ColumnViewColumn > wrap ( GtkColumnViewColumn *  object,
bool  take_copy = false 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.