Google

logo top
Main Page   Widgets   Namespaces   Book  

Gtk::Frame Class Reference
[WidgetsContainer Widgets]

A Gtk::Bin with a decorative frame and optional label. More...

Inheritance diagram for Gtk::Frame:

Inheritance graph
[legend]
List of all members.

Public Methods

virtual ~Frame ()
GtkFrame* gobj ()
const GtkFrame* gobj () const
 Frame ()
 Frame (const Glib::ustring& label)
void set_label (const Glib::ustring& label)
 Set the label to appear in the top edge of the frame.

void unset_label ()
Glib::ustring get_label () const
 If the frame's label widget is a Gtk::Label, return the text in the label widget.

void set_label_widget (Widget& label_widget)
 Set the label widget for the frame.

Widgetget_label_widget ()
 Retrieves the label widget for the frame.

const Widgetget_label_widget () const
 Retrieves the label widget for the frame.

void set_label_align (float xalign=0.0, float yalign=0.5)
 Set the alignment of the Frame's label.

void set_label_align (AlignmentEnum xalign, AlignmentEnum yalign=Gtk::ALIGN_CENTER)
void get_label_align (float& xalign, float& yalign) const
 Retrieves the X and Y alignment of the frame's label.

void set_shadow_type (ShadowType type)
 Sets shadow type of the frame.

ShadowType get_shadow_type () const
 Retrieves the shadow type of the frame.

Glib::PropertyProxy<Glib::ustringproperty_label ()
Glib::PropertyProxy<double> property_label_xalign ()
Glib::PropertyProxy<double> property_label_yalign ()
Glib::PropertyProxy<ShadowTypeproperty_shadow_type ()
Glib::PropertyProxy<Widget*> property_label_widget ()

Protected Methods

virtual void compute_child_allocation_vfunc (GtkAllocation* allocation)

Related Functions

(Note that these are not member functions.)

Gtk::Frame* wrap (GtkFrame* object, bool take_copy=false)

Detailed Description

A Gtk::Bin with a decorative frame and optional label.

The Frame widget surrounds its single child with a decorative frame and an optional label. If present, the label is drawn in a gap in the top side of the frame. The position of the label can be controlled with set_label_align().


Constructor & Destructor Documentation

virtual Gtk::Frame::~Frame (   [virtual]
 

Gtk::Frame::Frame (  
 

Gtk::Frame::Frame ( const Glib::ustring   label [explicit]
 


Member Function Documentation

virtual void Gtk::Frame::compute_child_allocation_vfunc ( GtkAllocation*    allocation [protected, virtual]
 

Glib::ustring Gtk::Frame::get_label (   const
 

If the frame's label widget is a Gtk::Label, return the text in the label widget.

(The frame will have a Gtk::Label for the label widget if a non-0 argument was passed to new().)

Returns:
The text in the label, or 0 if there was no label widget or the lable widget was not a Gtk::Label. This string is owned by GTK+ and must not be modified or freed.

void Gtk::Frame::get_label_align ( float&    xalign,
float&    yalign
const
 

Retrieves the X and Y alignment of the frame's label.

See set_label_align().

Parameters:
xalign Location to store X alignment of frame's label, or 0.
yalign Location to store X alignment of frame's label, or 0.

const Widget* Gtk::Frame::get_label_widget (   const
 

Retrieves the label widget for the frame.

See set_label_widget().

Returns:
The label widget, or 0 if there is none.

Widget* Gtk::Frame::get_label_widget (  
 

Retrieves the label widget for the frame.

See set_label_widget().

Returns:
The label widget, or 0 if there is none.

ShadowType Gtk::Frame::get_shadow_type (   const
 

Retrieves the shadow type of the frame.

See set_shadow_type().

Returns:
The current shadow type of the frame.

const GtkFrame* Gtk::Frame::gobj (   const [inline]
 

Reimplemented from Gtk::Bin.

Reimplemented in Gtk::AspectFrame.

GtkFrame* Gtk::Frame::gobj (   [inline]
 

Reimplemented from Gtk::Bin.

Reimplemented in Gtk::AspectFrame.

Glib::PropertyProxy<Glib::ustring> Gtk::Frame::property_label (  
 

Glib::PropertyProxy<Widget*> Gtk::Frame::property_label_widget (  
 

Glib::PropertyProxy<double> Gtk::Frame::property_label_xalign (  
 

Glib::PropertyProxy<double> Gtk::Frame::property_label_yalign (  
 

Glib::PropertyProxy<ShadowType> Gtk::Frame::property_shadow_type (  
 

void Gtk::Frame::set_label ( const Glib::ustring   label
 

Set the label to appear in the top edge of the frame.

Label alignment defaults to the upper left corner of the frame.

void Gtk::Frame::set_label_align ( AlignmentEnum    xalign,
AlignmentEnum    yalign = Gtk::ALIGN_CENTER
 

void Gtk::Frame::set_label_align ( float    xalign = 0.0,
float    yalign = 0.5
 

Set the alignment of the Frame's label.

Parameters:
xalign The position of the label along the top edge of the widget. A value of 0.0 represents left alignment; 1.0 represents right alignment. The default value for a newly created Frame is 0.0.
yalign The y alignment of the label. Currently ignored.

void Gtk::Frame::set_label_widget ( Widget   label_widget
 

Set the label widget for the frame.

This is the widget that will appear embedded in the top edge of the frame as a title.

Parameters:
label_widget The new label widget.

void Gtk::Frame::set_shadow_type ( ShadowType    type
 

Sets shadow type of the frame.

void Gtk::Frame::unset_label (  
 


Friends And Related Function Documentation

Gtk::Frame* wrap ( GtkFrame*    object,
bool    take_copy = false
[related]
 


The documentation for this class was generated from the following file:
Generated for gtkmm by Doxygen 1.3-rc1 © 1997-2001