Difference between revisions of "Projects/Usability/HIG/Date Time Pickers"

< Projects‎ | Usability‎ | HIG
Jump to: navigation, search
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 15:44, 27 June 2013

Contents

Purpose

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

Date Time Pickers.png

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


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal