CellRendererText

Description A GtkCellRendererText renders a given text in its cell, using the font, color and style information provided by its properties. The text will be ellipsized if it is too long and the ellipsize property allows it. If the mode is GTK_CELL_RENDERER_MODE_EDITABLE, the GtkCellRendererText allows to edit its text using an entry.

Constructors

this
this(GtkCellRendererText* gtkCellRendererText)

Sets our main struct and passes it to the parent class

this
this()

Creates a new GtkCellRendererText. Adjust how text is drawn using object properties. Object properties can be set globally (with g_object_set()). Also, with GtkTreeViewColumn, you can bind a property to a value in a GtkTreeModel. For example, you can bind the "text" property on the cell renderer to a string value in the model, thus rendering a different string in each row of the GtkTreeView

Members

Functions

addOnEdited
void addOnEdited(void delegate(string, string, CellRendererText) dlg, ConnectFlags connectFlags)

This signal is emitted after renderer has been edited. It is the responsibility of the application to update the model and store new_text at the position indicated by path.

getCellRendererTextStruct
GtkCellRendererText* getCellRendererTextStruct()
Undocumented in source. Be warned that the author may not have intended to support it.
getStruct
void* getStruct()

the main Gtk struct as a void*

setFixedHeightFromFont
void setFixedHeightFromFont(int numberOfRows)

Sets the height of a renderer to explicitly be determined by the "font" and "y_pad" property set on it. Further changes in these properties do not affect the height, so they must be accompanied by a subsequent call to this function. Using this function is unflexible, and should really only be used if calculating the size of a cell is too slow (ie, a massive number of cells displayed). If number_of_rows is -1, then the fixed height is unset, and the height is determined by the properties again.

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.

Static functions

callBackEdited
void callBackEdited(GtkCellRendererText* rendererStruct, gchar* path, gchar* newText, CellRendererText _cellRendererText)
Undocumented in source. Be warned that the author may not have intended to support it.

Variables

connectedSignals
int[string] connectedSignals;
gtkCellRendererText
GtkCellRendererText* gtkCellRendererText;

the main Gtk struct

onEditedListeners
void delegate(string, string, CellRendererText)[] onEditedListeners;
Undocumented in source.

Inherited Members

From CellRenderer

gtkCellRenderer
GtkCellRenderer* gtkCellRenderer;

the main Gtk struct

getCellRendererStruct
GtkCellRenderer* getCellRendererStruct()
Undocumented in source. Be warned that the author may not have intended to support it.
getStruct
void* getStruct()

the main Gtk struct as a void*

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.
connectedSignals
int[string] connectedSignals;
onEditingCanceledListeners
void delegate(CellRenderer)[] onEditingCanceledListeners;
Undocumented in source.
addOnEditingCanceled
void addOnEditingCanceled(void delegate(CellRenderer) dlg, ConnectFlags connectFlags)

This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape. See also: gtk_cell_renderer_stop_editing(). Since 2.4

callBackEditingCanceled
void callBackEditingCanceled(GtkCellRenderer* rendererStruct, CellRenderer _cellRenderer)
Undocumented in source. Be warned that the author may not have intended to support it.
onEditingStartedListeners
void delegate(CellEditableIF, string, CellRenderer)[] onEditingStartedListeners;
Undocumented in source.
addOnEditingStarted
void addOnEditingStarted(void delegate(CellEditableIF, string, CellRenderer) dlg, ConnectFlags connectFlags)

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. 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 Since 2.6 See Also GtkCellRendererText,GtkCellRendererPixbuf,GtkCellRendererToggle

callBackEditingStarted
void callBackEditingStarted(GtkCellRenderer* rendererStruct, GtkCellEditable* editable, gchar* path, CellRenderer _cellRenderer)
Undocumented in source. Be warned that the author may not have intended to support it.
getSize
void getSize(Widget widget, Rectangle cellArea, int xOffset, int yOffset, int width, int height)

Obtains the width and height needed to render the cell. Used by view widgets to determine the appropriate size for the cell_area passed to gtk_cell_renderer_render(). If cell_area is not NULL, fills in the x and y offsets (if set) of the cell relative to this location. Please note that the values set in width and height, as well as those in x_offset and y_offset are inclusive of the xpad and ypad properties.

render
void render(Window window, Widget widget, Rectangle backgroundArea, Rectangle cellArea, Rectangle exposeArea, GtkCellRendererState flags)

Invokes the virtual render function of the GtkCellRenderer. The three passed-in rectangles are areas of window. Most renderers will draw within cell_area; the xalign, yalign, xpad, and ypad fields of the GtkCellRenderer should be honored with respect to cell_area. background_area includes the blank space around the cell, and also the area containing the tree expander; so the background_area rectangles for all cells tile to cover the entire window. expose_area is a clip rectangle.

activate
int activate(Event event, Widget widget, string path, Rectangle backgroundArea, Rectangle cellArea, GtkCellRendererState flags)

Passes an activate event to the cell renderer for possible processing. Some cell renderers may use events; for example, GtkCellRendererToggle toggles when it gets a mouse click.

startEditing
CellEditableIF startEditing(Event event, Widget widget, string path, Rectangle backgroundArea, Rectangle cellArea, GtkCellRendererState flags)

Passes an activate event to the cell renderer for possible processing.

editingCanceled
void editingCanceled()

Warning gtk_cell_renderer_editing_canceled has been deprecated since version 2.6 and should not be used in newly-written code. Use gtk_cell_renderer_stop_editing() instead Causes the cell renderer to emit the "editing-canceled" signal. This function is for use only by implementations of cell renderers that need to notify the client program that an editing process was canceled and the changes were not committed. Since 2.4

stopEditing
void stopEditing(int canceled)

Informs the cell renderer that the editing is stopped. If canceled is TRUE, the cell renderer will emit the "editing-canceled" signal. This function should be called by cell renderer implementations in response to the "editing-done" signal of GtkCellEditable. Since 2.6

getFixedSize
void getFixedSize(int width, int height)

Fills in width and height with the appropriate size of cell.

setFixedSize
void setFixedSize(int width, int height)

Sets the renderer size to be explicit, independent of the properties set.

getVisible
int getVisible()

Returns the cell renderer's visibility. Since 2.18

setVisible
void setVisible(int visible)

Sets the cell renderer's visibility. Since 2.18

getSensitive
int getSensitive()

Returns the cell renderer's sensitivity. Since 2.18

setSensitive
void setSensitive(int sensitive)

Sets the cell renderer's sensitivity. Since 2.18

getAlignment
void getAlignment(float xalign, float yalign)

Fills in xalign and yalign with the appropriate values of cell. Since 2.18

setAlignment
void setAlignment(float xalign, float yalign)

Sets the renderer's alignment within its available space. Since 2.18

getPadding
void getPadding(int xpad, int ypad)

Fills in xpad and ypad with the appropriate values of cell. Since 2.18

setPadding
void setPadding(int xpad, int ypad)

Sets the renderer's padding. Since 2.18

Meta