MythUIText Class Reference
[MythUI Widget and theme handling]

All purpose text widget, displays a text string. More...

#include <mythuitext.h>

Inheritance diagram for MythUIText:

Public Member Functions
	MythUIText (MythUIType *parent, const QString &name)
	MythUIText (const QString &text, const MythFontProperties &font, QRect displayRect, QRect altDisplayRect, MythUIType *parent, const QString &name)
	~MythUIText ()
void	Reset (void)
	Reset the widget to it's original state, should not reset changes made by the theme.
virtual void	SetText (const QString &text)
QString	GetText (void) const
QString	GetDefaultText (void) const
void	SetTextFromMap (QHash< QString, QString > &map)
void	SetTemplateText (const QString &text)
QString	GetTemplateText (void) const
void	UseAlternateArea (bool useAlt)
virtual void	Pulse (void)
	Pulse is called 70 times a second to trigger a single frame of an animation.
QPoint	CursorPosition (int text_offset)
void	SetDBValue (const QString &text)
QString	GetDBValue (void) const
void	SetFontState (const QString &)
void	SetJustification (int just)
Protected Types
enum	Constants { ScrollBounceDelay = 250 }
enum	ScrollDir { ScrollNone, ScrollLeft, ScrollRight, ScrollUp, ScrollDown, ScrollHorizontal, ScrollVertical }
enum	TextCase { CaseNormal, CaseUpper, CaseLower, CaseCapitaliseFirst, CaseCapitaliseAll }
Protected Member Functions
virtual void	DrawSelf (MythPainter *p, int xoffset, int yoffset, int alphaMod, QRect clipRect)
virtual bool	ParseElement (const QString &filename, QDomElement &element, bool showWarnings)
	Parse the xml definition of this widget setting the state of the object accordingly.
virtual void	CopyFrom (MythUIType *base)
	Copy this widgets state from another.
virtual void	CreateCopy (MythUIType *parent)
	Copy the state of this widget to the one given, it must be of the same type.
virtual void	Finalize (void)
	Perform any post-xml parsing initialisation tasks.
void	SetFontProperties (const MythFontProperties &fontProps)
const MythFontProperties *	GetFontProperties ()
void	CycleColor (QColor startColor, QColor endColor, int numSteps)
void	StopCycling ()
int	GetJustification (void)
void	SetCutDown (Qt::TextElideMode mode)
Qt::TextElideMode	GetCutDown (void) const
void	SetMultiLine (bool multiline)
bool	GetMultiLine (void) const
void	SetArea (const MythRect &rect)
void	SetPosition (const MythPoint &pos)
MythRect	GetDrawRect (void)
void	SetCanvasPosition (int x, int y)
void	ShiftCanvas (int x, int y)
bool	Layout (QString &paragraph, QTextLayout *layout, bool final, bool &overflow, qreal width, qreal &height, bool force, qreal &last_line_width, QRectF &min_rect, int &num_lines)
bool	LayoutParagraphs (const QStringList &paragraphs, const QTextOption &textoption, qreal width, qreal &height, QRectF &min_rect, qreal &last_line_width, int &num_lines, bool final)
bool	GetNarrowWidth (const QStringList &paragraphs, const QTextOption &textoption, qreal &width)
void	FillCutMessage (void)
Protected Attributes
int	m_Justification
MythRect	m_OrigDisplayRect
MythRect	m_AltDisplayRect
MythRect	m_Canvas
MythRect	m_drawRect
QPoint	m_cursorPos
QString	m_Message
QString	m_CutMessage
QString	m_DefaultMessage
QString	m_TemplateText
bool	m_usingAltArea
bool	m_ShrinkNarrow
Qt::TextElideMode	m_Cutdown
bool	m_MultiLine
int	m_Ascent
int	m_Descent
int	m_leftBearing
int	m_rightBearing
int	m_Leading
int	m_extraLeading
int	m_lineHeight
int	m_textCursor
QVector< QTextLayout * >	m_Layouts
MythFontProperties *	m_Font
QMap< QString, MythFontProperties >	m_FontStates
bool	m_colorCycling
QColor	m_startColor
QColor	m_endColor
int	m_numSteps
int	m_curStep
float	curR
float	curG
float	curB
float	incR
float	incG
float	incB
int	m_scrollPause
int	m_scrollOffset
bool	m_scrollBounce
bool	m_scrolling
ScrollDir	m_scrollDirection
TextCase	m_textCase
Friends
class	MythUITextEdit
class	MythUIButton
class	MythThemedMenu
class	MythThemedMenuPrivate

