CellView

A widget displaying a single row of a GtkTreeModel

A #GtkCellView displays a single row of a #GtkTreeModel using a #GtkCellArea and #GtkCellAreaContext. A #GtkCellAreaContext can be provided to the #GtkCellView at construction time in order to keep the cellview in context of a group of cell views, this ensures that the renderers displayed will be properly aligned with each other (like the aligned cells in the menus of #GtkComboBox).

#GtkCellView is #GtkOrientable in order to decide in which orientation the underlying #GtkCellAreaContext should be allocated. Taking the #GtkComboBox menu as an example, cellviews should be oriented horizontally if the menus are listed top-to-bottom and thus all share the same width but may have separate individual heights (left-to-right menus should be allocated vertically since they all share the same height but may have variable widths).

CSS nodes

GtkCellView has a single CSS node with name cellview.

Constructors

this this(GtkCellView* gtkCellView, bool ownedRef): Sets our main struct and passes it to the parent class.
this this(): Creates a new #GtkCellView widget.
this this(CellArea area, CellAreaContext context): Creates a new #GtkCellView widget with a specific #GtkCellArea to layout cells and a specific #GtkCellAreaContext.
this this(string markup): Creates a new #GtkCellView widget, adds a #GtkCellRendererText to it, and makes it show @markup. The text can be marked up with the [Pango text markup language]PangoMarkupFormat.
this this(Texture texture): Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf to it, and makes it show @texture.

Members

Functions

getCellViewStruct GtkCellView* getCellViewStruct(bool transferOwnership): Get the main Gtk struct
getDisplayedRow TreePath getDisplayedRow(): Returns a #GtkTreePath referring to the currently displayed row. If no row is currently displayed, %NULL is returned.
getDrawSensitive bool getDrawSensitive(): Gets whether @cell_view is configured to draw all of its cells in a sensitive state.
getFitModel bool getFitModel(): Gets whether @cell_view is configured to request space to fit the entire #GtkTreeModel.
getModel TreeModelIF getModel(): Returns the model for @cell_view. If no model is used %NULL is returned.
getStruct void* getStruct(): the main Gtk struct as a void*
setDisplayedRow void setDisplayedRow(TreePath path): Sets the row of the model that is currently displayed by the #GtkCellView. If the path is unset, then the contents of the cellview “stick” at their last value; this is not normally a desired result, but may be a needed intermediate state if say, the model for the #GtkCellView becomes temporarily empty.
setDrawSensitive void setDrawSensitive(bool drawSensitive): Sets whether @cell_view should draw all of its cells in a sensitive state, this is used by #GtkComboBox menus to ensure that rows with insensitive cells that contain children appear sensitive in the parent menu item.
setFitModel void setFitModel(bool fitModel): Sets whether @cell_view should request space to fit the entire #GtkTreeModel.
setModel void setModel(TreeModelIF model): Sets the model for @cell_view. If @cell_view already has a model set, it will remove it before setting the new model. If @model is %NULL, then it will unset the old model.

Mixins

__anonymous mixin CellLayoutT!(GtkCellView): Undocumented in source.
__anonymous mixin OrientableT!(GtkCellView): Undocumented in source.

Static functions

getType GType getType()

Variables

gtkCellView GtkCellView* gtkCellView;: the main Gtk struct

Inherited Members

