Digikam::SearchTextBar Class Reference

Inheritance diagram for Digikam::SearchTextBar:

Public Types
enum	HighlightState { NEUTRAL , HAS_RESULT , NO_RESULT }
enum	StateSavingDepth { INSTANCE , DIRECT_CHILDREN , RECURSIVE }

Public Slots
void	slotSearchResult (bool match)

Signals
void	completerActivated ()
void	completerHighlighted (int albumId)
void	signalSearchTextSettings (const SearchTextSettings &settings)

Public Member Functions
ModelCompleter *	completerModel () const
HighlightState	getCurrentHighlightState () const
StateSavingDepth	getStateSavingDepth () const
bool	hasCaseSensitive () const
bool	hasTextQueryCompletion () const
void	loadState ()
void	saveState ()
	SearchTextBar (QWidget *const parent, const QString &name, const QString &msg=QString())
SearchTextSettings	searchTextSettings () const
void	setCaseSensitive (bool b)
virtual void	setConfigGroup (const KConfigGroup &group)
virtual void	setEntryPrefix (const QString &prefix)
void	setHighlightOnResult (bool highlight)
void	setSearchTextSettings (const SearchTextSettings &settings)
void	setStateSavingDepth (const StateSavingDepth depth)
void	setTextQueryCompletion (bool b)
	~SearchTextBar () override

Protected Member Functions
void	doLoadState () override
void	doSaveState () override
QString	entryName (const QString &base) const
KConfigGroup	getConfigGroup () const

Detailed Description

A text input for searching entries with visual feedback. Can be used on QAbstractItemModels.

Member Enumeration Documentation

HighlightState

enum Digikam::SearchTextBar::HighlightState

Possible highlighting states a SearchTextBar can have.

Enumerator
NEUTRAL	No highlighting at all. Background is colored in a neutral way according to the theme.
HAS_RESULT	The background color of the text input indicates that a result was found.
NO_RESULT	The background color indicates that no result was found.

StateSavingDepth

enum Digikam::StateSavingObject::StateSavingDepth

inherited

This enum defines the "depth" of the StateSavingObject::loadState() and StateSavingObject::saveState() methods.

Enumerator
INSTANCE	Only the instance the saving / restoring was invoked on is saved / restored.
DIRECT_CHILDREN	The instance itself and all direct children of this instance implementing StateSavingObject are saved / restored.
RECURSIVE	The instance and all children in the complete hierarchy are saved / restored.

Constructor & Destructor Documentation

SearchTextBar()

Digikam::SearchTextBar::SearchTextBar ( QWidget *const  parent, const QString &  name, const QString &  msg = QString()  )

explicit

References Digikam::StateSavingObject::loadState(), Digikam::ModelCompleter::signalActivated(), and Digikam::ModelCompleter::signalHighlighted().

~SearchTextBar()

Digikam::SearchTextBar::~SearchTextBar ( )

override

References Digikam::StateSavingObject::saveState().

Member Function Documentation

completerActivated

void Digikam::SearchTextBar::completerActivated ( )

signal

completerHighlighted

void Digikam::SearchTextBar::completerHighlighted ( int  albumId )

signal

completerModel()

ModelCompleter * Digikam::SearchTextBar::completerModel

(

)

const

Referenced by Digikam::SearchTextBarDb::setModel().

doLoadState()

void Digikam::SearchTextBar::doLoadState ( )

overrideprotectedvirtual

Implement this hook method for state loading. Use getConfigGroup() and entryName() for the implementation.

Implements Digikam::StateSavingObject.

References Digikam::StateSavingObject::entryName(), and Digikam::StateSavingObject::getConfigGroup().

doSaveState()

void Digikam::SearchTextBar::doSaveState ( )

overrideprotectedvirtual

Implement this hook method for state saving. Use getConfigGroup() and entryName() for the implementation.

Implements Digikam::StateSavingObject.

References Digikam::StateSavingObject::entryName(), and Digikam::StateSavingObject::getConfigGroup().

entryName()

QString Digikam::StateSavingObject::entryName ( const QString &  base ) const

protectedinherited

Always use this method to create config group entry names. This allows to manipulate the entry keys externally by eg. setting a prefix.

Parameters

base	original name planned for the config group entry

Returns

entry name after manipulating it with externally set parameters

