Hildon Widgets API for Python

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.CalendarPopup

Usage Example

import gtk
import hildon

def on_gather_date(widget, window, button):
    dialog = hildon.CalendarPopup (window, 2006, 04, 20)
    dialog.run()
    date_tuple = dialog.get_date()
    dialog.destroy()
    
    button.set_label("The date is (yy/mm/dd): %s/%s/%s" % date_tuple)

window = hildon.Window()
window.set_title("Test App")

button = gtk.Button("Click to enter a date")
window.add(button)
button.connect("clicked", on_gather_date, window, button)

window.show_all()

gtk.main()
      

Properties

Constructor

This function returns a new hildon.CalendarPopup. The initially selected date is specified by the parameters (year, month, day). If the specified date is invalid, the current date is used.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Button
      +-- hildon.ColorButton

Usage Example

import gtk
import hildon

def color_changed(widget, label):
    color = widget.get_color()
    label.set_text("Current color is: (red=%s, green=%s, blue=%s, pixel=%s)" %
                   (color.red, color.green, color.blue, color.pixel))

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label()

button = hildon.ColorButton()
button.connect("clicked", color_changed, label)

color_changed (button, label) #Init label text

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new color button. This returns a widget in the form of a small button containing a swatch representing the current selected color. When the button is clicked, a color-selection dialog will open, allowing the user to select a color. The swatch will be updated to reflect the new color when the user finishes.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.ColorSelector

Usage Example

import gtk
import hildon

def color_selected(widget, label, window):
    color_selector = hildon.ColorSelector(window)
    
    color_selector.run()
    color = color_selector.get_color()
    color_selector.destroy()
    
    label.set_text("Selected color is: (red=%s, green=%s, blue=%s, pixel=%s)" %
                   (color.red, color.green, color.blue, color.pixel))

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label("No color has been selected yet...")

button = gtk.Button("Click here to select a color")
button.connect("clicked", color_selected, label, window)

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.ColorSelector dialog with 3x8 layout of base colors and 'OK', 'Modify' and 'Cancel' buttons.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Scale
      +-- hildon.Controlbar

Usage Example

import gtk
import hildon

def control_changed(widget, label):
    label.set_text("Min:%s | Current: %s | Max:%s" %
                   (widget.get_min(), widget.get_value(), widget.get_max()))

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label()

controlbar = hildon.Controlbar()
controlbar.set_min(0)
controlbar.set_max(50)
controlbar.set_value(15)
controlbar.connect("value-changed", control_changed, label)

control_changed(controlbar, label) #Init label text

vbox = gtk.VBox(False, 10)
vbox.pack_start (controlbar)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Style Properties

Constructor

Creates a new hildon.Controlbar widget.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.DateEditor

Usage Example

import gtk
import hildon

window = hildon.Window()
window.set_title("Test App")

dateeditor = hildon.DateEditor()
dateeditor.set_year(2006)
dateeditor.set_month(4)
dateeditor.set_day(20)

window.add(dateeditor)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.DateEditor widget.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.FileDetailsDialog

Usage Example

Source code.
      

Constructor

Bla

Usage Example

import gtk
import hildon

def font_selected(widget, label, fontDialog):
    fontDialog.run()
    fontDialog.hide()
    
    if fontDialog.get_property("family-set"):
        family = fontDialog.get_property("family")
    else:
        family = "Not set"
      
    if fontDialog.get_property("size-set"):
        size = fontDialog.get_property("size")
    else:
        size = "Not set"
        
    if fontDialog.get_property("color-set"):
        gdk_color = fontDialog.get_property("color")
        color = "(R:%s, G:%s, B:%s)" % (gdk_color.red, gdk_color.green, gdk_color.blue)
    else:
        color = "Not set"
        
    if fontDialog.get_property("bold-set"):
        bold = fontDialog.get_property("bold")
    else:
        bold = "Not set"
        
    if fontDialog.get_property("italic-set"):
        italic = fontDialog.get_property("italic")
    else:
        italic = "Not set"
        
    if fontDialog.get_property("underline-set"):
        underline = fontDialog.get_property("underline")
    else:
        underline = "Not set"
    
    if fontDialog.get_property("strikethrough-set"):
        strikethrough = fontDialog.get_property("strikethrough")
    else:
        strikethrough = "Not set"
        
    if fontDialog.get_property("position-set"):
        position = fontDialog.get_property("position")
    else:
        position = "Not set"
      
    label.set_text("Family: %s | Size: %s | Color: %s\n"
                   "Bold: %s | Italic: %s | Underline: %s\n"
                   "Sstrikethrough: %s | Position: %s" %
        (family, size, color, bold, italic, underline, strikethrough, position))

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label("No font selected.")

fontDialog = hildon.FontSelectionDialog(window, "Choose a font...")
fontDialog.set_preview_text ("The lazy dogs caught the quick brown fox.")