gtkWidget GtkWidget* gtkWidget;: the main Gtk struct
getWidgetStruct GtkWidget* getWidgetStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
__anonymous mixin AccessibleT!(GtkWidget): Undocumented in source.
__anonymous mixin BuildableT!(GtkWidget): Undocumented in source.
__anonymous mixin ConstraintTargetT!(GtkWidget): Undocumented in source.
getType GType getType()
getDefaultDirection GtkTextDirection getDefaultDirection(): Obtains the current default reading direction.
setDefaultDirection void setDefaultDirection(GtkTextDirection dir): Sets the default reading direction for widgets.
actionSetEnabled void actionSetEnabled(string actionName, bool enabled): Enable or disable an action installed with gtk_widget_class_install_action().
activate bool activate(): For widgets that can be “activated” (buttons, menu items, etc.) this function activates them.
activateActionVariant bool activateActionVariant(string name, Variant args): Looks up the action in the action groups associated with @widget and its ancestors, and activates it.
activateDefault void activateDefault(): Activates the default.activate action from @widget.
addController void addController(EventController controller): Adds @controller to @widget so that it will receive events.
addCssClass void addCssClass(string cssClass): Adds a style class to @widget.
addMnemonicLabel void addMnemonicLabel(Widget label): Adds a widget to the list of mnemonic labels for this widget.
addTickCallback uint addTickCallback(GtkTickCallback callback, void* userData, GDestroyNotify notify): Queues an animation frame update and adds a callback to be called before each frame.
allocate void allocate(int width, int height, int baseline, Transform transform): This function is only used by GtkWidget subclasses, to assign a size, position and (optionally) baseline to their child widgets.
childFocus bool childFocus(GtkDirectionType direction): Called by widgets as the user moves around the window using keyboard shortcuts.
computeBounds bool computeBounds(Widget target, Rect outBounds): Computes the bounds for @widget in the coordinate space of @target.
computeExpand bool computeExpand(GtkOrientation orientation): Computes whether a container should give this widget extra space when possible.
computePoint bool computePoint(Widget target, Point point, Point outPoint): Translates the given @point in @widget's coordinates to coordinates relative to @target’s coordinate system.
computeTransform bool computeTransform(Widget target, Matrix outTransform): Computes a matrix suitable to describe a transformation from @widget's coordinate system into @target's coordinate system.
contains bool contains(double x, double y): Tests if the point at (@x, @y) is contained in @widget.
createPangoContext PgContext createPangoContext(): Creates a new PangoContext with the appropriate font map, font options, font description, and base direction for drawing text for this widget.
createPangoLayout PgLayout createPangoLayout(string text): Creates a new PangoLayout with the appropriate font map, font description, and base direction for drawing text for this widget.
dragCheckThreshold bool dragCheckThreshold(int startX, int startY, int currentX, int currentY): Checks to see if a drag movement has passed the GTK drag threshold.
errorBell void errorBell(): Notifies the user about an input-related error on this widget.
getAllocatedBaseline int getAllocatedBaseline(): Returns the baseline that has currently been allocated to @widget.
getAllocatedHeight int getAllocatedHeight(): Returns the height that has currently been allocated to @widget.
getAllocatedWidth int getAllocatedWidth(): Returns the width that has currently been allocated to @widget.
getAllocation void getAllocation(GtkAllocation allocation): Retrieves the widget’s allocation.
getAncestor Widget getAncestor(GType widgetType): Gets the first ancestor of @widget with type @widget_type.
getCanFocus bool getCanFocus(): Determines whether the input focus can enter @widget or any of its children.
getCanTarget bool getCanTarget(): Queries whether @widget can be the target of pointer events.
getChildVisible bool getChildVisible(): Gets the value set with gtk_widget_set_child_visible().
getClipboard Clipboard getClipboard(): Gets the clipboard object for @widget.
getCssClasses string[] getCssClasses(): Returns the list of style classes applied to @widget.
getCssName string getCssName(): Returns the CSS name that is used for @self.
getCursor Cursor getCursor(): Queries the cursor set on @widget.
getDirection GtkTextDirection getDirection(): Gets the reading direction for a particular widget.
getDisplay Display getDisplay(): Get the GdkDisplay for the toplevel window associated with this widget.
getFirstChild Widget getFirstChild(): Returns the widgets first child.
getFocusChild Widget getFocusChild(): Returns the current focus child of @widget.
getFocusOnClick bool getFocusOnClick(): Returns whether the widget should grab focus when it is clicked with the mouse.
getFocusable bool getFocusable(): Determines whether @widget can own the input focus.
getFontMap PgFontMap getFontMap(): Gets the font map of @widget.
getFontOptions FontOption getFontOptions(): Returns the cairo_font_options_t used for Pango rendering.
getFrameClock FrameClock getFrameClock(): Obtains the frame clock for a widget.
getHalign GtkAlign getHalign(): Gets the horizontal alignment of @widget.
getHasTooltip bool getHasTooltip(): Returns the current value of the has-tooltip property.
getHeight int getHeight(): Returns the content height of the widget.
getHexpand bool getHexpand(): Gets whether the widget would like any available extra horizontal space.
getHexpandSet bool getHexpandSet(): Gets whether gtk_widget_set_hexpand() has been used to explicitly set the expand flag on this widget.
getLastChild Widget getLastChild(): Returns the widgets last child.
getLayoutManager LayoutManager getLayoutManager(): Retrieves the layout manager used by @widget
getMapped bool getMapped(): Whether the widget is mapped.
getMarginBottom int getMarginBottom(): Gets the bottom margin of @widget.
getMarginEnd int getMarginEnd(): Gets the end margin of @widget.
getMarginStart int getMarginStart(): Gets the start margin of @widget.
getMarginTop int getMarginTop(): Gets the top margin of @widget.
getName string getName(): Retrieves the name of a widget.
getNative NativeIF getNative(): Returns the GtkNative widget that contains @widget.
getNextSibling Widget getNextSibling(): Returns the widgets next sibling.
getOpacity double getOpacity(): #Fetches the requested opacity for this widget.
getOverflow GtkOverflow getOverflow(): Returns the widgets overflow value.
getPangoContext PgContext getPangoContext(): Gets a PangoContext with the appropriate font map, font description, and base direction for this widget.
getParent Widget getParent(): Returns the parent widget of @widget.
getPreferredSize void getPreferredSize(Requisition minimumSize, Requisition naturalSize): Retrieves the minimum and natural size of a widget, taking into account the widget’s preference for height-for-width management.
getPrevSibling Widget getPrevSibling(): Returns the widgets previous sibling.
getPrimaryClipboard Clipboard getPrimaryClipboard(): Gets the primary clipboard of @widget.
getRealized bool getRealized(): Determines whether @widget is realized.
getReceivesDefault bool getReceivesDefault(): Determines whether @widget is always treated as the default widget within its toplevel when it has the focus, even if another widget is the default.
getRequestMode GtkSizeRequestMode getRequestMode(): Gets whether the widget prefers a height-for-width layout or a width-for-height layout.
getRoot RootIF getRoot(): Returns the GtkRoot widget of @widget.
getScaleFactor int getScaleFactor(): Retrieves the internal scale factor that maps from window coordinates to the actual device pixels.
getSensitive bool getSensitive(): Returns the widget’s sensitivity.
getSettings Settings getSettings(): Gets the settings object holding the settings used for this widget.
getSize int getSize(GtkOrientation orientation): Returns the content width or height of the widget.
getSizeRequest void getSizeRequest(int width, int height): Gets the size request that was explicitly set for the widget using gtk_widget_set_size_request().
getStateFlags GtkStateFlags getStateFlags(): Returns the widget state as a flag set.
getStyleContext StyleContext getStyleContext(): Returns the style context associated to @widget.
getTemplateChild ObjectG getTemplateChild(GType widgetType, string name): Fetch an object build from the template XML for @widget_type in this @widget instance.
getTooltipMarkup string getTooltipMarkup(): Gets the contents of the tooltip for @widget.
getTooltipText string getTooltipText(): Gets the contents of the tooltip for @widget.
getValign GtkAlign getValign(): Gets the vertical alignment of @widget.
getVexpand bool getVexpand(): Gets whether the widget would like any available extra vertical space.
getVexpandSet bool getVexpandSet(): Gets whether gtk_widget_set_vexpand() has been used to explicitly set the expand flag on this widget.
getVisible bool getVisible(): Determines whether the widget is visible.
getWidth int getWidth(): Returns the content width of the widget.
grabFocus bool grabFocus(): Causes @widget to have the keyboard focus for the GtkWindow it's inside.
hasCssClass bool hasCssClass(string cssClass): Returns whether @css_class is currently applied to @widget.
hasDefault bool hasDefault(): Determines whether @widget is the current default widget within its toplevel.
hasFocus bool hasFocus(): Determines if the widget has the global input focus.
hasVisibleFocus bool hasVisibleFocus(): Determines if the widget should show a visible indication that it has the global input focus.
hide void hide(): Reverses the effects of gtk_widget_show().
inDestruction bool inDestruction(): Returns whether the widget is currently being destroyed.
initTemplate void initTemplate(): Creates and initializes child widgets defined in templates.
insertActionGroup void insertActionGroup(string name, ActionGroupIF group): Inserts @group into @widget.
insertAfter void insertAfter(Widget parent, Widget previousSibling): Inserts @widget into the child widget list of @parent.
insertBefore void insertBefore(Widget parent, Widget nextSibling): Inserts @widget into the child widget list of @parent.
isAncestor bool isAncestor(Widget ancestor): Determines whether @widget is somewhere inside @ancestor, possibly with intermediate containers.
isDrawable bool isDrawable(): Determines whether @widget can be drawn to.
isFocus bool isFocus(): Determines if the widget is the focus widget within its toplevel.
isSensitive bool isSensitive(): Returns the widget’s effective sensitivity.
isVisible bool isVisible(): Determines whether the widget and all its parents are marked as visible.
keynavFailed bool keynavFailed(GtkDirectionType direction): Emits the ::keynav-failed signal on the widget.
listMnemonicLabels ListG listMnemonicLabels(): Returns the widgets for which this widget is the target of a mnemonic.
map void map(): Causes a widget to be mapped if it isn’t already.
measure void measure(GtkOrientation orientation, int forSize, int minimum, int natural, int minimumBaseline, int naturalBaseline): Measures @widget in the orientation @orientation and for the given @for_size.
mnemonicActivate bool mnemonicActivate(bool groupCycling): Emits the GtkWidget::mnemonic-activate signal.
observeChildren ListModelIF observeChildren(): Returns a GListModel to track the children of @widget.
observeControllers ListModelIF observeControllers(): Returns a GListModel to track the [class@Gtk.EventController]s of @widget.
pick Widget pick(double x, double y, GtkPickFlags flags): Finds the descendant of @widget closest to the screen at the point (@x, @y).
queueAllocate void queueAllocate(): Flags the widget for a rerun of the GtkWidgetClass::size_allocate function.
queueDraw void queueDraw(): Schedules this widget to be redrawn in paint phase of the current or the next frame.
queueResize void queueResize(): Flags a widget to have its size renegotiated.
realize void realize(): Creates the GDK resources associated with a widget.
removeController void removeController(EventController controller): Removes @controller from @widget, so that it doesn't process events anymore.
removeCssClass void removeCssClass(string cssClass): Removes a style from @widget.
removeMnemonicLabel void removeMnemonicLabel(Widget label): Removes a widget from the list of mnemonic labels for this widget.
removeTickCallback void removeTickCallback(uint id): Removes a tick callback previously registered with gtk_widget_add_tick_callback().
setCanFocus void setCanFocus(bool canFocus): Specifies whether the input focus can enter the widget or any of its children.
setCanTarget void setCanTarget(bool canTarget): Sets whether @widget can be the target of pointer events.
setChildVisible void setChildVisible(bool childVisible): Sets whether @widget should be mapped along with its parent.
setCssClasses void setCssClasses(string[] classes): Will clear all style classes applied to @widget and replace them with @classes.
setCursor void setCursor(Cursor cursor): Sets the cursor to be shown when pointer devices point towards @widget.
setCursorFromName void setCursorFromName(string name): Sets a named cursor to be shown when pointer devices point towards @widget.
setDirection void setDirection(GtkTextDirection dir): Sets the reading direction on a particular widget.
setFocusChild void setFocusChild(Widget child): Set @child as the current focus child of @widget.
setFocusOnClick void setFocusOnClick(bool focusOnClick): Sets whether the widget should grab focus when it is clicked with the mouse.
setFocusable void setFocusable(bool focusable): Specifies whether @widget can own the input focus.
setFontMap void setFontMap(PgFontMap fontMap): Sets the font map to use for Pango rendering.
setFontOptions void setFontOptions(FontOption options): Sets the cairo_font_options_t used for Pango rendering in this widget.
setHalign void setHalign(GtkAlign align_): Sets the horizontal alignment of @widget.
setHasTooltip void setHasTooltip(bool hasTooltip): Sets the has-tooltip property on @widget to @has_tooltip.
setHexpand void setHexpand(bool expand): Sets whether the widget would like any available extra horizontal space.
setHexpandSet void setHexpandSet(bool set): Sets whether the hexpand flag will be used.
setLayoutManager void setLayoutManager(LayoutManager layoutManager): Sets the layout manager delegate instance that provides an implementation for measuring and allocating the children of @widget.
setMarginBottom void setMarginBottom(int margin): Sets the bottom margin of @widget.
setMarginEnd void setMarginEnd(int margin): Sets the end margin of @widget.
setMarginStart void setMarginStart(int margin): Sets the start margin of @widget.
setMarginTop void setMarginTop(int margin): Sets the top margin of @widget.
setName void setName(string name): Sets a widgets name.
setOpacity void setOpacity(double opacity): Request the @widget to be rendered partially transparent.
setOverflow void setOverflow(GtkOverflow overflow): Sets how @widget treats content that is drawn outside the widget's content area.
setParent void setParent(Widget parent): Sets @parent as the parent widget of @widget.
setReceivesDefault void setReceivesDefault(bool receivesDefault): Specifies whether @widget will be treated as the default widget within its toplevel when it has the focus, even if another widget is the default.
setSensitive void setSensitive(bool sensitive): Sets the sensitivity of a widget.
setSizeRequest void setSizeRequest(int width, int height): Sets the minimum size of a widget.
setStateFlags void setStateFlags(GtkStateFlags flags, bool clear): Turns on flag values in the current widget state.
setTooltipMarkup void setTooltipMarkup(string markup): Sets @markup as the contents of the tooltip, which is marked up with Pango markup.
setTooltipText void setTooltipText(string text): Sets @text as the contents of the tooltip.
setValign void setValign(GtkAlign align_): Sets the vertical alignment of @widget.
setVexpand void setVexpand(bool expand): Sets whether the widget would like any available extra vertical space.
setVexpandSet void setVexpandSet(bool set): Sets whether the vexpand flag will be used.
setVisible void setVisible(bool visible): Sets the visibility state of @widget.
shouldLayout bool shouldLayout(): Returns whether @widget should contribute to the measuring and allocation of its parent.
show void show(): Flags a widget to be displayed.
sizeAllocate void sizeAllocate(GtkAllocation* allocation, int baseline): Allocates widget with a transformation that translates the origin to the position in @allocation.
snapshotChild void snapshotChild(Widget child, Snapshot snapshot): Snapshot the a child of @widget.
translateCoordinates bool translateCoordinates(Widget destWidget, double srcX, double srcY, double destX, double destY): Translate coordinates relative to @src_widget’s allocation to coordinates relative to @dest_widget’s allocations.
triggerTooltipQuery void triggerTooltipQuery(): Triggers a tooltip query on the display where the toplevel of @widget is located.
unmap void unmap(): Causes a widget to be unmapped if it’s currently mapped.
unparent void unparent(): Dissociate @widget from its parent.
unrealize void unrealize(): Causes a widget to be unrealized (frees all GDK resources associated with the widget).
unsetStateFlags void unsetStateFlags(GtkStateFlags flags): Turns off flag values for the current widget state.
addOnDestroy gulong addOnDestroy(void delegate(Widget) dlg, ConnectFlags connectFlags): Signals that all holders of a reference to the widget should release the reference that they hold.
addOnDirectionChanged gulong addOnDirectionChanged(void delegate(GtkTextDirection, Widget) dlg, ConnectFlags connectFlags): Emitted when the text direction of a widget changes.
addOnHide gulong addOnHide(void delegate(Widget) dlg, ConnectFlags connectFlags): Emitted when @widget is hidden.
addOnKeynavFailed gulong addOnKeynavFailed(bool delegate(GtkDirectionType, Widget) dlg, ConnectFlags connectFlags): Emitted if keyboard navigation fails.
addOnMap gulong addOnMap(void delegate(Widget) dlg, ConnectFlags connectFlags): Emitted when @widget is going to be mapped.
addOnMnemonicActivate gulong addOnMnemonicActivate(bool delegate(bool, Widget) dlg, ConnectFlags connectFlags): Emitted when a widget is activated via a mnemonic.
addOnMoveFocus gulong addOnMoveFocus(void delegate(GtkDirectionType, Widget) dlg, ConnectFlags connectFlags): Emitted when the focus is moved.
addOnQueryTooltip gulong addOnQueryTooltip(bool delegate(int, int, bool, Tooltip, Widget) dlg, ConnectFlags connectFlags): Emitted when the widgets tooltip is about to be shown.
addOnRealize gulong addOnRealize(void delegate(Widget) dlg, ConnectFlags connectFlags): Emitted when @widget is associated with a GdkSurface.
addOnShow gulong addOnShow(void delegate(Widget) dlg, ConnectFlags connectFlags): Emitted when @widget is shown.
addOnStateFlagsChanged gulong addOnStateFlagsChanged(void delegate(GtkStateFlags, Widget) dlg, ConnectFlags connectFlags): Emitted when the widget state changes.
addOnUnmap gulong addOnUnmap(void delegate(Widget) dlg, ConnectFlags connectFlags): Emitted when @widget is going to be unmapped.
addOnUnrealize gulong addOnUnrealize(void delegate(Widget) dlg, ConnectFlags connectFlags): Emitted when the GdkSurface associated with @widget is destroyed.

