![]() |
LeechCraft
%{LEECHCRAFT_VERSION}
Modular cross-platform feature rich live environment.
|
The CategorySelector widget provides a way to select amongst a group of items. More...
#include "categoryselector.h"
Public Slots | |
void | selectAll () |
Selects all variants. More... | |
void | selectNone () |
Deselects all variants. More... | |
void | setPossibleSelections (QStringList selections) |
Sets possible selections. More... | |
void | lineTextChanged (const QString &newText) |
Notifies CategorySelector about logical selection changes. More... | |
Signals | |
void | tagsSelectionChanged (const QStringList &newSelections) |
Indicates that selections have changed. More... | |
Public Member Functions | |
CategorySelector (QWidget *parent=0) | |
Constructor. More... | |
void | SetCaption (const QString &caption) |
Sets the caption of this selector. More... | |
QStringList | GetSelections () |
Gets selected items. More... | |
void | SetSelections (const QStringList &subset) |
Selects some of the items. More... | |
UTIL_API QString | GetSeparator () const |
Returns the separator for the tags. More... | |
UTIL_API void | SetSeparator (const QString &) |
Sets the separator for the tags. More... | |
Protected Member Functions | |
virtual void | moveEvent (QMoveEvent *) |
Checks whether after the move event the selector won't be beoynd the screen. if it would, moves back. More... | |
The CategorySelector widget provides a way to select amongst a group of items.
The CategorySelector is a QWidget having Qt::Tool window hint. That results in representing this widget as a tool window - usually a small window with smaller than usual title bar and decoration. CategorySelector represents the possible selections as a list of check boxes.
Programmer can set the list of possible choice variants using SetPossibleSelections and get selected items with GetSelections.
CategorySelector emits selectionChanged() signal when user changes his selection. CategorySelector's primary purpose is to help user to select tags using a line edit, so there's a convenience slot lineTextChanged() which could be used to notify CategorySelector about changes of possible categories. There are also convenience slots selectAll() and selectNone() which could be used to mark all and no elements in the list respectively.
Definition at line 62 of file categoryselector.h.
CategorySelector::CategorySelector | ( | QWidget * | parent = 0 | ) |
Constructor.
Sets the default window title and window flags (Qt::Tool | Qt::WindowStaysOnTopHint), calculates the default geometry.
[in] | parent | Pointer to parent widget. |
Definition at line 45 of file categoryselector.cpp.
References selectAll(), and selectNone().
QStringList CategorySelector::GetSelections | ( | ) |
Gets selected items.
Returns the selected items - a subset of selection variants passed via SetPossibleSelections.
Definition at line 119 of file categoryselector.cpp.
References RoleTag.
QString CategorySelector::GetSeparator | ( | ) | const |
Returns the separator for the tags.
The default separator is "; ".
Definition at line 148 of file categoryselector.cpp.
|
slot |
Notifies CategorySelector about logical selection changes.
This slot is usually used to notify CategorySelector about selection changes done via a related widget - for example, a line edit with tags.
[in] | newText | The text of the line edit. |
Definition at line 216 of file categoryselector.cpp.
References SetSelections().
|
protectedvirtual |
Checks whether after the move event the selector won't be beoynd the screen. if it would, moves back.
Definition at line 158 of file categoryselector.cpp.
|
slot |
Selects all variants.
Definition at line 174 of file categoryselector.cpp.
References RoleTag, and tagsSelectionChanged().
Referenced by CategorySelector().
|
slot |
Deselects all variants.
Definition at line 198 of file categoryselector.cpp.
References tagsSelectionChanged().
Referenced by CategorySelector().
void CategorySelector::SetCaption | ( | const QString & | caption | ) |
Sets the caption of this selector.
By default, the selector has no caption.
[in] | caption | The new caption of this selector. |
Definition at line 80 of file categoryselector.cpp.
|
slot |
Sets possible selections.
Clears previous selections list, sets new possible selections according to selections parameter. By default, no items are selected.
[in] | selections | Possible selections. |
Definition at line 86 of file categoryselector.cpp.
References RoleTag, and tagsSelectionChanged().
void CategorySelector::SetSelections | ( | const QStringList & | subset | ) |
Selects some of the items.
Selects some of the items presented by elements of the subset list.
This function won't emit selectionChanged() signal.
[in] | subset | The list of items to select. |
Definition at line 134 of file categoryselector.cpp.
References RoleTag.
Referenced by lineTextChanged().
void CategorySelector::SetSeparator | ( | const QString & | sep | ) |
Sets the separator for the tags.
This function doesn't update the text in the line edit.
Definition at line 153 of file categoryselector.cpp.
|
signal |
Indicates that selections have changed.
[out] | newSelections | Selected items. |
Referenced by selectAll(), selectNone(), and setPossibleSelections().