Package org.gnome.gtk

Class TreeRowReference

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gtk.TreeRowReference

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
@Deprecated
public class TreeRowReference
extends ProxyInstance

Deprecated.

Use ListModel instead

A GtkTreeRowReference tracks model changes so that it always refers to the same row (a GtkTreePath refers to a position, not a fixed row). Create a new GtkTreeRowReference with gtk_tree_row_reference_new().

Constructor Summary

Constructors

Constructor	Description
TreeRowReference(MemorySegment address)	Deprecated. Create a TreeRowReference proxy instance for the provided memory address.
TreeRowReference(TreeModel model, TreePath path)	Deprecated.

Method Summary

Modifier and Type	Method	Description
TreeRowReference	copy()	Deprecated.
static void	deleted(GObject proxy, TreePath path)	Deprecated.
void	free()	Deprecated.
TreeModel	getModel()	Deprecated.
@Nullable TreePath	getPath()	Deprecated.
static @Nullable Type	getType()	Deprecated. Get the GType of the TreeRowReference class
static void	inserted(GObject proxy, TreePath path)	Deprecated.
static TreeRowReference	proxy(GObject proxy, TreeModel model, TreePath path)	Deprecated.
static void	reordered(GObject proxy, TreePath path, TreeIter iter, @org.jspecify.annotations.Nullable int @Nullable [] newOrder)	Deprecated.
boolean	valid()	Deprecated.

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

TreeRowReference

public TreeRowReference(MemorySegment address)

Deprecated.

Create a TreeRowReference proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

TreeRowReference

@Deprecated
public TreeRowReference(TreeModel model,
 TreePath path)

Deprecated.

Creates a row reference based on path.

This reference will keep pointing to the node pointed to by path, so long as it exists. Any changes that occur on model are propagated, and the path is updated appropriately. If path isn’t a valid path in model, then null is returned.

Parameters:

model - a GtkTreeModel

path - a valid GtkTreePath to monitor

Method Details

getType

public static @Nullable Type getType()

Deprecated.

Get the GType of the TreeRowReference class

Returns:

the GType

proxy

@Deprecated
public static TreeRowReference proxy(GObject proxy,
 TreeModel model,
 TreePath path)

Deprecated.

You do not need to use this function.

Creates a row reference based on path.

This reference will keep pointing to the node pointed to by path, so long as it exists. If path isn’t a valid path in model, then null is returned. However, unlike references created with gtk_tree_row_reference_new(), it does not listen to the model for changes. The creator of the row reference must do this explicitly using gtk_tree_row_reference_inserted(), gtk_tree_row_reference_deleted(), gtk_tree_row_reference_reordered().

These functions must be called exactly once per proxy when the corresponding signal on the model is emitted. This single call updates all row references for that proxy. Since built-in GTK objects like GtkTreeView already use this mechanism internally, using them as the proxy object will produce unpredictable results. Further more, passing the same object as model and proxy doesn’t work for reasons of internal implementation.

This type of row reference is primarily meant by structures that need to carefully monitor exactly when a row reference updates itself, and is not generally needed by most applications.

Parameters:

proxy - a proxy GObject

model - a GtkTreeModel

path - a valid GtkTreePath to monitor

Returns:

a newly allocated GtkTreeRowReference

deleted

@Deprecated
public static void deleted(GObject proxy,
 TreePath path)

Deprecated.

Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the ::row-deleted signal.

Parameters:

proxy - a GObject

path - the path position that was deleted

inserted

@Deprecated
public static void inserted(GObject proxy,
 TreePath path)

Deprecated.

Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the ::row-inserted signal.

Parameters:

proxy - a GObject

path - the row position that was inserted

reordered

@Deprecated
public static void reordered(GObject proxy,
 TreePath path,
 TreeIter iter,
 @org.jspecify.annotations.Nullable int @Nullable [] newOrder)

Deprecated.

Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the ::rows-reordered signal.

Parameters:

proxy - a GObject

path - the parent path of the reordered signal

iter - the iter pointing to the parent of the reordered

newOrder - the new order of rows

copy

@Deprecated
public TreeRowReference copy()

Deprecated.

Copies a GtkTreeRowReference.

Returns:

a copy of this TreeRowReference

free

@Deprecated
public void free()

Deprecated.

Free’s reference. this TreeRowReference may be null

getModel

@Deprecated
public TreeModel getModel()

Deprecated.

Returns the model that the row reference is monitoring.

Returns:

the model

getPath

@Deprecated
public @Nullable TreePath getPath()

Deprecated.

Returns a path that the row reference currently points to, or null if the path pointed to is no longer valid.

Returns:

a current path

valid

@Deprecated
public boolean valid()

Deprecated.

Returns true if the this TreeRowReference is non-null and refers to a current valid path.

Returns:

true if this TreeRowReference points to a valid path