gtkTreeModelFilterSetVisibleFunc: gtkTreeModelFilterSetVisibleFunc

Description Usage Arguments Details Author(s)

View source: R/gtkFuncs.R

Description

Sets the visible function used when filtering the filter to be func. The function should return TRUE if the given row should be visible and FALSE otherwise.

Usage

1

Arguments

object

A GtkTreeModelFilter.

func

A GtkTreeModelFilterVisibleFunc, the visible function.

data

User data to pass to the visible function, or NULL. [ allow-none ]

Details

If the condition calculated by the function changes over time (e.g. because it depends on some global parameters), you must call gtkTreeModelFilterRefilter to keep the visibility information of the model uptodate.

Note that func is called whenever a row is inserted, when it may still be empty. The visible function should therefore take special care of empty rows, like in the example below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
visible_func <- function(model, iter, data)
{
  ## Visible if row is non-empty and first column is "HI"
  visible <- FALSE

  str <- model$get(iter, 0)[[1]]
  if (identical(str, "HI"))
    visible <- TRUE

  return(visible)
}

Since 2.4

Author(s)

Derived by RGtkGen from GTK+ documentation


RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.