= Gtk Static Widgets =

Static widgets provide information to the user, either about the state of the program or to help understand the display.

== Labels ==

== Separators ==

== Frame == 

A 'frame' is a container class which holds one child widget, and displays that child with a surrounding border and title.  That child can be another container, so frames can contain many other widgets.

A frame is easy to construct and use.  Given a box containing widgets to display, the following two lines wrap the box in the frame class:
{{{
#!cobra
		frame1 = Frame("Widgets label")
		frame1.add(box)
}}}

There are two display elements of the frame which can be changed.  

 1. The '''position''' of the label can be changed with respect to the top line using two attributes:

 * frame.labelXAlign: 0.0 is left, 1.0 is right. 
 * frame.labelYAlign: 0.0 is below the line, 0.5 on the line, and 1.0 above the line.

 2. The '''style''' of the line can be changed, using the 'shadowType' attribute, which has the following values:

 * !ShadowType.None
 * !ShadowType.In: bevelled inwards
 * !ShadowType.Out: bevelled outwards
 * !ShadowType.!EtchedIn: (the default)
 * !ShadowType.!EtchedOut

The following program illustrates using frames to label some radiobuttons.  The frame on the left uses the default alignment and style.

[[Image(gtk-frames.png)]]

{{{
#!cobra
# @args -pkg:gtk-sharp-2.0 # remove initial '#'

use Gtk

class ExampleWindow inherits Window
	cue init
		base.init("Example of Frames")
		listen .deleteEvent, do(obj, e as DeleteEventArgs)
			Application.quit
		.createWidgets
		.setDefaultSize(300, 100)

	def createRadios as VBox
		radio1 = RadioButton("Cobra")
		radio2 = RadioButton(radio1, "Java")
		radio3 = RadioButton(radio2, "Python")
		box = VBox(false, 10)
		box.packStart(radio1, false, false, 0)
		box.packStart(radio2, false, false, 0)
		box.packStart(radio3, false, false, 0)
		return box

	def createWidgets
		frame1 = Frame("Select Language")
		frame1.add(.createRadios)

		frame2 = Frame("Select Language")
		frame2.labelXalign = 0.5 to float32
		frame2.labelYalign = 0 to float32
		frame2.shadowType = ShadowType.In
		frame2.add(.createRadios)

		box = HBox(true, 20)
		box.borderWidth = 20
		box.packStart(frame1, true, true, 0)
		box.packStart(frame2, true, true, 0)
		.add(box)
	
class RunProgram
	def main
		Application.init
		window = ExampleWindow()
		window.showAll
		Application.run
}}}