Detailed Description

All purpose text widget, displays a text string.

Font, alignment, scrolling and color cycling effects may be applied to the text in this widget.

Definition at line 26 of file mythuitext.h.

Member Enumeration Documentation

enum MythUIText::Constants [protected]

Enumerator:

ScrollBounceDelay

Definition at line 138 of file mythuitext.h.

enum MythUIText::ScrollDir [protected]

Enumerator:

ScrollNone
ScrollLeft
ScrollRight
ScrollUp
ScrollDown
ScrollHorizontal
ScrollVertical

Definition at line 139 of file mythuitext.h.

enum MythUIText::TextCase [protected]

Enumerator:

CaseNormal
CaseUpper
CaseLower
CaseCapitaliseFirst
CaseCapitaliseAll

Definition at line 148 of file mythuitext.h.

Constructor & Destructor Documentation

MythUIText::MythUIText	(	MythUIType *	parent,
		const QString &	name
	)

Definition at line 21 of file mythuitext.cpp.

Referenced by CreateCopy().

MythUIText::MythUIText	(	const QString &	text,
		const MythFontProperties &	font,
		QRect	displayRect,
		QRect	altDisplayRect,
		MythUIType *	parent,
		const QString &	name
	)

Definition at line 52 of file mythuitext.cpp.

MythUIText::~MythUIText ( )

Definition at line 91 of file mythuitext.cpp.

Member Function Documentation

void MythUIText::Reset ( void ) [virtual]

Reset the widget to it's original state, should not reset changes made by the theme.

Reimplemented from MythUIType.

Definition at line 101 of file mythuitext.cpp.

Referenced by ProgLister::ClearCurrentProgramInfo(), GameUI::clearRomInfo(), MythNews::clearSites(), DoResetMap(), NetSearch::doSearch(), ImportIconsWizard::enableControls(), ImportMusicDialog::fillWidgets(), ImportNative::findChannelMatch(), ZMPlayer::getEventInfo(), ArchiveFileSelector::itemSelected(), MythUIFileBrowser::PathSelected(), MythControls::RefreshKeyInformation(), MythScreenType::SetFocusWidget(), GuideGrid::SetJumpToChannel(), MythUIButtonListItem::SetToRealButton(), MusicCommon::stop(), ThemeChooser::toggleFullscreenPreview(), ExportNative::updateArchiveList(), ProgFinder::updateInfo(), IdleScreen::UpdateScreen(), ImportCoverArtDialog::updateStatus(), MusicCommon::updateTrackInfo(), and VideoSelector::updateVideoList().

void MythUIText::SetText ( const QString & text ) [virtual]

Reimplemented in MythUIClock.

Definition at line 115 of file mythuitext.cpp.