Referenced by Digikam::FilterSideBarWidget::doLoadState(), Digikam::AbstractAlbumTreeView::doLoadState(), Digikam::AbstractCheckableAlbumTreeView::doLoadState(), Digikam::LabelsTreeView::doLoadState(), Digikam::ImportItemPropertiesSideBarImport::doLoadState(), Digikam::ItemPropertiesSideBar::doLoadState(), Digikam::ItemPropertiesSideBarDB::doLoadState(), Digikam::TagCheckView::doLoadState(), Digikam::Sidebar::doLoadState(), doLoadState(), ShowFoto::ShowfotoFolderViewSideBar::doLoadState(), ShowFoto::ShowfotoStackViewSideBar::doLoadState(), Digikam::FaceScanWidget::doLoadState(), Digikam::FuzzySearchView::doLoadState(), Digikam::GPSSearchView::doLoadState(), Digikam::FilterSideBarWidget::doSaveState(), Digikam::AbstractAlbumTreeView::doSaveState(), Digikam::AbstractCheckableAlbumTreeView::doSaveState(), Digikam::LabelsTreeView::doSaveState(), Digikam::ImportItemPropertiesSideBarImport::doSaveState(), Digikam::ItemPropertiesSideBar::doSaveState(), Digikam::ItemPropertiesSideBarDB::doSaveState(), Digikam::TagCheckView::doSaveState(), Digikam::Sidebar::doSaveState(), doSaveState(), ShowFoto::ShowfotoFolderViewSideBar::doSaveState(), ShowFoto::ShowfotoStackViewSideBar::doSaveState(), Digikam::FaceScanWidget::doSaveState(), Digikam::FuzzySearchView::doSaveState(), and Digikam::GPSSearchView::doSaveState().

getConfigGroup()

KConfigGroup Digikam::StateSavingObject::getConfigGroup ( ) const

protectedinherited

Returns the config group that must be used for state saving and loading.

Returns

config group for state saving and loading

Referenced by Digikam::AlbumFolderViewSideBarWidget::AlbumFolderViewSideBarWidget(), Digikam::DateFolderViewSideBarWidget::DateFolderViewSideBarWidget(), Digikam::FilterSideBarWidget::doLoadState(), Digikam::TagViewSideBarWidget::doLoadState(), Digikam::TimelineSideBarWidget::doLoadState(), Digikam::MapWidgetView::doLoadState(), Digikam::TableView::doLoadState(), Digikam::AbstractAlbumTreeView::doLoadState(), Digikam::AbstractCheckableAlbumTreeView::doLoadState(), Digikam::LabelsTreeView::doLoadState(), Digikam::ImportItemPropertiesSideBarImport::doLoadState(), Digikam::ItemPropertiesSideBar::doLoadState(), Digikam::ItemPropertiesSideBarDB::doLoadState(), Digikam::TagsManager::doLoadState(), Digikam::TagCheckView::doLoadState(), Digikam::Sidebar::doLoadState(), doLoadState(), ShowFoto::ShowfotoFolderViewSideBar::doLoadState(), ShowFoto::ShowfotoStackViewSideBar::doLoadState(), Digikam::FaceScanWidget::doLoadState(), Digikam::FuzzySearchView::doLoadState(), Digikam::GPSSearchView::doLoadState(), Digikam::FilterSideBarWidget::doSaveState(), Digikam::TagViewSideBarWidget::doSaveState(), Digikam::TimelineSideBarWidget::doSaveState(), Digikam::MapWidgetView::doSaveState(), Digikam::TableView::doSaveState(), Digikam::AbstractAlbumTreeView::doSaveState(), Digikam::AbstractCheckableAlbumTreeView::doSaveState(), Digikam::LabelsTreeView::doSaveState(), Digikam::ImportItemPropertiesSideBarImport::doSaveState(), Digikam::ItemPropertiesSideBar::doSaveState(), Digikam::ItemPropertiesSideBarDB::doSaveState(), Digikam::TagsManager::doSaveState(), Digikam::TagCheckView::doSaveState(), Digikam::Sidebar::doSaveState(), doSaveState(), ShowFoto::ShowfotoFolderViewSideBar::doSaveState(), ShowFoto::ShowfotoStackViewSideBar::doSaveState(), Digikam::FaceScanWidget::doSaveState(), Digikam::FuzzySearchView::doSaveState(), Digikam::GPSSearchView::doSaveState(), Digikam::FuzzySearchSideBarWidget::FuzzySearchSideBarWidget(), Digikam::GPSSearchSideBarWidget::GPSSearchSideBarWidget(), Digikam::LabelsSideBarWidget::LabelsSideBarWidget(), Digikam::PeopleSideBarWidget::PeopleSideBarWidget(), Digikam::SearchSideBarWidget::SearchSideBarWidget(), Digikam::TagsManager::setupUi(), Digikam::TagViewSideBarWidget::TagViewSideBarWidget(), and Digikam::TimelineSideBarWidget::TimelineSideBarWidget().

