Xfce Foundation Classes
Main Page  | IndexNamespace List  |  Alphabetical List  |  Class List  |  File List


Public Member Functions | Static Protected Attributes
Xfc::Gtk::CellRendererText Class Reference

A GtkCellRendererText C++ wrapper class. More...

#include <xfc/gtk/cellrenderertext.hh>

Inheritance diagram for Xfc::Gtk::CellRendererText:
Xfc::Gtk::CellRenderer Xfc::Gtk::Object Xfc::G::Object Xfc::G::TypeInstance Xfc::Trackable Xfc::Gtk::CellRendererCombo

List of all members.

Public Member Functions

Static Protected Attributes

Constructors


Detailed Description

A GtkCellRendererText C++ wrapper class.


Constructor & Destructor Documentation

Xfc::Gtk::CellRendererText::CellRendererText ( GtkCellRendererText *  cell,
bool  owns_reference = false 
) [explicit, protected]

Construct a new CellRendererText from an existing GtkCellRendererText.

Parameters:
cellA pointer to a GtkCellRendererText.
owns_referenceSet false if the initial reference count is floating, set true if it's not.

The cell can be a newly created GtkCellRendererText or an existing GtkCellRendererText. (see G::Object::Object).

Xfc::Gtk::CellRendererText::CellRendererText ( )

Construct a new CellRendererText.

You can adjust how text is drawn using object properties. Also, with TreeViewColumn, you can bind a property to a value in a TreeModel. 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 TreeView.


Member Function Documentation

const AttributePropertyProxy Xfc::Gtk::CellRendererText::property_attribute ( )

A list of style attributes to apply to the text of the renderer (Pointer<Pango::AttrList> : Read / Write).

const EllipsizePropertyProxy Xfc::Gtk::CellRendererText::property_ellipsize ( )

The preferred place to ellipsize the string, if the cell renderer does not have enough room to display the entire string, if at all.

const LanguagePropertyProxy Xfc::Gtk::CellRendererText::property_language ( )

The language this text is in, as an ISO code (String : Read / Write).

Pango can use this as a hint when rendering the text. If you don't understand this property, you probably don't need it.

Sets the height of a renderer to explicitly be determined by the "font" and the "y_pad" property set on it.

Parameters:
number_of_rowsNumber of rows of text each cell renderer is allocated, or -1

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.


Member Data Documentation

Edited signal (see signal_edited()).

Calls a slot with the signature:

< void function(const String& path, const String& new_text);
< // path: Widget-dependent string representation of the event location;
<          e.g. for TreeView, a string representation of TreePath.
< // new_text: The newly edited text.
<
const EllipsizePropertyType Xfc::Gtk::CellRendererText::ellipsize_property [static, protected]

The preferred place to ellipsize the string, if the cell renderer does not have enough room to display the entire string, if at all (see property_ellipsize()).


The documentation for this class was generated from the following file:
Xfce Foundation Classes
Copyright © 2004-2005 The XFC Development Team XFC