Referenced by ProgramRecPriority::changeRecPriority(), ThumbFinder::changeSeekAmount(), CustomEdit::clauseChanged(), CopyFrom(), FunctionDialog::Create(), ScreenSetup::Create(), Weather::Create(), ViewScheduleDiff::Create(), PlotDialog::Create(), RawSettingsEditor::Create(), PowerSearchPopup::Create(), PhrasePopup::Create(), ProgLister::Create(), GroupSelector::Create(), MythUIProgressDialog::Create(), MythUIBusyDialog::Create(), MythNewsEditor::Create(), MythNews::Create(), MythTimeInputDialog::Create(), MythUISearchDialog::Create(), MythTextInputDialog::Create(), MythConfirmationDialog::Create(), MythDialogBox::Create(), ProfileDialog::Create(), KeyGrabPopupBox::Create(), ImportNative::Create(), ArchiveFileSelector::Create(), FileSelector::Create(), BookmarkManager::Create(), BrowserConfig::Create(), BookmarkEditor::Create(), ProgFinder::customEvent(), MythControls::customEvent(), MusicCommon::customEvent(), GuideGrid::customEvent(), RipStatus::customEvent(), StatusBox::doAutoExpireList(), StatusBox::doJobQueueStatus(), StatusBox::doListingsStatus(), ImportIconsWizard::doLoad(), StatusBox::doLogEntries(), StatusBox::doMachineStatus(), StatusBox::doScheduleStatus(), LocationDialog::doSearch(), StatusBox::doTunerStatus(), ZMEvents::eventChanged(), SelectDestination::filenameEditLostFocus(), ViewScheduled::FillList(), EditRomInfoDialog::fillWidgets(), ImportMusicDialog::fillWidgets(), GalleryFilterDialog::fillWidgets(), EditMetadataDialog::fillWidgets(), MythUITextEdit::Finalize(), ImportNative::findChannelMatch(), ZMConsole::getDaemonStatus(), ZMPlayer::getEventInfo(), ZMPlayer::getFrame(), MythNews::getHttpFile(), ImportNative::gotCallsign(), ImportNative::gotChanID(), ImportNative::gotChanNo(), ImportNative::gotName(), EditAlbumartDialog::gridItemChanged(), ProgLister::HandleSelected(), GameDetailsPopup::handleText(), RawSettingsEditor::Init(), GuideGrid::Init(), ThemeChooser::itemChanged(), ImportIconsWizard::itemChanged(), ChannelEditor::itemChanged(), LocationDialog::itemSelected(), ArchiveFileSelector::itemSelected(), StatusBox::keyPressEvent(), KeyGrabPopupBox::keyPressEvent(), PostProcMixin::Load(), GeneralSetupWizard::loadData(), ImportIconsWizard::manualSearch(), ImportIconsWizard::menuSelection(), GeneralSetupWizard::OnDeletePromptReturn(), GeneralSetupWizard::OnSubmitPromptReturn(), VideoSelector::parentalLevelChanged(), ParseElement(), MythUIFileBrowser::PathSelected(), ProfileDialog::profileChanged(), MythUIBusyDialog::Pulse(), MythControls::RefreshKeyInformation(), Reset(), NetSearch::searchFinished(), MusicCommon::seek(), RawSettingsEditor::selectionChanged(), EditRomInfoDialog::SetBoxart(), MythThemedMenu::setButtonActive(), SelectDestination::setDestination(), EditRomInfoDialog::SetFanart(), MythScreenType::SetFocusWidget(), StatusBox::setHelpText(), MythConfirmationDialog::SetMessage(), EditRomInfoDialog::SetScreenshot(), MythUIButton::SetState(), MythUITextEdit::SetText(), MythUIButton::SetText(), MythDialogBox::SetText(), SetTextFromMap(), MythUIButtonListItem::SetToRealButton(), Weather::SetupScreens(), Weather::showScreen(), BrowserConfig::slotFocusChanged(), RSSEditor::slotItemChanged(), MythBrowser::slotStatusBarMessage(), MythUISearchDialog::slotUpdateList(), SourceSetup::sourceListItemSelected(), MusicCommon::stop(), ImportIconsWizard::submit(), MusicCommon::switchVisualizer(), DVDThemeSelector::themeChanged(), VideoSelector::titleChanged(), RecordingSelector::titleChanged(), ExportNative::titleChanged(), ThemeChooser::toggleFullscreenPreview(), GuideGrid::toggleGuideListing(), SmartPLResultViewer::trackSelected(), VideoFilterDialog::update_numvideo(), ProgLister::UpdateButtonList(), Player::updateCamera(), ThumbFinder::updateCurrentPos(), GuideGrid::updateDateText(), ProgLister::UpdateDisplay(), GalleryFilterDialog::updateFilter(), ScreenSetup::updateHelpText(), ProgramRecPriority::updateInfo(), ProgFinder::updateInfo(), ChannelRecPriority::updateInfo(), MythNews::updateInfoView(), GuideGrid::updateJumpToChannel(), LogViewer::updateLogItem(), MythDialogBox::updateMenu(), MythUIProgressDialog::UpdateProgress(), PlaybackBox::updateRecList(), GameUI::updateRomInfo(), WelcomeDialog::updateScreen(), ScreenWizard::updateScreen(), IdleScreen::UpdateScreen(), MythBurn::updateSizeBar(), ExportNative::updateSizeBar(), Player::updateStatus(), ImportCoverArtDialog::updateStatus(), ZMConsole::updateTime(), SearchView::updateTracksList(), PlaybackBox::UpdateUsageUI(), and SmartPLDateDialog::valueChanged().