getCurrentHighlightState()

SearchTextBar::HighlightState Digikam::SearchTextBar::getCurrentHighlightState

(

)

const

Tells the current highlighting state of the text input indicated via the background color.

Returns

current highlight state

References HAS_RESULT, NEUTRAL, and NO_RESULT.

getStateSavingDepth()

StateSavingObject::StateSavingDepth Digikam::StateSavingObject::getStateSavingDepth ( ) const

inherited

Returns the depth used for state saving or loading. Default is StateSavingDepth::INSTANCE.

Returns

state saving / restoring depth

hasCaseSensitive()

bool Digikam::SearchTextBar::hasCaseSensitive

(

)

const

hasTextQueryCompletion()

bool Digikam::SearchTextBar::hasTextQueryCompletion

(

)

const

loadState()

void Digikam::StateSavingObject::loadState ( )

inherited

Invokes loading the class' state.

References Digikam::StateSavingObject::doLoadState().

Referenced by Digikam::FuzzySearchView::doLoadState(), SearchTextBar(), ShowFoto::Showfoto::Showfoto(), and Digikam::TagsManager::TagsManager().

saveState()

void Digikam::StateSavingObject::saveState ( )

inherited

Invokes saving the class' state.

References Digikam::StateSavingObject::doSaveState().

Referenced by Digikam::ImageWindow::closeEvent(), Digikam::FuzzySearchView::doSaveState(), Digikam::DateFolderView::~DateFolderView(), ~SearchTextBar(), Digikam::Sidebar::~Sidebar(), and Digikam::TagsManager::~TagsManager().

searchTextSettings()

SearchTextSettings Digikam::SearchTextBar::searchTextSettings

(

)

const

setCaseSensitive()

void Digikam::SearchTextBar::setCaseSensitive

(

bool

b

)

Indicate whether this search text bar can be toggled to between case- sensitive and -insensitive or if always case-insensitive shall be used.

Parameters

b	if true the user can decide the toggle between case sensitivity, on false every search is case- insensitive

References signalSearchTextSettings().

setConfigGroup()

void Digikam::StateSavingObject::setConfigGroup ( const KConfigGroup &  group )

virtualinherited

Sets a dedicated config group that will be used to store and reload the state from. If this method is not called, a group based on the object name is used.

You can re-implement this method to pass the group set here to child objects. Don't forget to call this method in your implementation.

Parameters

group

config group to use for state saving and restoring

Reimplemented in Digikam::GPSSearchView, Digikam::FuzzySearchView, Digikam::FilterSideBarWidget, and Digikam::DateFolderView.

Referenced by Digikam::ImageWindow::closeEvent(), Digikam::DateFolderView::setConfigGroup(), Digikam::FilterSideBarWidget::setConfigGroup(), Digikam::FuzzySearchView::setConfigGroup(), and Digikam::GPSSearchView::setConfigGroup().

setEntryPrefix()

void Digikam::StateSavingObject::setEntryPrefix ( const QString &  prefix )

virtualinherited

Define a prefix that will be used for every entry in the config group. The default prefix is empty.

You can re-implement this method to pass the prefix set here to child objects. Don't forget to call this method in your implementation.

Parameters

prefix

the prefix to use for the config entries

References prefix.

setHighlightOnResult()

void Digikam::SearchTextBar::setHighlightOnResult

(

bool

highlight

)

Tells whether highlighting for found search results shall be used or not (green and red).

Default behavior has highlighting enabled.

Parameters

highlight

true activates green and red highlighting, with false the normal widget background color will be displayed always

setSearchTextSettings()

void Digikam::SearchTextBar::setSearchTextSettings

(

const SearchTextSettings &

settings

)

Referenced by Digikam::SearchTextBarDb::setFilterModel().

setStateSavingDepth()

void Digikam::StateSavingObject::setStateSavingDepth ( const StateSavingDepth  depth )

inherited

Sets the depth used for state saving or loading.

Parameters

depth

new depth to use

setTextQueryCompletion()

void Digikam::SearchTextBar::setTextQueryCompletion

(

bool

b

)

signalSearchTextSettings

void Digikam::SearchTextBar::signalSearchTextSettings ( const SearchTextSettings &  settings )

signal

Referenced by setCaseSensitive(), and Digikam::SearchTextBarDb::setFilterModel().

slotSearchResult

void Digikam::SearchTextBar::slotSearchResult ( bool  match )

slot

Referenced by Digikam::SearchTextBarDb::setFilterModel().

---

The documentation for this class was generated from the following files:

• core/libs/widgets/text/searchtextbar.h
• core/libs/widgets/text/searchtextbar.cpp