button = gtk.Button("Click to select a font")
button.connect("clicked", font_selected, label, fontDialog)

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new font selection dialog.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.GetPasswordDialog

Usage Example

import gtk
import hildon

def get_password(widget, label, passwordDialog):
    passwordDialog.set_property ("password", "") #Clear the password string, in case it was already set.
    response = passwordDialog.run()
    passwordDialog.hide()
    
    if response == gtk.RESPONSE_OK:
        label.set_text("Password typed is: %s" % passwordDialog.get_password())

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label("No password entered.")

passwordDialog = hildon.GetPasswordDialog(window, True)

button = gtk.Button("Click and type a password")
button.connect("clicked", get_password, label, passwordDialog)

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.GetPasswordDialog widget.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.GridItem

Usage Example

import gtk
import hildon

window = hildon.Window()
window.set_title("Test App")

grid = hildon.Grid()

grid_item = hildon.GridItem("Calculator")
grid.add(grid_item)

grid_item = hildon.GridItem("Calendar", "A simple calendar")
grid.add(grid_item)

window.add(grid)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.GridItem widget.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.Grid

Usage Example

See hildon.GridItem

Properties

Style Properties

Constructor

Creates a new hildon.Grid widget.

Methods

Signals

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.Volumebar
           +-- hildon.HVolumebar

Usage Example

import gtk
import hildon

def level_changed(volumebar, label):
    label.set_text("Volume level: %s" % volumebar.get_level())
    
def mute_toggled(volumebar, label):
    if volumebar.get_mute():
      label.set_text("Volume level: Mute")
    else:
      level_changed(volumebar, label)

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label()

volumebar = hildon.HVolumebar()
volumebar.connect("level_changed", level_changed, label)
volumebar.connect("mute_toggled", mute_toggled, label)

level_changed(volumebar, label) #Init label text

vbox = gtk.VBox(False, 10)
vbox.pack_start (volumebar)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Constructor

Creates a new hildon.HVolumebar widget.

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.NamePasswordDialog

Usage Example

import gtk
import hildon

def on_click(widget, window):
    dialog = hildon.NamePasswordDialog(window)
    
    response = dialog.run()
    dialog.hide()
    
    if response == gtk.RESPONSE_OK:
        widget.set_label("Name: %s\nPassword: %s" % (dialog.get_name(), dialog.get_password()))
    else:
        widget.set_label("Enter name and password")
        
    dialog.destroy()

window = hildon.Window()
window.set_title("Test App")

button = gtk.Button("Enter name and password")
button.connect("clicked", on_click, window)

window.add(button)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.NamePasswordDialog.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.Note

Usage Example

import gtk
import hildon

def on_show_note(widget, window, button):
    dialog = hildon.Note ("confirmation", (window, "Are you sure?", gtk.STOCK_DIALOG_WARNING) )
    dialog.set_button_texts ("Yes", "No")
    response = dialog.run()
    dialog.destroy()
    
    if response == gtk.RESPONSE_OK:
        button.set_label("Confirmed")
    else:
        button.set_label("Canceled")

window = hildon.Window()
window.set_title("Test App")

button = gtk.Button("Click to confirm.")
window.add(button)
button.connect("clicked", on_show_note, window, button)

window.show_all()

gtk.main()
        

import gtk
import hildon

def on_show_note(widget, window):
    dialog = hildon.Note ("information", (window, "That's some important info.", gtk.STOCK_DIALOG_INFO) )
    dialog.set_button_text("Alright")
    dialog.run()
    dialog.destroy()

window = hildon.Window()
window.set_title("Test App")

button = gtk.Button("Click to have some info.")
window.add(button)
button.connect("clicked", on_show_note, window)

window.show_all()

gtk.main()
        

Properties

Constructor

Creates a new hildon.Note widget. Its type is specified in the note_type argument.

Each type of hildon.Note needs a different set of arguments, both in quantity and in quality. To handle this, note_type states the desired type and note_tuple contains a tuple having the arguments needed by the specified note type. The following table relates a note type with its correspondent note_type value and note_tuple format:

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.NumberEditor

Usage Example

import gtk
import hildon

window = hildon.Window()
window.set_title("Test App")

number_editor = hildon.NumberEditor(0, 10)
number_editor.set_value(5)

window.add(number_editor)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates new number editor with a given range (minimum and maximum allowable values).

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.RangeEditor

Usage Example

import gtk
import hildon

window = hildon.Window()
window.set_title("Test App")

range_editor = hildon.RangeEditor()
range_editor.set_limits(-100, 100)
range_editor.set_range(-10, 23)
range_editor.set_separator("to")

window.add(range_editor)

window.show_all()

gtk.main()
      

Properties

Style Properties

Constructor

hildon.RangeEditor contains two gtk.Entry that accepts numbers and minus.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Scale
      +-- hildon.Seekbar

Usage Example

import gobject
import gtk
import hildon

