Interface CellRenderer.EditingStartedCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

CellRenderer

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public static interface CellRenderer.EditingStartedCallback
extends FunctionPointer

Functional interface declaration of the EditingStartedCallback callback.

See Also:

• run(CellEditable, String)

Method Summary

Modifier and Type	Method	Description
void	run(@Nullable CellEditable editable, String path)	This signal gets emitted when a cell starts to be edited.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment) method.
default void	upcall(MemorySegment sourceCellRenderer, MemorySegment editable, MemorySegment path)	The upcall method is called from native code.

Method Details

run

void run(@Nullable CellEditable editable,
 String path)

This signal gets emitted when a cell starts to be edited. The intended use of this signal is to do special setup on editable, e.g. adding a GtkEntryCompletion or setting up additional columns in a GtkComboBox.

See gtk_cell_editable_start_editing() for information on the lifecycle of the editable and a way to do setup that doesn’t depend on the renderer.

Note that GTK doesn't guarantee that cell renderers will continue to use the same kind of widget for editing in future releases, therefore you should check the type of editable before doing any specific setup, as in the following example:

static void
text_editing_started (GtkCellRenderer *cell,
                      GtkCellEditable *editable,
                      const char      *path,
                      gpointer         data)
{
  if (GTK_IS_ENTRY (editable))
    {
      GtkEntry *entry = GTK_ENTRY (editable);

      // ... create a GtkEntryCompletion

      gtk_entry_set_completion (entry, completion);
    }
}

upcall

default void upcall(MemorySegment sourceCellRenderer,
 MemorySegment editable,
 MemorySegment path)

The upcall method is called from native code. The parameters are marshaled and run(CellEditable, String) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment) method.

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the arena in which the function pointer is allocated

Returns:

the native function pointer