Package org.gnome.gtk

Class ColumnViewColumn

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.ColumnViewColumn

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class ColumnViewColumn
extends GObject

Represents the columns in a GtkColumnView.

The main ingredient for a GtkColumnViewColumn is the GtkListItemFactory that tells the columnview how to create cells for this column from items in the model.

Columns have a title, and can optionally have a header menu set with setHeaderMenu(org.gnome.gio.MenuModel).

A sorter can be associated with a column using setSorter(org.gnome.gtk.Sorter), to let users influence sorting by clicking on the column header.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ColumnViewColumn.Builder<B extends ColumnViewColumn.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	ColumnViewColumn.ColumnViewColumnClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
ColumnViewColumn()	Creates a new ColumnViewColumn.
ColumnViewColumn(@Nullable String title, @Nullable ListItemFactory factory)	Creates a new GtkColumnViewColumn that uses the given factory for mapping items to widgets.
ColumnViewColumn(MemorySegment address)	Create a ColumnViewColumn proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected ColumnViewColumn	asParent()	Returns this instance as if it were its parent type.
static ColumnViewColumn.Builder<? extends ColumnViewColumn.Builder>	builder()	A ColumnViewColumn.Builder object constructs a ColumnViewColumn with the specified properties.
@Nullable ColumnView	getColumnView()	Gets the column view that's currently displaying this column.
boolean	getExpand()	Returns whether this column should expand.
@Nullable ListItemFactory	getFactory()	Gets the factory that's currently used to populate list items for this column.
int	getFixedWidth()	Gets the fixed width of the column.
@Nullable MenuModel	getHeaderMenu()	Gets the menu model that is used to create the context menu for the column header.
@Nullable String	getId()	Returns the ID set with setId(java.lang.String).
boolean	getResizable()	Returns whether this column is resizable.
@Nullable Sorter	getSorter()	Returns the sorter that is associated with the column.
@Nullable String	getTitle()	Returns the title set with setTitle(java.lang.String).
static @Nullable Type	getType()	Get the GType of the ColumnViewColumn class
boolean	getVisible()	Returns whether this column is visible.
void	setExpand(boolean expand)	Sets the column to take available extra space.
void	setFactory(@Nullable ListItemFactory factory)	Sets the GtkListItemFactory to use for populating list items for this column.
void	setFixedWidth(int fixedWidth)	Sets the fixed width of the column.
void	setHeaderMenu(@Nullable MenuModel menu)	Sets the menu model that is used to create the context menu for the column header.
void	setId(@Nullable String id)	Sets the id of this column.
void	setResizable(boolean resizable)	Sets whether this column should be resizable by dragging.
void	setSorter(@Nullable Sorter sorter)	Associates a sorter with the column.
void	setTitle(@Nullable String title)	Sets the title of this column.
void	setVisible(boolean visible)	Sets whether this column should be visible in views.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getMemoryLayout, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ColumnViewColumn

public ColumnViewColumn(MemorySegment address)

Create a ColumnViewColumn proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

ColumnViewColumn

public ColumnViewColumn(@Nullable String title,
 @Nullable ListItemFactory factory)

Creates a new GtkColumnViewColumn that uses the given factory for mapping items to widgets.

You most likely want to call ColumnView.appendColumn(org.gnome.gtk.ColumnViewColumn) next.

The function takes ownership of the argument, so you can write code like:

column = gtk_column_view_column_new (_("Name"),
   gtk_builder_list_item_factory_new_from_resource ("/name.ui"));
 

Parameters:

title - Title to use for this column

factory - The factory to populate items with

ColumnViewColumn

public ColumnViewColumn()

Creates a new ColumnViewColumn.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the ColumnViewColumn class

Returns:

the GType

asParent

protected ColumnViewColumn asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

getColumnView

public @Nullable ColumnView getColumnView()

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

If this ColumnViewColumn has not been added to a column view yet, NULL is returned.

Returns:

The column view displaying self.

getExpand

public boolean getExpand()

Returns whether this column should expand.

Returns:

true if this column expands

getFactory

public @Nullable ListItemFactory getFactory()

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

Returns:

The factory in use

getFixedWidth

public int getFixedWidth()

Gets the fixed width of the column.

Returns:

the fixed with of the column

getHeaderMenu

public @Nullable MenuModel getHeaderMenu()

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

Returns:

the GMenuModel

getId

public @Nullable String getId()

Returns the ID set with setId(java.lang.String).

Returns:

The column's ID

Since:

4.10

getResizable

public boolean getResizable()

Returns whether this column is resizable.

Returns:

true if this column is resizable

getSorter

public @Nullable Sorter getSorter()

Returns the sorter that is associated with the column.

Returns:

the GtkSorter of this ColumnViewColumn

getTitle

public @Nullable String getTitle()

Returns the title set with setTitle(java.lang.String).

Returns:

The column's title

getVisible

public boolean getVisible()

Returns whether this column is visible.

Returns:

true if this column is visible

setExpand

public void setExpand(boolean expand)

Sets the column to take available extra space.

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

Parameters:

expand - whether this column should expand to fill available space

setFactory

public void setFactory(@Nullable ListItemFactory factory)

Sets the GtkListItemFactory to use for populating list items for this column.

Parameters:

factory - the factory to use

setFixedWidth

public void setFixedWidth(int fixedWidth)

Sets the fixed width of the column.

If fixedWidth is -1, the fixed width of the column is unset.

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

Parameters:

fixedWidth - the new fixed width, or -1

setHeaderMenu

public void setHeaderMenu(@Nullable MenuModel menu)

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

Parameters:

menu - a GMenuModel

setId

public void setId(@Nullable String id)

Sets the id of this column.

GTK makes no use of this, but applications can use it when storing column view configuration.

It is up to callers to ensure uniqueness of IDs.

Parameters:

id - ID to use for this column

Since:

4.10

setResizable

public void setResizable(boolean resizable)

Sets whether this column should be resizable by dragging.

Parameters:

resizable - whether this column should be resizable

setSorter

public void setSorter(@Nullable Sorter sorter)

Associates a sorter with the column.

If sorter is unset, 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 ColumnView.sortByColumn(org.gnome.gtk.ColumnViewColumn, org.gnome.gtk.SortType).

See ColumnView.getSorter() for the necessary steps for setting up customizable sorting for ColumnView.

Parameters:

sorter - the GtkSorter to associate with column

setTitle

public void setTitle(@Nullable String title)

Sets the title of this column.

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

Parameters:

title - Title to use for this column

setVisible

public void setVisible(boolean visible)

Sets whether this column should be visible in views.

Parameters:

visible - whether this column should be visible

builder

public static ColumnViewColumn.Builder<? extends ColumnViewColumn.Builder> builder()

A ColumnViewColumn.Builder object constructs a ColumnViewColumn with the specified properties. Use the various set...() methods to set properties, and finish construction with ColumnViewColumn.Builder.build().

Returns:

the builder object