[yast-commit] r41114 - /branches/tmp/sh/mod-ui/core/libyui/src/YSelectionBox.h
Author: sh-sh-sh Date: Wed Sep 26 15:15:25 2007 New Revision: 41114 URL: http://svn.opensuse.org/viewcvs/yast?rev=41114&view=rev Log: doc Modified: branches/tmp/sh/mod-ui/core/libyui/src/YSelectionBox.h Modified: branches/tmp/sh/mod-ui/core/libyui/src/YSelectionBox.h URL: http://svn.opensuse.org/viewcvs/yast/branches/tmp/sh/mod-ui/core/libyui/src/YSelectionBox.h?rev=41114&r1=41113&r2=41114&view=diff ============================================================================== --- branches/tmp/sh/mod-ui/core/libyui/src/YSelectionBox.h (original) +++ branches/tmp/sh/mod-ui/core/libyui/src/YSelectionBox.h Wed Sep 26 15:15:25 2007 @@ -24,6 +24,29 @@ class YMacroRecorder; class YSelectionBoxPrivate; +/** + * Selection box: List box that displays a (scrollable) list of items from + * which the user can select exactly one. Each item has a label text and an + * optional icon (*). + * + * This widget displays a number of items at once (as screen space permits). If + * there is little screen space, you might consider using a ComboBox instead + * which (in non-editable mode which is the default) displays just one item + * (the selected item) right away and the others in a pop-up dialog upon mouse + * click or keypress. + * + * The selection box also has a caption label that is + * displayed above the list. The hotkey displayed in that caption label will + * move the keyboard focus into the list. + * + * If multiple columns are needed, use the table widget instead. + * For tree-like structures, use the tree widget. + * + * + * (*) Not all UIs (in particular not text-based UIs) support displaying icons, + * so an icon should never be an exclusive means to display any kind of + * information. + **/ class YSelectionBox : public YSelectionWidget { protected: -- To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org For additional commands, e-mail: yast-commit+help@opensuse.org
participants (1)
-
sh-sh-sh@svn.opensuse.org