def increase_fraction(seekbar):
    if seekbar.get_fraction() + 1 < seekbar.get_total_time():
        seekbar.set_fraction(seekbar.get_fraction() + 1)
        result = True
    else:
        seekbar.set_fraction(seekbar.get_total_time())
        result = False
        
    seekbar.notify("fraction")
    seekbar.queue_draw()
    return result;

def control_changed(widget, label):
    label.set_text("Position: %s | Fraction: %s | Total time: %s" %
                   (widget.get_position(), widget.get_fraction(), widget.get_total_time()))
                   
def fraction_changed(widget, param_spec, label):
    control_changed(widget, label)

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label()

seekbar = hildon.Seekbar()
seekbar.set_total_time(180)
seekbar.set_fraction(10)
seekbar.set_position(0)
seekbar.connect("value-changed", control_changed, label)
seekbar.connect("notify::fraction", fraction_changed, label)

control_changed(seekbar, label) #Init label text

vbox = gtk.VBox(False, 10)
vbox.pack_start (seekbar)
vbox.pack_start (label)
window.add(vbox)

gobject.timeout_add(500, increase_fraction, seekbar)

window.show_all()

gtk.main()
      

Constructor

Creates a new hildon.Seekbar widget.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.SetPasswordDialog

Usage Example

import gtk
import hildon

def set_password(widget, label, window):
    passwordDialog = hildon.SetPasswordDialog(window, False)
    response = passwordDialog.run()
    passwordDialog.hide()
    
    if response == gtk.RESPONSE_OK:
        label.set_text("Your ultra-secret password is \"%s\"." % passwordDialog.get_password())
    else:
        label.set_text("No password set.")
        
    passwordDialog.destroy()

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label("No password set.")

button = gtk.Button("Click set a password")
button.connect("clicked", set_password, label, window)

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.SetPasswordDialog.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.SortDialog

Usage Example

import gtk
import hildon

def sort(widget, label, window):
    dialog = hildon.SortDialog(window)
    
    sort_keys = ("ham", "spam", "eggs")
    dialog.add_sort_key(sort_keys[0])
    dialog.add_sort_key(sort_keys[1])
    dialog.add_sort_key(sort_keys[2])
    
    response = dialog.run()
    dialog.hide()
    
    if response == gtk.RESPONSE_OK:
    
        if (dialog.get_sort_order() == gtk.SORT_ASCENDING):
            sort_order = "ascending"
        else:
            sort_order = "descending"
    
        label.set_text("Sort by %s, %s" % (sort_keys[dialog.get_sort_key()], sort_order))
    else:
        label.set_text("Canceled")
        
    dialog.destroy()

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label("No sorting yet.")

button = gtk.Button("Click to sort")
button.connect("clicked", sort, label, window)

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Creates a new hildon.SortDialog.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.TimeEditor

Usage Example

TO DO
      

Properties

Constructor

Creates a new hildon.TimeEditor widget.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Dialog
      +-- hildon.TimePicker

Usage Example

import gtk
import hildon

def pick_time(widget, label, time_picker):
    response = time_picker.run()
    time_picker.hide()
    
    if response == gtk.RESPONSE_OK:
        label.set_text("Time is %s hours and %s minutes." % time_picker.get_time())

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label("No time picked yet.")

time_picker = hildon.TimePicker(window)

button = gtk.Button("Click to pick a time")
button.connect("clicked", pick_time, label, time_picker)

vbox = gtk.VBox(False, 10)
vbox.pack_start (button)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Properties

Constructor

Hildon Time Picker shows a time picker dialog. Close button is placed in dialog's action area and time picker is placed in dialogs vbox. Actual time picker consists two gtk.Label fields, one for hours and other for minutes, arrow buttons and an AM/PM button. A ":" is placed between hours and minutes fields.

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.Volumebar

Properties

Signals

Methods

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.Volumebar
           +-- hildon.VVolumebar

Usage Example

import gtk
import hildon

def level_changed(volumebar, label):
    label.set_text("Volume level: %s" % volumebar.get_level())
    
def mute_toggled(volumebar, label):
    if volumebar.get_mute():
      label.set_text("Volume level: Mute")
    else:
      level_changed(volumebar, label)

window = hildon.Window()
window.set_title("Test App")

label = gtk.Label()

volumebar = hildon.VVolumebar()
volumebar.connect("level_changed", level_changed, label)
volumebar.connect("mute_toggled", mute_toggled, label)

level_changed(volumebar, label) #Init label text

vbox = gtk.VBox(False, 10)
vbox.pack_start (volumebar)
vbox.pack_start (label)
window.add(vbox)

window.show_all()

gtk.main()
      

Constructor

Creates a new hildon.VVolumebar widget.

Ancestry

Up to the first non-hildon ancestor:

...
 +-- gtk.Container
      +-- hildon.WeekdayPicker

Signals

Constructor

Creates a new hildon.WeekdayPicker widget.

Methods