From CellLayoutIF

getCellLayoutStruct GtkCellLayout* getCellLayoutStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
getType GType getType()
addAttribute void addAttribute(CellRenderer cell, string attribute, int column): Adds an attribute mapping to the list in @cell_layout.
clear void clear(): Unsets all the mappings on all renderers on @cell_layout and removes all renderers from @cell_layout.
clearAttributes void clearAttributes(CellRenderer cell): Clears all existing attributes previously set with gtk_cell_layout_set_attributes().
getArea CellArea getArea(): Returns the underlying #GtkCellArea which might be @cell_layout if called on a #GtkCellArea or might be %NULL if no #GtkCellArea is used by @cell_layout.
getCells ListG getCells(): Returns the cell renderers which have been added to @cell_layout.
packEnd void packEnd(CellRenderer cell, bool expand): Adds the @cell to the end of @cell_layout. If @expand is %FALSE, then the @cell is allocated no more space than it needs. Any unused space is divided evenly between cells for which @expand is %TRUE.
packStart void packStart(CellRenderer cell, bool expand): Packs the @cell into the beginning of @cell_layout. If @expand is %FALSE, then the @cell is allocated no more space than it needs. Any unused space is divided evenly between cells for which @expand is %TRUE.
reorder void reorder(CellRenderer cell, int position): Re-inserts @cell at @position.
setCellDataFunc void setCellDataFunc(CellRenderer cell, GtkCellLayoutDataFunc func, void* funcData, GDestroyNotify destroy): Sets the #GtkCellLayoutDataFunc to use for @cell_layout.

From OrientableIF

getOrientableStruct GtkOrientable* getOrientableStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
getType GType getType()
getOrientation GtkOrientation getOrientation(): Retrieves the orientation of the @orientable.
setOrientation void setOrientation(GtkOrientation orientation): Sets the orientation of the @orientable.