Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
style:strings [2008/11/05 21:11] – change translation comment stuff, add punctuation section kelnosstyle:strings [2008/12/10 23:13] (current) – add XfceTitledDialog note 66.166.20.74
Line 44: Line 44:
  
 Generally, settings dialogs consist of lots of short strings of text describing an option, often (well, hopefully often) with a tooltip that explains in a bit more detail. Generally, settings dialogs consist of lots of short strings of text describing an option, often (well, hopefully often) with a tooltip that explains in a bit more detail.
 +
 +==== Dialog Implementation Details ====
 +
 +Unless there's a good reason not to, [[http://www.xfce.org/documentation/api/libxfcegui4/XfceTitledDialog.html|XfceTitledDialog]] should be used for settings dialogs.  The "subtitle" string for the dialog should be used as a description of what the dialog does or of what the user can use the dialog for, and should **not** be used to ask the user to do something.
 +
 +For example, in a (fictitious) settings dialog that allows the user to configure various text layout parameters, the title might be simply "Layout" or "Layout Settings," and a good subtitle might be "Configure text layout parameters," "Text layout configuration," or, if you're feeling a bit more verbose, even possibly "Control various parameters related to text layout" (though I'd recommend something shorter).
 +
 +Transient dialogs that are opened to ask the user a question or to allow the user to input some data before being dismissed generally shouldn't use XfceTitledDialog.
  
 ==== Text Involved in Layout ==== ==== Text Involved in Layout ====