class: GtkTreeRowReferenceCtors

[162:14] static extends: object

Alternate constructors for GtkTreeRowReference. Usage: GtkTreeRowReferenceCtors.<name>(...). The primary constructor lives directly on GtkTreeRowReference.

Methods

newProxy (object proxy, object model, object path)

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.
- @p proxy is a proxy GObject.
- @p model is a GtkTreeModel.
- @p path is a valid GtkTreePath to monitor.
- @r A new GtkTreeRowReference.

class: GtkTreeRowReference

[14:7] extends: object

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().

Members

handleObj
lib
retainedCallbacks
signalHandlerNames
signalSetterHandlers

Methods

GtkTreeRowReference (model = null, path = null)

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.
- @p model is a GtkTreeModel.
- @p path is a valid GtkTreePath to monitor.
toNativeHandle (Source)

Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.
- @p Source is the raw handle, raw buffer, wrapper, or null.
- @r A raw pointer carrier or null when no pointer is present.
getLib ()

Returns the opened native library for this generated wrapper.
- @r The opened native library.
handle ()

Returns the wrapped NativeHandle.
- @r The wrapped NativeHandle.
isNull ()

Returns true when the wrapped handle is null.
- @r A bool.
describe ()

Returns a small string for debugging generated wrappers.
- @r A string.
copy ()

Copies a GtkTreeRowReference.
- @r a copy of @reference.
free ()

Free’s @reference. @reference may be %NULL
- @r None.
get_model ()

Returns the model that the row reference is monitoring.
- @r the model.
get_path ()

Returns a path that the row reference currently points to, or %NULL if the path pointed to is no longer valid.
- @r a current path.
valid ()

Returns %TRUE if the @reference is non-%NULL and refers to a current valid path.
- @r %TRUE if @reference points to a valid path.