QString MythUIText::GetText ( void ) const

Definition at line 191 of file mythuitext.cpp.

Referenced by ImportNative::finishedPressed(), SmartPLDateDialog::getDate(), ImportNative::searchCallsign(), ImportNative::searchChanID(), ImportNative::searchChanNo(), ImportNative::searchName(), and ZMConsole::updateTime().

QString MythUIText::GetDefaultText ( void ) const

Definition at line 196 of file mythuitext.cpp.

Referenced by MythUIButton::GetDefaultText(), MythUIButton::SetInitialStates(), and SetTextFromMap().

void MythUIText::SetTextFromMap ( QHash< QString, QString > & map )

Definition at line 138 of file mythuitext.cpp.

Referenced by DoSetTextFromMap(), MythMusicVolumeDialog::updateDisplay(), and MusicCommon::updateVolume().

void MythUIText::SetTemplateText ( const QString & text ) [inline]

Definition at line 43 of file mythuitext.h.

QString MythUIText::GetTemplateText ( void ) const [inline]

Definition at line 44 of file mythuitext.h.

Referenced by SetTextFromMap(), and MythUIButtonListItem::SetToRealButton().

void MythUIText::UseAlternateArea ( bool useAlt )

Definition at line 237 of file mythuitext.cpp.

void MythUIText::Pulse ( void ) [virtual]

Pulse is called 70 times a second to trigger a single frame of an animation.

This changes the alpha value of the widget

Reimplemented from MythUIType.

Reimplemented in MythUIClock.

Definition at line 1003 of file mythuitext.cpp.

QPoint MythUIText::CursorPosition ( int text_offset )

Definition at line 924 of file mythuitext.cpp.

Referenced by MythUITextEdit::Finalize(), and MythUITextEdit::MoveCursor().

void MythUIText::SetDBValue ( const QString & text ) [inline, virtual]

Implements StorageUser.

Definition at line 54 of file mythuitext.h.

QString MythUIText::GetDBValue ( void ) const [inline, virtual]

Implements StorageUser.

Definition at line 55 of file mythuitext.h.

void MythUIText::SetFontState ( const QString & state )

Definition at line 215 of file mythuitext.cpp.

Referenced by ZMConsole::getDaemonStatus(), Reset(), MythUIButton::SetState(), MythUIButtonListItem::SetToRealButton(), Player::updateStatus(), and SmartPLDateDialog::valueChanged().

void MythUIText::SetJustification ( int just )

Definition at line 254 of file mythuitext.cpp.

Referenced by ParseElement().

void MythUIText::DrawSelf	(	MythPainter *	p,
		int	xoffset,
		int	yoffset,
		int	alphaMod,
		QRect	clipRect
	)			`[protected, virtual]`

Reimplemented from MythUIType.

Definition at line 353 of file mythuitext.cpp.

bool MythUIText::ParseElement	(	const QString &	filename,
		QDomElement &	element,
		bool	showWarnings
	)			`[protected, virtual]`

Parse the xml definition of this widget setting the state of the object accordingly.

Reimplemented from MythUIType.

Reimplemented in MythUIClock.

