Kodi Documentation 22.0
Kodi is an open source media player and entertainment hub.
Loading...
Searching...
No Matches
CMusicLibraryImportJob Class Reference

Music library job implementation for importing data to the music library. More...

#include <MusicLibraryImportJob.h>

Inheritance diagram for CMusicLibraryImportJob:
CMusicLibraryProgressJob CProgressJob CMusicLibraryJob CJob CJob

Public Member Functions

 CMusicLibraryImportJob (const std::string &xmlFile, CGUIDialogProgress *progressDialog)
 Creates a new music library import job for the given xml file.
 
 ~CMusicLibraryImportJob () override
 
const char * GetType () const override
 Function that returns the type of job.
 
bool operator== (const CJob *job) const override
 
- Public Member Functions inherited from CMusicLibraryProgressJob
 ~CMusicLibraryProgressJob () override
 
bool DoWork () override
 Main workhorse function of CJob instances.
 
const char * GetType () const override
 Function that returns the type of job.
 
bool operator== (const CJob *job) const override
 
- Public Member Functions inherited from CProgressJob
 ~CProgressJob () override
 
const char * GetType () const override
 Function that returns the type of job.
 
bool operator== (const CJob *job) const override
 
bool ShouldCancel (unsigned int progress, unsigned int total) const override
 Function for longer jobs to report progress and check whether they have been cancelled.
 
bool DoModal ()
 Executes the job showing a modal progress dialog.
 
void SetProgressIndicators (CGUIDialogProgressBarHandle *progressBar, CGUIDialogProgress *progressDialog, bool updateProgress=true, bool updateInformation=true)
 Sets the given progress indicators to be used during execution of the job.
 
bool HasProgressIndicator () const
 
- Public Member Functions inherited from CJob
 CJob ()
 
virtual ~CJob ()=default
 Destructor for job objects.
 
- Public Member Functions inherited from CMusicLibraryJob
 ~CMusicLibraryJob () override
 
virtual bool CanBeCancelled () const
 Whether the job can be cancelled or not.
 
virtual bool Cancel ()
 Tries to cancel the running job.
 

Protected Member Functions

bool Work (CMusicDatabase &db) override
 Worker method to be implemented by an actual implementation.
 
- Protected Member Functions inherited from CMusicLibraryProgressJob
 CMusicLibraryProgressJob (CGUIDialogProgressBarHandle *progressBar)
 
- Protected Member Functions inherited from CProgressJob
 CProgressJob ()
 
 CProgressJob (CGUIDialogProgressBarHandle *progressBar)
 
bool IsModal () const
 Whether the job is being run modally or in the background.
 
CGUIDialogProgressBarHandleGetProgressBar () const
 Returns the progress bar indicating the progress of the job.
 
void SetProgressBar (CGUIDialogProgressBarHandle *progress)
 Sets the progress bar indicating the progress of the job.
 
CGUIDialogProgressGetProgressDialog () const
 Returns the progress dialog indicating the progress of the job.
 
void SetProgressDialog (CGUIDialogProgress *progressDialog)
 Sets the progress bar indicating the progress of the job.
 
bool GetAutoClose ()
 Whether to automatically close the progress indicator in MarkFinished().
 
void SetAutoClose (bool autoClose)
 Set whether to automatically close the progress indicator in MarkFinished().
 
bool GetUpdateProgress ()
 Whether to update the progress bar or not.
 
void SetUpdateProgress (bool updateProgress)
 Set whether to update the progress bar or not.
 
bool GetUpdateInformation ()
 Whether to update the progress information or not.
 
void SetUpdateInformation (bool updateInformation)
 Set whether to update the progress information or not.
 
void ShowProgressDialog () const
 Makes sure that the modal dialog is being shown.
 
void SetTitle (const std::string &title)
 Sets the given title as the title of the progress bar.
 
void SetText (const std::string &text)
 Sets the given text as the description of the progress bar.
 
void SetProgress (float percentage) const
 Sets the progress of the progress bar to the given value in percentage.
 
void SetProgress (int currentStep, int totalSteps) const
 Sets the progress of the progress bar to the given value.
 
void MarkFinished ()
 Marks the progress as finished by setting it to 100%.
 
bool IsCancelled () const
 Checks if the progress dialog has been cancelled.
 
- Protected Member Functions inherited from CMusicLibraryJob
 CMusicLibraryJob ()
 

Additional Inherited Members

- Public Types inherited from CJob
enum  PRIORITY {
  PRIORITY_LOW_PAUSABLE = 0 , PRIORITY_LOW , PRIORITY_NORMAL , PRIORITY_HIGH ,
  PRIORITY_DEDICATED
}
 Priority levels for jobs, specified by clients when adding jobs to the CJobManager. More...
 

Detailed Description

Music library job implementation for importing data to the music library.

Constructor & Destructor Documentation

◆ CMusicLibraryImportJob()

CMusicLibraryImportJob::CMusicLibraryImportJob ( const std::string & xmlFile,
CGUIDialogProgress * progressDialog )

Creates a new music library import job for the given xml file.

Parameters
[in]xmlFilexml file to import
[in]progressDialogProgress dialog to be used to display the import progress

◆ ~CMusicLibraryImportJob()

CMusicLibraryImportJob::~CMusicLibraryImportJob ( )
overridedefault

Member Function Documentation

◆ GetType()

const char * CMusicLibraryImportJob::GetType ( ) const
inlineoverridevirtual

Function that returns the type of job.

CJob subclasses may optionally implement this function to specify the type of job. This is useful for the CJobManager::AddLIFOJob() routine, which preempts similar jobs with the new job.

Returns
a unique character string describing the job.
See also
CJobManager

Reimplemented from CJob.

◆ operator==()

bool CMusicLibraryImportJob::operator== ( const CJob * job) const
overridevirtual

Reimplemented from CJob.

◆ Work()

bool CMusicLibraryImportJob::Work ( CMusicDatabase & db)
overrideprotectedvirtual

Worker method to be implemented by an actual implementation.

Parameters
[in]dbAlready open music database to be used for interaction
Returns
True if the process succeeded, false otherwise

Implements CMusicLibraryJob.


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