#include <mythnotificationcenter.h>

Collaboration diagram for MythNotificationCenter:

[legend]

Public Member Functions
	MythNotificationCenter (void)

virtual	~MythNotificationCenter ()

bool	Queue (const MythNotification &notification)
	Queue a notification Queue() is thread-safe and can be called from anywhere. More...

int	Register (void *from)
	An application can register in which case it will be assigned a reusable screen, which can be modified or updated Register takes a pointer of the client registering. More...

void	UnRegister (void *from, int id, bool closeimemdiately=false)
	Unregister the client. More...

QDateTime	ScreenExpiryTime (const MythScreenType *screen)
	Return when the given screen is going to expire will return an invalid QDateTime if screen isn't a MythNotificationScreen. More...

bool	ScreenCreated (const MythScreenType *screen)
	Return true if ::Create() has been called on screen. More...

void	GetNotificationScreens (QList< MythScreenType * > &screens)
	Return the list of notification screens being currently displayed. More...

void	UpdateScreen (MythScreenType *screen)
	Will call ::doInit() if the screen is a MythNotificationScreen and ::Create() has been called for it already. More...

int	DisplayedNotifications (void) const
	Returns number of notifications currently displayed. More...

int	QueuedNotifications (void) const
	Returns number of notifications currently queued. More...

bool	RemoveFirst (void)
	Will remove the oldest notification from the stack return true if a screen was removed; or false if nothing was done. More...

void	ProcessQueue (void)
	ProcessQueue will be called by the GUI event handler and will process all queued MythNotifications and delete screens marked to be deleted ProcessQueue must be called from GUI thread. More...

Static Public Member Functions
static MythNotificationCenter *	GetInstance (void)
	returns the MythNotificationCenter singleton More...

Private Attributes
NCPrivate *	d {nullptr}

Detailed Description

Definition at line 33 of file mythnotificationcenter.h.

Constructor & Destructor Documentation

◆ MythNotificationCenter()

MythNotificationCenter::MythNotificationCenter ( void )

Definition at line 1339 of file mythnotificationcenter.cpp.

◆ ~MythNotificationCenter()

MythNotificationCenter::~MythNotificationCenter ( )

virtual

Definition at line 1351 of file mythnotificationcenter.cpp.

Member Function Documentation

◆ Queue()

bool MythNotificationCenter::Queue ( const MythNotification & notification )

Queue a notification Queue() is thread-safe and can be called from anywhere.

Typical use would be GetNotificationCenter()->Queue(notification)

Definition at line 1365 of file mythnotificationcenter.cpp.

Referenced by VideoDialog::createFetchDialog(), EditMetadataDialog::customEvent(), GameUI::customEvent(), VideoDialog::customEvent(), MythMainWindow::customEvent(), MusicPlayer::customEvent(), TV::customEvent(), MetadataOptions::customEvent(), MythRAOPDevice::deleteClient(), MythAirplayServer::deleteConnection(), VideoDialog::dismissFetchDialog(), MythAirplayServer::HandleResponse(), MythContextPrivate::HideConnectionFailurePopup(), MythRAOPDevice::newConnection(), EditMetadataDialog::OnArtworkSearchDone(), MetadataOptions::OnArtworkSearchDone(), MusicPlayer::play(), NetworkControl::processNotification(), MythRAOPConnection::SendNotification(), MusicPlayer::sendNotification(), MythContextPrivate::ShowConnectionFailurePopup(), and ShowNotification().

◆ GetInstance()

MythNotificationCenter * MythNotificationCenter::GetInstance ( void )

static

returns the MythNotificationCenter singleton

Definition at line 1334 of file mythnotificationcenter.cpp.

Referenced by MythMainWindow::customEvent(), TV::customEvent(), MythMainWindow::ExitToMainMenu(), and ShowNotification().

◆ Register()

int MythNotificationCenter::Register ( void * from )

An application can register in which case it will be assigned a reusable screen, which can be modified or updated Register takes a pointer of the client registering.

This is used to make sure a registered Id can only be used by the client who registered for it. Returns a unique Id that can be provided with a MythNotification Return -1 is case of error

Definition at line 1384 of file mythnotificationcenter.cpp.

Referenced by VideoDialog::createFetchDialog(), MythContextPrivate::event(), MythAirplayServer::HandleResponse(), and MythRAOPConnection::MythRAOPConnection().

◆ UnRegister()

void MythNotificationCenter::UnRegister	(	void *	from,
		int	id,
		bool	closeimemdiately = `false`
	)

Unregister the client.

If the notification had set a duration, the screen will be left to laps, unless forcedisconnect is set; in which case the screen will be closed immediately.

Definition at line 1389 of file mythnotificationcenter.cpp.

Referenced by VideoDialog::dismissFetchDialog(), MythAirplayServer::StopSession(), AirplayConnection::UnRegister(), MusicPlayer::~MusicPlayer(), MythContextPrivate::~MythContextPrivate(), and MythRAOPConnection::~MythRAOPConnection().

◆ ScreenExpiryTime()

QDateTime MythNotificationCenter::ScreenExpiryTime ( const MythScreenType * screen )

Return when the given screen is going to expire will return an invalid QDateTime if screen isn't a MythNotificationScreen.

Definition at line 1394 of file mythnotificationcenter.cpp.

Referenced by OSD::Draw(), and OSD::DrawDirect().

◆ ScreenCreated()

bool MythNotificationCenter::ScreenCreated ( const MythScreenType * screen )

Return true if ::Create() has been called on screen.

will always return true should screen not be a MythNotificationScreen

Definition at line 1404 of file mythnotificationcenter.cpp.

Referenced by OSD::Draw(), and OSD::DrawDirect().

◆ GetNotificationScreens()

void MythNotificationCenter::GetNotificationScreens ( QList< MythScreenType * > & screens )

Return the list of notification screens being currently displayed.

The list contains pointer of existing screen's copies, with ::Create() not called yet.

Definition at line 1414 of file mythnotificationcenter.cpp.

Referenced by OSD::Draw(), and OSD::DrawDirect().

◆ UpdateScreen()

void MythNotificationCenter::UpdateScreen ( MythScreenType * screen )

Will call ::doInit() if the screen is a MythNotificationScreen and ::Create() has been called for it already.

Definition at line 1419 of file mythnotificationcenter.cpp.

Referenced by OSD::Draw(), and OSD::DrawDirect().

◆ DisplayedNotifications()

int MythNotificationCenter::DisplayedNotifications ( void ) const

Returns number of notifications currently displayed.

Definition at line 1433 of file mythnotificationcenter.cpp.

Referenced by MythMainWindow::ExitToMainMenu().

◆ QueuedNotifications()

int MythNotificationCenter::QueuedNotifications ( void ) const

Returns number of notifications currently queued.

Definition at line 1438 of file mythnotificationcenter.cpp.

◆ RemoveFirst()

bool MythNotificationCenter::RemoveFirst ( void )

Will remove the oldest notification from the stack return true if a screen was removed; or false if nothing was done.

Definition at line 1443 of file mythnotificationcenter.cpp.

◆ ProcessQueue()

void MythNotificationCenter::ProcessQueue ( void )

ProcessQueue will be called by the GUI event handler and will process all queued MythNotifications and delete screens marked to be deleted ProcessQueue must be called from GUI thread.

Definition at line 1370 of file mythnotificationcenter.cpp.

Referenced by MythMainWindow::customEvent().