BuilderListItemFactory

class BuilderListItemFactory(**properties: Any)

Superclasses: ListItemFactory, Object

GtkBuilderListItemFactory is a GtkListItemFactory that creates widgets by instantiating GtkBuilder UI templates.

The templates must be extending GtkListItem, and typically use GtkExpression’s to obtain data from the items in the model.

Example:

<interface>
  <template class="GtkListItem">
    <property name="child">
      <object class="GtkLabel">
        <property name="xalign">0</property>
        <binding name="label">
          <lookup name="name" type="SettingsKey">
            <lookup name="item">GtkListItem</lookup>
          </lookup>
        </binding>
      </object>
    </property>
  </template>
</interface>

Constructors

class BuilderListItemFactory
classmethod new_from_bytes(scope: BuilderScope | None, bytes: Bytes) ListItemFactory

Creates a new GtkBuilderListItemFactory that instantiates widgets using bytes as the data to pass to GtkBuilder.

Parameters:
  • scope – A scope to use when instantiating

  • bytes – the GBytes containing the ui file to instantiate

classmethod new_from_resource(scope: BuilderScope | None, resource_path: str) ListItemFactory

Creates a new GtkBuilderListItemFactory that instantiates widgets using data read from the given resource_path to pass to GtkBuilder.

Parameters:
  • scope – A scope to use when instantiating

  • resource_path – valid path to a resource that contains the data

Methods

class BuilderListItemFactory
get_bytes() Bytes

Gets the data used as the GtkBuilder UI template for constructing listitems.

get_resource() str | None

If the data references a resource, gets the path of that resource.

get_scope() BuilderScope | None

Gets the scope used when constructing listitems.

Properties

class BuilderListItemFactory
props.bytes: Bytes

GBytes containing the UI definition.

props.resource: str

Path of the resource containing the UI definition.

props.scope: BuilderScope

GtkBuilderScope to use when instantiating listitems