Definition at line 1168 of file mythuitext.cpp.

void MythUIText::CopyFrom ( MythUIType * base ) [protected, virtual]

Copy this widgets state from another.

Reimplemented from MythUIType.

Reimplemented in MythUIClock.

Definition at line 1350 of file mythuitext.cpp.

Referenced by CreateCopy().

void MythUIText::CreateCopy ( MythUIType * parent ) [protected, virtual]

Copy the state of this widget to the one given, it must be of the same type.

Reimplemented from MythUIType.

Reimplemented in MythUIClock.

Definition at line 1413 of file mythuitext.cpp.

void MythUIText::Finalize ( void ) [protected, virtual]

Perform any post-xml parsing initialisation tasks.

This is called after the widget has been created and it's state established by ParseElement() or CopyFrom(). A derived class should use this to perform any initialisation tasks which should occur after this point.

Reimplemented from MythUIType.

Definition at line 1420 of file mythuitext.cpp.

void MythUIText::SetFontProperties ( const MythFontProperties & fontProps ) [protected]

Definition at line 201 of file mythuitext.cpp.

const MythFontProperties* MythUIText::GetFontProperties ( ) [inline, protected]

Definition at line 71 of file mythuitext.h.

Referenced by DrawSelf(), FillCutMessage(), Layout(), and MythUITextEdit::SetInitialStates().

void MythUIText::CycleColor	(	QColor	startColor,
		QColor	endColor,
		int	numSteps
	)			`[protected]`

Definition at line 1137 of file mythuitext.cpp.

Referenced by ParseElement().

void MythUIText::StopCycling ( void ) [protected]

Definition at line 1158 of file mythuitext.cpp.

int MythUIText::GetJustification ( void ) [protected]

Definition at line 273 of file mythuitext.cpp.

void MythUIText::SetCutDown ( Qt::TextElideMode mode ) [protected]

Definition at line 278 of file mythuitext.cpp.

Referenced by ParseElement(), and MythUITextEdit::SetInitialStates().

Qt::TextElideMode MythUIText::GetCutDown ( void ) const [inline, protected]

Definition at line 78 of file mythuitext.h.

void MythUIText::SetMultiLine ( bool multiline ) [protected]

Definition at line 298 of file mythuitext.cpp.

Referenced by ParseElement().

bool MythUIText::GetMultiLine ( void ) const [inline, protected]

Definition at line 80 of file mythuitext.h.

void MythUIText::SetArea ( const MythRect & rect ) [protected, virtual]

Reimplemented from MythUIType.

Definition at line 317 of file mythuitext.cpp.

Referenced by MythUIText(), ParseElement(), and UseAlternateArea().

void MythUIText::SetPosition ( const MythPoint & pos ) [protected, virtual]

Reimplemented from MythUIType.

Definition at line 326 of file mythuitext.cpp.

MythRect MythUIText::GetDrawRect ( void ) [inline, protected]

Definition at line 84 of file mythuitext.h.

void MythUIText::SetCanvasPosition	(	int	x,
		int	y
	)			`[protected]`

Definition at line 332 of file mythuitext.cpp.

Referenced by Pulse().

void MythUIText::ShiftCanvas	(	int	x,
		int	y
	)			`[protected]`

Definition at line 343 of file mythuitext.cpp.

Referenced by Pulse().

bool MythUIText::Layout	(	QString &	paragraph,
		QTextLayout *	layout,
		bool	final,
		bool &	overflow,
		qreal	width,
		qreal &	height,
		bool	force,
		qreal &	last_line_width,
		QRectF &	min_rect,
		int &	num_lines
	)			`[protected]`

Definition at line 448 of file mythuitext.cpp.

Referenced by LayoutParagraphs().

bool MythUIText::LayoutParagraphs	(	const QStringList &	paragraphs,
		const QTextOption &	textoption,
		qreal	width,
		qreal &	height,
		QRectF &	min_rect,
		qreal &	last_line_width,
		int &	num_lines,
		bool	final
	)			`[protected]`