![]() |
LeechCraft
0.6.70-16373-g319c272718
Modular cross-platform feature rich live environment.
|
The CategorySelector widget provides a way to select amongst a group of items. More...
#include "categoryselector.h"
Classes | |
class | SelectorTagsModel |
Public Types | |
enum | ButtonsMode { ButtonsMode::NoButtons, ButtonsMode::Close, ButtonsMode::AcceptReject } |
Signals | |
void | tagsSelectionChanged (const QStringList &newSelections) |
Indicates that selections have changed. More... | |
Public Member Functions | |
CategorySelector (QWidget *parent=nullptr) | |
Constructor. More... | |
void | SetCaption (const QString &caption) |
Sets the caption of this selector. More... | |
QStringList | GetSelections () const |
Gets selected items. More... | |
QList< int > | GetSelectedIndexes () const |
Gets the indexes of the selected items. More... | |
void | SetSelections (const QStringList &subset) |
Selects some of the items. More... | |
QString | GetSeparator () const |
Returns the separator for the tags. More... | |
void | SetSeparator (const QString &) |
Sets the separator for the tags. More... | |
void | SetButtonsMode (ButtonsMode) |
Sets the buttons mode. More... | |
virtual void | SetPossibleSelections (QStringList selections, bool sort=true) |
Sets possible selections. More... | |
QStringList | GetPossibleSelections () const |
void | SelectAll () |
Selects all variants. More... | |
void | SelectNone () |
Deselects all variants. More... | |
void | SetSelectionsFromString (const QString &newText) |
Notifies CategorySelector about logical selection changes. More... | |
Protected Member Functions | |
void | moveEvent (QMoveEvent *) override |
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 function SetSelectionsFromString() which can 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 47 of file categoryselector.h.
|
strong |
Enumerator | |
---|---|
NoButtons | |
Close | |
AcceptReject |
Definition at line 59 of file categoryselector.h.
|
explicit |
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 111 of file categoryselector.cpp.
QStringList LC::Util::CategorySelector::GetPossibleSelections | ( | ) | const |
Definition at line 163 of file categoryselector.cpp.
QList< int > LC::Util::CategorySelector::GetSelectedIndexes | ( | ) | const |
Gets the indexes of the selected items.
Returns the indexes of the selected items in the array passed to setPossibleSelections(). Please note that sorting should be disabled in setPossibleSelections() for this function to be useful.
Definition at line 179 of file categoryselector.cpp.
References LC::Util::CategorySelector::SelectorTagsModel::data().
Referenced by GetSelections().
QStringList LC::Util::CategorySelector::GetSelections | ( | ) | const |
Gets selected items.
Returns the selected items - a subset of selection variants passed via SetPossibleSelections.
Definition at line 168 of file categoryselector.cpp.
References GetSelectedIndexes().
QString LC::Util::CategorySelector::GetSeparator | ( | ) | const |
Returns the separator for the tags.
Definition at line 209 of file categoryselector.cpp.
|
overrideprotected |
Checks whether after the move event the selector won't be beoynd the screen. if it would, moves back.
Definition at line 237 of file categoryselector.cpp.
void LC::Util::CategorySelector::SelectAll | ( | ) |
Selects all variants.
Definition at line 253 of file categoryselector.cpp.
References LC::Util::CategorySelector::SelectorTagsModel::SelectAll().
void LC::Util::CategorySelector::SelectNone | ( | ) |
Deselects all variants.
Definition at line 258 of file categoryselector.cpp.
References LC::Util::CategorySelector::SelectorTagsModel::SelectNone().
void LC::Util::CategorySelector::SetButtonsMode | ( | ButtonsMode | mode | ) |
Sets the buttons mode.
Definition at line 219 of file categoryselector.cpp.
References AcceptReject, LC::Util::Close, Close, and NoButtons.
void LC::Util::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 148 of file categoryselector.cpp.
References LC::Util::CategorySelector::SelectorTagsModel::SetHeader().
|
virtual |
Sets possible selections.
Clears previous selections list, sets new possible selections according to selections parameter. By default, no items are selected.
The selections list is sorted unless the sort parameter is set to false. Please note that if you plan to call GetSelectedIndexes() you should set sort to false.
[in] | selections | Possible selections. |
[in] | sort | Whether the selections should be sorted (default is true). |
Definition at line 153 of file categoryselector.cpp.
References LC::Util::CategorySelector::SelectorTagsModel::SelectNone().
Referenced by LC::Util::TagsLineEdit::AddSelector().
void LC::Util::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 194 of file categoryselector.cpp.
References LC::Util::CategorySelector::SelectorTagsModel::setData().
Referenced by SetSelectionsFromString(), and LC::Util::TagsLineEdit::setTags().
void LC::Util::CategorySelector::SetSelectionsFromString | ( | const QString & | newText | ) |
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 263 of file categoryselector.cpp.
References SetSelections().
Referenced by LC::Util::TagsLineEdit::AddSelector().
void LC::Util::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 214 of file categoryselector.cpp.
References LC::Util::sep.
Referenced by LC::Util::TagsLineEdit::AddSelector(), and LC::Util::TagsLineEdit::SetSeparator().
|
signal |
Indicates that selections have changed.
[out] | newSelections | Selected items. |
Referenced by LC::Util::TagsLineEdit::AddSelector().