Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QTimeZoneSelector Class Reference
[QtBaseModule]

The QTimeZoneSelector class provides a widget for selecting a time zone. More...

    #include <QTimeZoneSelector>

Inherits QWidget.

• List of all members, including inherited members

Properties

• allowNoZone : bool
• currentZone : QString

• 57 properties inherited from QWidget
• 1 property inherited from QObject

Public Functions

• QTimeZoneSelector ( QWidget * p = 0 )
• ~QTimeZoneSelector ()
• bool allowNoZone () const
• QString currentZone () const
• void setAllowNoZone ( bool b )
• void setCurrentZone ( const QString & id )

• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Signals

• void zoneChanged ( const QString & id )

• 1 signal inherited from QWidget
• 1 signal inherited from QObject

Additional Inherited Members

• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

The QTimeZoneSelector class provides a widget for selecting a time zone.

QTimeZoneSelector presents a list of common city names, corresponding to time zones, for the user to choose from. A "More..." option allows the user to access all time zones via a world map.

The cities included in the initial list are determined by the configuration file WorldTime.conf. This file has the following format:

    [TimeZones]
    Zone0=Area/Location
    ...
    ZoneN=Area/Location

where each Area/Location is a zoneinfo identifier. For example:

    [TimeZones]
    Zone0=America/New_York
    Zone1=America/Los_Angeles
    Zone2=Europe/Oslo
    ...

The selector list also includes the current time zone, regardless of whether or not that time zone is represented by a city in the configuration file.

See also QTimeZone.

Property Documentation

allowNoZone : bool

This property holds true if no timezone is included as an option; false otherwise.

Access functions:

• bool allowNoZone () const
• void setAllowNoZone ( bool b )

currentZone : QString

This property holds the currently selected timezone.

Access functions:

• QString currentZone () const
• void setCurrentZone ( const QString & id )

Member Function Documentation

QTimeZoneSelector::QTimeZoneSelector ( QWidget * p = 0 )

Creates a new QTimeZoneSelector with parent p. The selector will be populated with the appropriate timezones (see Detailed Description for an explanation of which zones will be included).

QTimeZoneSelector::~QTimeZoneSelector ()

Destroys the QTimeZoneSelector.

void QTimeZoneSelector::zoneChanged ( const QString & id )   [signal]

This signal is emitted whenever the time zone is changed. The id is a QString in Area/Location format, for example,

    Australia/Brisbane