Changes between Version 1 and Version 2 of GtkStaticWidgets

Timestamp:

11/06/11 11:23:59 (13 years ago)

Author:

callisto

Comment:

completed label and separator widgets

GtkStaticWidgets

@@ -5 +5 @@
 == Labels ==
 
+A 'label' simply displays some text.  The most straightforward construction is:
+{{{
+#!cobra
+                label1 = Label("label")
+}}}
+
+Labels can display larger blocks of text.  Set 'lineWrap' to true if the text should be wrapped and displayed on multiple lines.  Markup is supported to change the style of the text.  If your label text contains markup you need to set the 'useMarkup' attribute of the label to true. 
+
+The following image and program shows three different labels.
+
+[[Image(gtk-labels.png)]]
+
+{{{
+#!cobra
+# @args -pkg:gtk-sharp-2.0 # remove initial '#'
+
+use Gtk
+
+class ExampleWindow inherits Window
+        cue init
+                base.init("Example of Labels")
+                listen .deleteEvent, do(obj, e as DeleteEventArgs)
+                        Application.quit
+                .createWidgets
+                .setDefaultSize(300, 100)
+
+        def createWidgets
+                label1 = Label("label")
+                label2 = Label("with _mnemonic")
+                label3 = Label("Right now, if you want software contracts in your language, 
+how can you get them? The answer is to use <tt>Eiffel</tt> or D. What if you want static and 
+dynamic binding? Use Objective-C or Boo. What if you want expressiveness and quick coding? 
+Use <b>Python, Ruby or Smalltalk</b>. What if you want runtime performance? Use C#, Java, C++, 
+etc. <i>What if you want first class language support for unit tests? Use D.</i>")
+                label3.lineWrap = true
+                label3.useMarkup = true
+
+                box = HBox(false, 20)
+                box.borderWidth = 20
+                box.packStart(label1, true, true, 0)
+                box.packStart(label2, true, true, 0)
+                box.packStart(label3, true, true, 0)
+                .add(box)
+        
+class RunProgram
+        def main
+                Application.init
+                window = ExampleWindow()
+                window.showAll
+                Application.run
+}}}
+
 == Separators ==
+
+Separators are widgets which display as lines, and are used to divide up parts of the interface.  Separators are either ''vertical'' or ''horizontal''.  
+
+ * HSeparator() : creates a horizontal line - use to divide up widgets arranged vertically
+ * VSeparator() : creates a vertical line - use to divide up widgets arranged horizontally
 
 == Frame == 
@@ -11 +68 @@
 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:
+A frame is constructed with the text of the title to display.  The child widget is then added before packing the frame to display:
 {{{
 #!cobra
@@ -33 +90 @@
  * !ShadowType.!EtchedOut
 
-The following program illustrates using frames to label some radiobuttons.  The frame on the left uses the default alignment and style.
+The following image and program illustrates the use of frames to label some radiobuttons.  The frame shown on the left uses the default alignment and style.
 
 [[Image(gtk-frames.png)]]