Projects/Usability/HIG/Date Time Pickers: Difference between revisions

From KDE TechBase
< Projects‎ | Usability‎ | HIG
m (Agateau a déplacé la page Projects/Usability/HIG/Date Time vers Projects/Usability/HIG/Date Time Pickers: Page is not about date and time, it is about controls to pick date and/or time)
(Add new screenshot and list of implementation classes)
Line 1: Line 1:
== Date and Time ==
== Purpose ==


'''Date / Time Widget:'''
Date time pickers allows the user to type or pick a date, a time, or both.
* When a user must select a single date and time use the KDE Date/Time widget


[[file:Date_Time_Pickers.png]]


[[File:Date_time.png]]
== Guidelines ==


''' Start and End Date/Time:'''
* When selecting a date, if space is limited, use a KDateComboBox or a KDateWidget. If more room is available, use a KDatePicker.
* When users must select a start and end date/time, make the default end date/time aware of the start date/time (i.e. when the user sets a start date, switch the end date at least to the same date)
* When user must select both start and end date/times, make the default end date/time aware of the start date/time: when the user sets a start date, switch the end date at least to the same date.
 
== Implementation ==
=== Time-only controls ===
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKTimeComboBox.html KTimeComboBox]
 
=== Date-only controls ===
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKDateComboBox.html KDateComboBox]
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKDatePicker.html KDatePicker]
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKDateTable.html KDateTable]
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKDateWidget.html KDateWidget]
 
=== Date-time controls ===
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKDateTimeEdit.html KDateTimeEdit]
* [http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKDateTimeWidget.html KDateTimeWidget]

Revision as of 14:44, 27 June 2013

Purpose

Date time pickers allows the user to type or pick a date, a time, or both.

Guidelines

  • When selecting a date, if space is limited, use a KDateComboBox or a KDateWidget. If more room is available, use a KDatePicker.
  • When user must select both start and end date/times, make the default end date/time aware of the start date/time: when the user sets a start date, switch the end date at least to the same date.

Implementation

Time-only controls

Date-only controls

Date-time controls

Retrieved from "https://techbase.kde.org/index.php?title=Projects/Usability/HIG/Date_Time_Pickers&oldid=80238"