logo top
Main Page   Widgets   Namespaces   Book  

Gtk::Frame Class Reference
[WidgetsContainer Widgets]

Inheritance diagram for Gtk::Frame:

Inheritance graph
[legend]
List of all members.

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().


Public Member Functions

virtual ~Frame ()
GtkFrame* gobj ()
 Provides access to the underlying C GtkObject.

const GtkFrame* gobj () const
 Provides access to the underlying C GtkObject.

 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 ()
 You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Glib::PropertyProxy<double> property_label_xalign ()
 You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Glib::PropertyProxy<double> property_label_yalign ()
 You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Glib::PropertyProxy<ShadowTypeproperty_shadow_type ()
 You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Glib::PropertyProxy<Widget*> property_label_widget ()
 You rarely need to use properties because there are get_ and set_ methods for almost all of them.


Protected Member Functions

virtual void compute_child_allocation_vfunc (GtkAllocation* allocation)

Related Functions

(Note that these are not member functions.)

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


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]
 

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::Bin.

Reimplemented in Gtk::AspectFrame.

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

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::Bin.

Reimplemented in Gtk::AspectFrame.

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

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

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

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

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

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

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

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

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

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

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 gtkmm2.2 by Doxygen 1.3.4 © 1997-2001