digiKam Developer Documentation
Professional Photo Management with the Power of Open Source
Loading...
Searching...
No Matches
Digikam::SearchQueryEngine Class Reference
Inheritance diagram for Digikam::SearchQueryEngine:

Public Slots

void slotCancel ()
void slotInterpretQuery (const QString &originalText, const QString &normalizedText)
 Entry point used by SearchWindow / SearchTabHeader.

Signals

void signalCancelled ()
void signalClarificationRequired (const SearchQueryIntent &intent)
 Ambiguous: UI must show clarification choices, never guess.
void signalErrorOccurred (const QString &message)
void signalIntentReady (const SearchQueryIntent &intent)
 Resolved, unambiguous: UI can populate Advanced Search fields.
void signalStatusMessage (const QString &message)

Public Member Functions

 SearchQueryEngine (QObject *const parent=nullptr)
bool isReady () const
void setBackend (SearchLanguageBackend *const backend)
 Dependency injection: keeps the engine unit-testable with the mock backend and lets SearchWindow own component lifetimes.
void setCache (SearchQueryCache *const cache)
void setKnownAlbums (const QStringList &albums)
void setKnownPeople (const QStringList &people)
void setKnownTags (const QStringList &tags)
 Collection-aware hints injected into prompts.
void setParser (SearchIntentParser *const parser)
void setPromptBuilder (SearchPromptBuilder *const builder)
void setResolver (SearchIntentResolver *const resolver)

Member Function Documentation

◆ slotInterpretQuery

void Digikam::SearchQueryEngine::slotInterpretQuery ( const QString & originalText,
const QString & normalizedText )
slot

originalText: what the user typed. normalizedText: post-DOnlineTranslator text, or empty to reuse the original (translation disabled / failed -> fallback).