#include <qdeclarativetext_p_p.h>

Inheritance diagram for QDeclarativeTextPrivate:

Public Functions
void	checkImageCache ()
	Tests if the image cache is dirty, and repaints it if it is. More...

bool	determineHorizontalAlignment ()

void	drawTextLayout (QPainter *p, const QPointF &pos, bool drawStyle)
	Paints the QDeclarativeTextPrivate::layout QTextLayout into painter at pos. More...

void	ensureDoc ()
	Ensures the QDeclarativeTextPrivate::doc variable is set to a valid text document. More...

virtual qreal	implicitWidth () const

void	invalidateImageCache ()
	Mark the image cache as dirty. More...

void	mirrorChange ()

	QDeclarativeTextPrivate ()

bool	setHAlign (QDeclarativeText::HAlignment, bool forceAlign=false)

QRect	setupTextLayout ()
	Lays out the QDeclarativeTextPrivate::layout QTextLayout in the constraints of the QDeclarativeText. More...

QTextDocument *	textDocument ()

QPixmap	textDocumentImage (bool drawStyle)
	Returns a painted version of the QDeclarativeTextPrivate::doc QTextDocument. More...

QPixmap	textLayoutImage (bool drawStyle)
	Returns a painted version of the QDeclarativeTextPrivate::layout QTextLayout. More...

void	updateLayout ()

void	updateSize ()

	~QDeclarativeTextPrivate ()

Public Functions inherited from QDeclarativeImplicitSizeItemPrivate
virtual void	implicitHeightChanged ()

virtual void	implicitWidthChanged ()

	QDeclarativeImplicitSizeItemPrivate ()

Public Functions inherited from QDeclarativeItemPrivate
QDeclarativeStateGroup *	_states ()

void	addItemChangeListener (QDeclarativeItemChangeListener *listener, ChangeTypes types)

AnchorLines *	anchorLines () const

QDeclarativeAnchors *	anchors ()

QDeclarativeAnchorLine	baseline () const

QDeclarativeAnchorLine	bottom () const

QPointF	computeTransformOrigin () const

QDeclarativeListProperty< QObject >	data ()

virtual void	focusChanged (bool)

virtual void	focusScopeItemChange (bool isSubFocusItem)
	Subclasses can reimplement this function to be notified when an item becomes a focusScopeItem (or is no longer a focusScopeItem). More...

qreal	height () const

QDeclarativeAnchorLine	horizontalCenter () const

virtual qreal	implicitHeight () const

void	init (QDeclarativeItem *parent)

bool	isMirrored () const

QDeclarativeAnchorLine	left () const

	QDeclarativeItemPrivate ()

void	removeItemChangeListener (QDeclarativeItemChangeListener *, ChangeTypes types)

void	resetHeight ()

void	resetWidth ()

void	resolveLayoutMirror ()

QDeclarativeListProperty< QObject >	resources ()

QDeclarativeAnchorLine	right () const

void	setHeight (qreal)

void	setImplicitLayoutMirror (bool mirror, bool inherit)

void	setLayoutMirror (bool mirror)

virtual void	setPosHelper (const QPointF &pos)
	Sets the position pos. More...

void	setState (const QString &)

void	setWidth (qreal)

virtual void	siblingOrderChange ()
	Subclasses can reimplement this function to be notified when its siblingIndex order is changed. More...

QString	state () const

QDeclarativeListProperty< QDeclarativeState >	states ()

QDeclarativeAnchorLine	top () const

virtual void	transformChanged ()

QDeclarativeListProperty< QDeclarativeTransition >	transitions ()

QDeclarativeAnchorLine	verticalCenter () const

qreal	width () const

Public Functions inherited from QGraphicsItemPrivate
void	addChild (QGraphicsItem *child)
	QGraphicsScenePrivate::registerTopLevelItem(). More...

void	appendGraphicsTransform (QGraphicsTransform *t)

qreal	calcEffectiveOpacity () const

void	childrenBoundingRectHelper (QTransform x, QRectF rect, QGraphicsItem *topMostEffectItem)
	Returns the bounding rect of this item's children (excluding itself). More...

bool	childrenClippedToShape () const

bool	childrenCombineOpacity () const

QDeclarativeListProperty< QGraphicsObject >	childrenList ()
	Returns a list of this item's children. More...

void	clearFocusHelper (bool giveFocusToParent)

void	clearSubFocus (QGraphicsItem rootItem=0, QGraphicsItem stopItem=0)

qreal	combineOpacityFromParent (qreal parentOpacity) const

void	combineTransformFromParent (QTransform x, const QTransform viewTransform=0) const
	Combines this item's position and transform onto transform. More...

void	combineTransformToParent (QTransform x, const QTransform viewTransform=0) const
	Combines this item's position and transform onto transform. More...

int	depth () const

bool	discardUpdateRequest (bool ignoreVisibleBit=false, bool ignoreDirtyBit=false, bool ignoreOpacity=false) const
	Returns true if we can discard an update request; otherwise false. More...

QRectF	effectiveBoundingRect (QGraphicsItem *topMostEffectItem=0) const
	Returns the effective bounding rect of the item. More...

QRectF	effectiveBoundingRect (const QRectF &rect) const
	Returns the effective bounding rect of the given item space rect. More...

qreal	effectiveOpacity () const

void	ensureSceneTransform ()

void	ensureSceneTransformRecursive (QGraphicsItem **topMostDirtyItem)

void	ensureSequentialSiblingIndex ()
	Ensures that the list of children is sorted by insertion order, and that the siblingIndexes are packed (no gaps), and start at 0. More...

void	ensureSortedChildren ()

QVariant	extra (Extra type) const

QGraphicsItemCache *	extraItemCache () const

QPointF	genericMapFromScene (const QPointF &pos, const QWidget *viewport) const
	Maps the point pos from scene to item coordinates. More...

bool	hasTranslateOnlySceneTransform ()

void	initStyleOption (QStyleOptionGraphicsItem *option, const QTransform &worldTransform, const QRegion &exposedRegion, bool allItems=false) const

virtual QVariant	inputMethodQueryHelper (Qt::InputMethodQuery query) const
	This helper function helped us add input method query support in Qt 4. More...

void	invalidateChildGraphicsEffectsRecursively (InvalidateReason reason)

void	invalidateChildrenSceneTransform ()

void	invalidateDepthRecursively ()

void	invalidateParentGraphicsEffectsRecursively ()

bool	isFullyTransparent () const

bool	isInvisible () const

bool	isOpacityNull () const

virtual bool	isProxyWidget () const

bool	itemIsUntransformable () const

void	markParentDirty (bool updateBoundingRect=false)

QGraphicsItemCache *	maybeExtraItemCache () const

void	prependGraphicsTransform (QGraphicsTransform *t)

	QGraphicsItemPrivate ()

void	remapItemPos (QEvent event, QGraphicsItem item)
	Maps any item pos properties of event to item's coordinate system. More...

void	removeChild (QGraphicsItem *child)
	QGraphicsScenePrivate::unregisterTopLevelItem(). More...

void	removeExtraItemCache ()

void	resetFocusProxy ()
	Sets the focusProxy pointer to 0 for all items that have this item as their focusProxy. More...

void	resolveDepth ()
	Resolves the stacking depth of this object and all its ancestors. More...

virtual void	resolveFont (uint inheritedMask)

virtual void	resolvePalette (uint inheritedMask)

QRectF	sceneEffectiveBoundingRect () const
	Returns the effective bounding rect of this item in scene coordinates, by combining sceneTransform() with boundingRect(), taking into account the effect that the item might have. More...

void	sendScenePosChange ()

void	setEnabledHelper (bool newEnabled, bool explicitly, bool update=true)
	Sets this item's visibility to newEnabled. More...

void	setExtra (Extra type, const QVariant &value)

void	setFocusHelper (Qt::FocusReason focusReason, bool climb, bool focusFromHide)

void	setIsMemberOfGroup (bool enabled)
	Propagates item group membership. More...

void	setParentItemHelper (QGraphicsItem parent, const QVariant newParentVariant, const QVariant *thisPointerVariant)
	Make sure not to trigger any pure virtual function calls (e. More...

void	setSubFocus (QGraphicsItem rootItem=0, QGraphicsItem stopItem=0)

void	setTransformHelper (const QTransform &transform)
	Sets the transform transform. More...

void	setVisibleHelper (bool newVisible, bool explicitly, bool update=true)
	Sets this item's visibility to newVisible. More...

virtual void	subFocusItemChange ()
	Subclasses can reimplement this function to be notified when subFocusItem changes. More...

QTransform	transformToParent () const

void	unsetExtra (Extra type)

void	updateAncestorFlag (QGraphicsItem::GraphicsItemFlag childFlag, AncestorFlag flag=NoFlag, bool enabled=false, bool root=true)
	Propagates the ancestor flag flag with value enabled to all this item's children. More...

void	updateAncestorFlags ()

void	updateChildWithGraphicsEffectFlagRecursively ()

void	updatePaintedViewBoundingRects (bool updateChildren)

virtual void	updateSceneTransformFromParent ()

virtual	~QGraphicsItemPrivate ()

Static Public Functions
static QPixmap	drawOutline (const QPixmap &source, const QPixmap &styleSource)
	Draw styleSource as an outline around source and return the new image. More...

static QPixmap	drawOutline (const QPixmap &source, const QPixmap &styleSource, int yOffset)
	Draw styleSource below source at yOffset and return the new image. More...

static QDeclarativeTextPrivate *	get (QDeclarativeText *t)

Static Public Functions inherited from QDeclarativeItemPrivate
static void	data_append (QDeclarativeListProperty< QObject > , QObject )

static QObject *	data_at (QDeclarativeListProperty< QObject > *, int)

static void	data_clear (QDeclarativeListProperty< QObject > *)

static int	data_count (QDeclarativeListProperty< QObject > *)

static qint64	elapsed (QElapsedTimer &)

static QDeclarativeItemPrivate *	get (QDeclarativeItem *item)

static void	parentProperty (QObject o, void rv, QDeclarativeNotifierEndpoint *e)

static void	resources_append (QDeclarativeListProperty< QObject > , QObject )

static QObject *	resources_at (QDeclarativeListProperty< QObject > *, int)

static void	resources_clear (QDeclarativeListProperty< QObject > *)

static int	resources_count (QDeclarativeListProperty< QObject > *)

static qint64	restart (QElapsedTimer &)

static void	setConsistentTime (qint64 t)

static void	start (QElapsedTimer &)

static void	transform_append (QDeclarativeListProperty< QGraphicsTransform > list, QGraphicsTransform )

static QGraphicsTransform *	transform_at (QDeclarativeListProperty< QGraphicsTransform > *list, int)

static void	transform_clear (QDeclarativeListProperty< QGraphicsTransform > *list)

static int	transform_count (QDeclarativeListProperty< QGraphicsTransform > *list)

Static Public Functions inherited from QGraphicsItemPrivate
static void	children_append (QDeclarativeListProperty< QGraphicsObject > list, QGraphicsObject item)

static QGraphicsObject *	children_at (QDeclarativeListProperty< QGraphicsObject > *list, int)

static void	children_clear (QDeclarativeListProperty< QGraphicsObject > *list)

static int	children_count (QDeclarativeListProperty< QGraphicsObject > *list)

static const QGraphicsItemPrivate *	get (const QGraphicsItem *item)

static QGraphicsItemPrivate *	get (QGraphicsItem *item)

static bool	insertionOrder (QGraphicsItem a, QGraphicsItem b)

static bool	isOpacityNull (qreal opacity)

static bool	movableAncestorIsSelected (const QGraphicsItem *item)

Public Variables
QString	activeLink

bool	cacheAllTextAsImage:1

QColor	color

QTextDocumentWithImageResources *	doc

QDeclarativeText::TextElideMode	elideMode

QPointF	elidePos

QFont	font

QDeclarativeText::TextFormat	format

QDeclarativeText::HAlignment	hAlign

bool	hAlignImplicit:1

QPixmap	imageCache

bool	imageCacheDirty:1

bool	internalWidthUpdate:1

QRect	layedOutTextRect

QDeclarativeTextLayout	layout

bool	layoutTextElided:1

int	lineCount

qreal	lineHeight

QDeclarativeText::LineHeightMode	lineHeightMode

int	maximumLineCount

int	maximumLineCountValid

qreal	naturalWidth

QSize	paintedSize

bool	requireImplicitWidth:1

bool	richText:1

bool	rightToLeftText:1

bool	singleline:1

QFont	sourceFont

QDeclarativeText::TextStyle	style

QColor	styleColor

QString	text

bool	truncated

bool	updateOnComponentComplete:1

QDeclarativeText::VAlignment	vAlign

QDeclarativeText::WrapMode	wrapMode

Public Variables inherited from QDeclarativeItemPrivate
AnchorLines *	_anchorLines

QDeclarativeAnchors *	_anchors

QDeclarativeContents *	_contents

QDeclarativeStateGroup *	_stateGroup

QDeclarativeLayoutMirroringAttached *	attachedLayoutDirection

QDeclarativeNullableValue< qreal >	baselineOffset

QPODVector< ChangeListener, 4 >	changeListeners

bool	componentComplete:1

bool	doneEventPreHandler: 1

bool	effectiveLayoutMirror:1

bool	hadActiveFocus:1

bool	hadFocus:1

bool	heightValid:1

bool	inheritedLayoutMirror:1

bool	inheritMirrorFromItem:1

bool	inheritMirrorFromParent:1

bool	isMirrorImplicit:1

bool	keepMouse:1

QDeclarativeItemKeyFilter *	keyHandler

qreal	mHeight

qreal	mImplicitHeight

qreal	mImplicitWidth

qreal	mWidth

QDeclarativeItem::TransformOrigin	origin:5

QDeclarativeNotifier	parentNotifier

bool	smooth:1

bool	transformOriginDirty: 1

bool	widthValid:1

Public Variables inherited from QGraphicsItemPrivate
quint32	acceptDrops: 1

quint32	acceptedMouseButtons: 5

quint32	acceptedTouchBeginEvent: 1

quint32	acceptsHover: 1

quint32	acceptTouchEvents: 1

quint32	allChildrenDirty: 1

quint32	ancestorFlags: 4

quint32	cacheMode: 2

QList< QGraphicsItem * >	children

QRectF	childrenBoundingRect

quint32	dirty: 1

quint32	dirtyChildren: 1

quint32	dirtyChildrenBoundingRect: 1

quint32	dirtySceneTransform: 1

quint32	enabled: 1

quint32	explicitActivate: 1

quint32	explicitlyDisabled: 1

quint32	explicitlyHidden: 1

QList< ExtraStruct >	extras

quint32	filtersDescendantEvents: 1

quint32	flags: 19

QGraphicsItem *	focusProxy

QList< QGraphicsItem ** >	focusProxyRefs

QGraphicsItem *	focusScopeItem

quint32	fullUpdatePending: 1

quint32	geometryChanged: 1

QMap< Qt::GestureType, Qt::GestureFlags >	gestureContext

int	globalStackingOrder

QGraphicsEffect *	graphicsEffect

quint32	handlesChildEvents: 1

quint32	hasBoundingRegionGranularity: 1

quint32	hasCursor: 1

quint32	holesInSiblingIndex: 1

quint32	ignoreOpacity: 1

quint32	ignoreVisible: 1

Qt::InputMethodHints	imHints

quint32	inDestructor: 1

int	index

quint32	inSetPosHelper: 1

quint32	isDeclarativeItem: 1

quint32	isMemberOfGroup: 1

quint32	isObject: 1

quint32	isWidget: 1

int	itemDepth

quint32	itemDiscovered: 1

quint32	localCollisionHack: 1

quint32	mayHaveChildWithGraphicsEffect: 1

quint32	mouseSetsFocus: 1

quint32	needSortChildren: 1

QRectF	needsRepaint

quint32	notifyBoundingRectChanged: 1

quint32	notifyInvalidated: 1

qreal	opacity

quint32	padding: 21

QMap< QWidget *, QRect >	paintedViewBoundingRects

quint32	paintedViewBoundingRectsNeedRepaint: 1

QGraphicsItem::PanelModality	panelModality

QGraphicsItem *	parent

quint32	pendingPolish: 1

QPointF	pos

QGraphicsItem *	q_ptr

QGraphicsScene *	scene

quint32	scenePosDescendants: 1

QTransform	sceneTransform

quint32	sceneTransformTranslateOnly: 1

quint32	selected: 1

quint32	sendParentChangeNotification: 1

quint32	sequentialOrdering: 1

int	siblingIndex

QGraphicsItem *	subFocusItem

TransformData *	transformData

quint32	updateDueToGraphicsEffect: 1

quint32	visible: 1

quint32	wantsActive: 1

qreal	z

Static Public Variables
static QString	elideChar = QString(0x2026)

Static Public Variables inherited from QDeclarativeItemPrivate
static qint64	consistentTime = -1

Additional Inherited Members
Public Types inherited from QDeclarativeItemPrivate
enum	ChangeType { Geometry = 0x01, SiblingOrder = 0x02, Visibility = 0x04, Opacity = 0x08, Destroyed = 0x10 }

Public Types inherited from QGraphicsItemPrivate
enum	AncestorFlag { NoFlag = 0, AncestorHandlesChildEvents = 0x1, AncestorClipsChildren = 0x2, AncestorIgnoresTransformations = 0x4, AncestorFiltersChildEvents = 0x8 }

enum	Extra { ExtraToolTip, ExtraCursor, ExtraCacheData, ExtraMaxDeviceCoordCacheSize, ExtraBoundingRegionGranularity }

enum	InvalidateReason { OpacityChanged }

Detailed Description

Definition at line 69 of file qdeclarativetext_p_p.h.

Constructors and Destructors

◆ QDeclarativeTextPrivate()

QDeclarativeTextPrivate::QDeclarativeTextPrivate ( )

Definition at line 89 of file qdeclarativetext.cpp.

 : color((QRgb)0), style(QDeclarativeText::Normal), hAlign(QDeclarativeText::AlignLeft),
   vAlign(QDeclarativeText::AlignTop), elideMode(QDeclarativeText::ElideNone),
   format(QDeclarativeText::AutoText), wrapMode(QDeclarativeText::NoWrap), lineHeight(1),
   lineHeightMode(QDeclarativeText::ProportionalHeight), lineCount(1), truncated(false), maximumLineCount(INT_MAX),
   maximumLineCountValid(false), imageCacheDirty(true), updateOnComponentComplete(true), richText(false), singleline(false),
   cacheAllTextAsImage(true), internalWidthUpdate(false), requireImplicitWidth(false),  hAlignImplicit(true),
   rightToLeftText(false), layoutTextElided(false), naturalWidth(0), doc(0)
 {
     cacheAllTextAsImage = enableImageCache();
     QGraphicsItemPrivate::acceptedMouseButtons = Qt::LeftButton;
     QGraphicsItemPrivate::flags = QGraphicsItemPrivate::flags & ~QGraphicsItem::ItemHasNoContents;
 }

◆ ~QDeclarativeTextPrivate()

QDeclarativeTextPrivate::~QDeclarativeTextPrivate ( )

Definition at line 179 of file qdeclarativetext.cpp.

180 {

181 }

Functions

◆ checkImageCache()

void QDeclarativeTextPrivate::checkImageCache ( )

Tests if the image cache is dirty, and repaints it if it is.

Definition at line 565 of file qdeclarativetext.cpp.

 {
     if (!imageCacheDirty)
         return;
 
     if (text.isEmpty()) {
 
         imageCache = QPixmap();
 
     } else {
 
         QPixmap textImage;
         QPixmap styledImage;
 
         if (richText) {
             textImage = textDocumentImage(false);
             if (style != QDeclarativeText::Normal)
                 styledImage = textDocumentImage(true); //### should use styleColor
         } else {
             textImage = textLayoutImage(false);
             if (style != QDeclarativeText::Normal)
                 styledImage = textLayoutImage(true); //### should use styleColor
         }
 
         switch (style) {
         case QDeclarativeText::Outline:
             imageCache = drawOutline(textImage, styledImage);
             break;
         case QDeclarativeText::Sunken:
             imageCache = drawOutline(textImage, styledImage, -1);
             break;
         case QDeclarativeText::Raised:
             imageCache = drawOutline(textImage, styledImage, 1);
             break;
         default:
             imageCache = textImage;
             break;
         }
 
     } 
 
     imageCacheDirty = false;
 }

◆ determineHorizontalAlignment()

bool QDeclarativeTextPrivate::determineHorizontalAlignment ( )

Definition at line 1176 of file qdeclarativetext.cpp.

 {
     Q_Q(QDeclarativeText);
     if (hAlignImplicit && q->isComponentComplete()) {
         bool alignToRight = text.isEmpty() ? QApplication::keyboardInputDirection() == Qt::RightToLeft : rightToLeftText;
         return setHAlign(alignToRight ? QDeclarativeText::AlignRight : QDeclarativeText::AlignLeft);
     }
     return false;
 }

◆ drawOutline() [1/2]

QPixmap QDeclarativeTextPrivate::drawOutline	(	const QPixmap &	source,
		const QPixmap &	styleSource
	)

static

Draw styleSource as an outline around source and return the new image.

Definition at line 624 of file qdeclarativetext.cpp.

 {
     QPixmap img = QPixmap(styleSource.width() + 2, styleSource.height() + 2);
     img.fill(Qt::transparent);
 
     QPainter ppm(&img);
 
     QPoint pos(0, 0);
     pos += QPoint(-1, 0);
     ppm.drawPixmap(pos, styleSource);
     pos += QPoint(2, 0);
     ppm.drawPixmap(pos, styleSource);
     pos += QPoint(-1, -1);
     ppm.drawPixmap(pos, styleSource);
     pos += QPoint(0, 2);
     ppm.drawPixmap(pos, styleSource);
 
     pos += QPoint(0, -1);
     ppm.drawPixmap(pos, source);
     ppm.end();
 
     return img;
 }

◆ drawOutline() [2/2]

QPixmap QDeclarativeTextPrivate::drawOutline	(	const QPixmap &	source,
		const QPixmap &	styleSource,
		int	yOffset
	)

static

Draw styleSource below source at yOffset and return the new image.

Definition at line 651 of file qdeclarativetext.cpp.

 {
     QPixmap img = QPixmap(styleSource.width() + 2, styleSource.height() + 2);
     img.fill(Qt::transparent);
 
     QPainter ppm(&img);
 
     ppm.drawPixmap(QPoint(0, yOffset), styleSource);
     ppm.drawPixmap(0, 0, source);
 
     ppm.end();
 
     return img;
 }

◆ drawTextLayout()

void QDeclarativeTextPrivate::drawTextLayout	(	QPainter *	painter,
		const QPointF &	pos,
		bool	drawStyle
	)

Paints the QDeclarativeTextPrivate::layout QTextLayout into painter at pos.

If drawStyle is true, the style color overrides all colors in the document.

Definition at line 495 of file qdeclarativetext.cpp.

 {
     if (drawStyle)
         painter->setPen(styleColor);
     else
         painter->setPen(color);
     painter->setFont(font);
     layout.draw(painter, pos);
     if (!elidePos.isNull())
         painter->drawText(pos + elidePos, elideChar);
 }

◆ ensureDoc()

void QDeclarativeTextPrivate::ensureDoc ( )

Ensures the QDeclarativeTextPrivate::doc variable is set to a valid text document.

Definition at line 612 of file qdeclarativetext.cpp.

 {
     if (!doc) {
         Q_Q(QDeclarativeText);
         doc = new QTextDocumentWithImageResources(q);
         doc->setDocumentMargin(0);
     }
 }

◆ get()

static QDeclarativeTextPrivate* QDeclarativeTextPrivate::get ( QDeclarativeText * t )

inlinestatic

Definition at line 137 of file qdeclarativetext_p_p.h.

Referenced by QTextDocumentWithImageResources::requestFinished().

                                                                     {
         return t->d_func();
     }

◆ implicitWidth()

qreal QDeclarativeTextPrivate::implicitWidth ( ) const

virtual

Reimplemented from QDeclarativeItemPrivate.

Definition at line 183 of file qdeclarativetext.cpp.

 {
     if (!requireImplicitWidth) {
         // We don't calculate implicitWidth unless it is required.
         // We need to force a size update now to ensure implicitWidth is calculated
         QDeclarativeTextPrivate *me = const_cast<QDeclarativeTextPrivate*>(this);
         me->requireImplicitWidth = true;
         me->updateSize();
     }
     return mImplicitWidth;
 }

◆ invalidateImageCache()

void QDeclarativeTextPrivate::invalidateImageCache ( )

Mark the image cache as dirty.

Definition at line 547 of file qdeclarativetext.cpp.

 {
     Q_Q(QDeclarativeText);
 
     if(cacheAllTextAsImage || style != QDeclarativeText::Normal){//If actually using the image cache
         if (imageCacheDirty)
             return;
 
         imageCacheDirty = true;
         imageCache = QPixmap();
     }
     if (q->isComponentComplete())
         q->update();
 }

◆ mirrorChange()

void QDeclarativeTextPrivate::mirrorChange ( )

virtual

Reimplemented from QDeclarativeItemPrivate.

Definition at line 1186 of file qdeclarativetext.cpp.

 {
     Q_Q(QDeclarativeText);
     if (q->isComponentComplete()) {
         if (!hAlignImplicit && (hAlign == QDeclarativeText::AlignRight || hAlign == QDeclarativeText::AlignLeft)) {
             updateLayout();
         }
     }
 }

◆ setHAlign()

bool QDeclarativeTextPrivate::setHAlign	(	QDeclarativeText::HAlignment	alignment,
		bool	forceAlign = `false`
	)

Definition at line 1165 of file qdeclarativetext.cpp.

 {
     Q_Q(QDeclarativeText);
     if (hAlign != alignment || forceAlign) {
         hAlign = alignment;
         emit q->horizontalAlignmentChanged(hAlign);
         return true;
     }
     return false;
 }

◆ setupTextLayout()

QRect QDeclarativeTextPrivate::setupTextLayout ( )

Lays out the QDeclarativeTextPrivate::layout QTextLayout in the constraints of the QDeclarativeText.

Returns the size of the final text. This can be used to position the text vertically (the text is already absolutely positioned horizontally).

Definition at line 335 of file qdeclarativetext.cpp.

 {
     // ### text layout handling should be profiled and optimized as needed
     // what about QStackTextEngine engine(tmp, d->font.font()); QTextLayout textLayout(&engine);
     Q_Q(QDeclarativeText);
     layout.setCacheEnabled(true);
 
     qreal lineWidth = 0;
     int visibleCount = 0;
 
     //set manual width
     if (q->widthValid())
         lineWidth = q->width();
 
     QTextOption textOption = layout.textOption();
     textOption.setAlignment(Qt::Alignment(q->effectiveHAlign()));
     textOption.setWrapMode(QTextOption::WrapMode(wrapMode));
     layout.setTextOption(textOption);
 
     bool elideText = false;
     bool truncate = false;
 
     QFontMetrics fm(layout.font());
     elidePos = QPointF();
 
     if (requireImplicitWidth && q->widthValid()) {
         // requires an extra layout
         QString elidedText;
         if (layoutTextElided) {
             // We have provided elided text to the layout, but we must calculate unelided width.
             elidedText = layout.text();
             layout.setText(text);
         }
         layout.beginLayout();
         forever {
             QTextLine line = layout.createLine();
             if (!line.isValid())
                 break;
         }
         layout.endLayout();
         QRectF br;
         for (int i = 0; i < layout.lineCount(); ++i) {
             QTextLine line = layout.lineAt(i);
             br = br.united(line.naturalTextRect());
         }
         naturalWidth = br.width();
         if (layoutTextElided)
             layout.setText(elidedText);
     }
 
     if (maximumLineCountValid) {
         layout.beginLayout();
         if (!lineWidth)
             lineWidth = INT_MAX;
         int linesLeft = maximumLineCount;
         int visibleTextLength = 0;
         while (linesLeft > 0) {
             QTextLine line = layout.createLine();
             if (!line.isValid())
                 break;
 
             visibleCount++;
             if (lineWidth)
                 line.setLineWidth(lineWidth);
             visibleTextLength += line.textLength();
 
             if (--linesLeft == 0) {
                 if (visibleTextLength < text.length()) {
                     truncate = true;
                     if (elideMode==QDeclarativeText::ElideRight && q->widthValid()) {
                         qreal elideWidth = fm.width(elideChar);
                         // Need to correct for alignment
                         line.setLineWidth(lineWidth-elideWidth);
                         if (layout.text().mid(line.textStart(), line.textLength()).isRightToLeft()) {
                             line.setPosition(QPointF(line.position().x() + elideWidth, line.position().y()));
                             elidePos.setX(line.naturalTextRect().left() - elideWidth);
                         } else {
                             elidePos.setX(line.naturalTextRect().right());
                         }
                         elideText = true;
                     }
                 }
             }
         }
         layout.endLayout();
 
         //Update truncated
         if (truncated != truncate) {
             truncated = truncate;
             emit q->truncatedChanged();
         }
     } else {
         layout.beginLayout();
         forever {
             QTextLine line = layout.createLine();
             if (!line.isValid())
                 break;
             visibleCount++;
             if (lineWidth)
                 line.setLineWidth(lineWidth);
         }
         layout.endLayout();
     }
 
     qreal height = 0;
     QRectF br;
     for (int i = 0; i < layout.lineCount(); ++i) {
         QTextLine line = layout.lineAt(i);
         // set line spacing
         line.setPosition(QPointF(line.position().x(), height));
         if (elideText && i == layout.lineCount()-1) {
             elidePos.setY(height + fm.ascent());
             br = br.united(QRectF(elidePos, QSizeF(fm.width(elideChar), fm.ascent())));
         }
         br = br.united(line.naturalTextRect());
         height += (lineHeightMode == QDeclarativeText::FixedHeight) ? lineHeight : line.height() * lineHeight;
     }
     br.setHeight(height);
 
     if (!q->widthValid())
         naturalWidth = br.width();
 
     //Update the number of visible lines
     if (lineCount != visibleCount) {
         lineCount = visibleCount;
         emit q->lineCountChanged();
     }
 
     return QRect(qRound(br.x()), qRound(br.y()), qCeil(br.width()), qCeil(br.height()));
 }

◆ textDocument()

QTextDocument * QDeclarativeTextPrivate::textDocument ( )

Definition at line 1196 of file qdeclarativetext.cpp.

 {
     return doc;
 }

◆ textDocumentImage()

QPixmap QDeclarativeTextPrivate::textDocumentImage ( bool drawStyle )

Returns a painted version of the QDeclarativeTextPrivate::doc QTextDocument.

If drawStyle is true, the style color overrides all colors in the document.

Definition at line 511 of file qdeclarativetext.cpp.

 {
     QSize size = doc->size().toSize();
 
     //paint text
     QPixmap img(size);
     img.fill(Qt::transparent);
 #ifdef Q_WS_MAC
     bool oldSmooth = qt_applefontsmoothing_enabled;
     qt_applefontsmoothing_enabled = false;
 #endif
     QPainter p(&img);
 #ifdef Q_WS_MAC
     qt_applefontsmoothing_enabled = oldSmooth;
 #endif
 
     QAbstractTextDocumentLayout::PaintContext context;
 
     QTextOption oldOption(doc->defaultTextOption());
     if (drawStyle) {
         context.palette.setColor(QPalette::Text, styleColor);
         QTextOption colorOption(doc->defaultTextOption());
         colorOption.setFlags(QTextOption::SuppressColors);
         doc->setDefaultTextOption(colorOption);
     } else {
         context.palette.setColor(QPalette::Text, color);
     }
     doc->documentLayout()->draw(&p, context);
     if (drawStyle)
         doc->setDefaultTextOption(oldOption);
     return img;
 }

◆ textLayoutImage()

QPixmap QDeclarativeTextPrivate::textLayoutImage ( bool drawStyle )

Returns a painted version of the QDeclarativeTextPrivate::layout QTextLayout.

If drawStyle is true, the style color overrides all colors in the document.

Definition at line 470 of file qdeclarativetext.cpp.

 {
     //do layout
     QSize size = layedOutTextRect.size();
     //paint text
     QPixmap img(size);
     if (!size.isEmpty()) {
         img.fill(Qt::transparent);
 #ifdef Q_WS_MAC
         bool oldSmooth = qt_applefontsmoothing_enabled;
         qt_applefontsmoothing_enabled = false;
 #endif
         QPainter p(&img);
 #ifdef Q_WS_MAC
         qt_applefontsmoothing_enabled = oldSmooth;
 #endif
         drawTextLayout(&p, QPointF(-layedOutTextRect.x(),0), drawStyle);
     }
     return img;
 }

◆ updateLayout()

void QDeclarativeTextPrivate::updateLayout ( )

Definition at line 195 of file qdeclarativetext.cpp.

Referenced by QTextDocumentWithImageResources::requestFinished().

 {
     Q_Q(QDeclarativeText);
     if (!q->isComponentComplete()) {
         updateOnComponentComplete = true;
         return;
     }
 
     layoutTextElided = false;
     // Setup instance of QTextLayout for all cases other than richtext
     if (!richText) {
         layout.clearLayout();
         layout.setFont(font);
         if (format != QDeclarativeText::StyledText) {
             QString tmp = text;
             tmp.replace(QLatin1Char('\n'), QChar::LineSeparator);
             singleline = !tmp.contains(QChar::LineSeparator);
             if (singleline && !maximumLineCountValid && elideMode != QDeclarativeText::ElideNone && q->widthValid()) {
                 QFontMetrics fm(font);
                 tmp = fm.elidedText(tmp,(Qt::TextElideMode)elideMode,q->width());
                 if (tmp != text) {
                     layoutTextElided = true;
                     if (!truncated) {
                         truncated = true;
                         emit q->truncatedChanged();
                     }
                 }
             }
             layout.setText(tmp);
         } else {
             singleline = false;
             QDeclarativeStyledText::parse(text, layout);
         }
     }
 
     updateSize();
 }

◆ updateSize()

void QDeclarativeTextPrivate::updateSize ( )

Definition at line 233 of file qdeclarativetext.cpp.

Referenced by implicitWidth().

 {
     Q_Q(QDeclarativeText);
 
     if (!q->isComponentComplete()) {
         updateOnComponentComplete = true;
         return;
     }
 
     if (!requireImplicitWidth) {
         emit q->implicitWidthChanged();
         // if the implicitWidth is used, then updateSize() has already been called (recursively)
         if (requireImplicitWidth)
             return;
     }
 
     invalidateImageCache();
 
     QFontMetrics fm(font);
     if (text.isEmpty()) {
         q->setImplicitWidth(0);
         q->setImplicitHeight(fm.height());
         paintedSize = QSize(0, fm.height());
         emit q->paintedSizeChanged();
         q->update();
         return;
     }
 
     int dy = q->height();
     QSize size(0, 0);
 
     //setup instance of QTextLayout for all cases other than richtext
     if (!richText) {
         QRect textRect = setupTextLayout();
         if (layedOutTextRect.size() != textRect.size())
             q->prepareGeometryChange();
         layedOutTextRect = textRect;
         size = textRect.size();
         dy -= size.height();
     } else {
         singleline = false; // richtext can't elide or be optimized for single-line case
         ensureDoc();
         doc->setDefaultFont(font);
 
         QDeclarativeText::HAlignment horizontalAlignment = q->effectiveHAlign();
         if (rightToLeftText) {
             if (horizontalAlignment == QDeclarativeText::AlignLeft)
                 horizontalAlignment = QDeclarativeText::AlignRight;
             else if (horizontalAlignment == QDeclarativeText::AlignRight)
                 horizontalAlignment = QDeclarativeText::AlignLeft;
         }
         QTextOption option;
         option.setAlignment((Qt::Alignment)int(horizontalAlignment | vAlign));
         option.setWrapMode(QTextOption::WrapMode(wrapMode));
         doc->setDefaultTextOption(option);
         if (requireImplicitWidth && q->widthValid()) {
             doc->setTextWidth(-1);
             naturalWidth = doc->idealWidth();
         }
         if (q->widthValid())
             doc->setTextWidth(q->width());
         else
             doc->setTextWidth(doc->idealWidth()); // ### Text does not align if width is not set (QTextDoc bug)
         dy -= (int)doc->size().height();
         QSize dsize = doc->size().toSize();
         if (dsize != layedOutTextRect.size()) {
             q->prepareGeometryChange();
             layedOutTextRect = QRect(QPoint(0,0), dsize);
         }
         size = QSize(int(doc->idealWidth()),dsize.height());
     }
     int yoff = 0;
 
     if (q->heightValid()) {
         if (vAlign == QDeclarativeText::AlignBottom)
             yoff = dy;
         else if (vAlign == QDeclarativeText::AlignVCenter)
             yoff = dy/2;
     }
     q->setBaselineOffset(fm.ascent() + yoff);
 
     //### need to comfirm cost of always setting these for richText
     internalWidthUpdate = true;
     if (!q->widthValid())
         q->setImplicitWidth(size.width());
     else if (requireImplicitWidth)
         q->setImplicitWidth(naturalWidth);
     internalWidthUpdate = false;
     q->setImplicitHeight(size.height());
     if (paintedSize != size) {
         paintedSize = size;
         emit q->paintedSizeChanged();
     }
     q->update();
 }

Properties

◆ activeLink

QString QDeclarativeTextPrivate::activeLink

Definition at line 90 of file qdeclarativetext_p_p.h.

◆ cacheAllTextAsImage

bool QDeclarativeTextPrivate::cacheAllTextAsImage

Definition at line 114 of file qdeclarativetext_p_p.h.

Referenced by QDeclarativeTextPrivate().

◆ color

QColor QDeclarativeTextPrivate::color

Definition at line 87 of file qdeclarativetext_p_p.h.

◆ doc

QTextDocumentWithImageResources* QDeclarativeTextPrivate::doc

Definition at line 127 of file qdeclarativetext_p_p.h.

◆ elideChar

QString QDeclarativeTextPrivate::elideChar = QString(0x2026)

static

Definition at line 104 of file qdeclarativetext_p_p.h.

◆ elideMode

QDeclarativeText::TextElideMode QDeclarativeTextPrivate::elideMode

Definition at line 93 of file qdeclarativetext_p_p.h.

◆ elidePos

QPointF QDeclarativeTextPrivate::elidePos

Definition at line 102 of file qdeclarativetext_p_p.h.

◆ font

QFont QDeclarativeTextPrivate::font

Definition at line 85 of file qdeclarativetext_p_p.h.

◆ format

QDeclarativeText::TextFormat QDeclarativeTextPrivate::format

Definition at line 94 of file qdeclarativetext_p_p.h.

◆ hAlign

QDeclarativeText::HAlignment QDeclarativeTextPrivate::hAlign

Definition at line 91 of file qdeclarativetext_p_p.h.

◆ hAlignImplicit

bool QDeclarativeTextPrivate::hAlignImplicit

Definition at line 117 of file qdeclarativetext_p_p.h.

◆ imageCache

QPixmap QDeclarativeTextPrivate::imageCache

Definition at line 108 of file qdeclarativetext_p_p.h.

◆ imageCacheDirty

bool QDeclarativeTextPrivate::imageCacheDirty

Definition at line 110 of file qdeclarativetext_p_p.h.

◆ internalWidthUpdate

bool QDeclarativeTextPrivate::internalWidthUpdate

Definition at line 115 of file qdeclarativetext_p_p.h.

◆ layedOutTextRect

QRect QDeclarativeTextPrivate::layedOutTextRect

Definition at line 121 of file qdeclarativetext_p_p.h.

◆ layout

QDeclarativeTextLayout QDeclarativeTextPrivate::layout

Definition at line 132 of file qdeclarativetext_p_p.h.

◆ layoutTextElided

bool QDeclarativeTextPrivate::layoutTextElided

Definition at line 119 of file qdeclarativetext_p_p.h.

◆ lineCount

int QDeclarativeTextPrivate::lineCount

Definition at line 98 of file qdeclarativetext_p_p.h.

◆ lineHeight

qreal QDeclarativeTextPrivate::lineHeight

Definition at line 96 of file qdeclarativetext_p_p.h.

◆ lineHeightMode

QDeclarativeText::LineHeightMode QDeclarativeTextPrivate::lineHeightMode

Definition at line 97 of file qdeclarativetext_p_p.h.

◆ maximumLineCount

int QDeclarativeTextPrivate::maximumLineCount

Definition at line 100 of file qdeclarativetext_p_p.h.

◆ maximumLineCountValid

int QDeclarativeTextPrivate::maximumLineCountValid

Definition at line 101 of file qdeclarativetext_p_p.h.

◆ naturalWidth

qreal QDeclarativeTextPrivate::naturalWidth

Definition at line 123 of file qdeclarativetext_p_p.h.

◆ paintedSize

QSize QDeclarativeTextPrivate::paintedSize

Definition at line 122 of file qdeclarativetext_p_p.h.

◆ requireImplicitWidth

bool QDeclarativeTextPrivate::requireImplicitWidth

Definition at line 116 of file qdeclarativetext_p_p.h.

Referenced by implicitWidth().

◆ richText

bool QDeclarativeTextPrivate::richText

Definition at line 112 of file qdeclarativetext_p_p.h.

◆ rightToLeftText

bool QDeclarativeTextPrivate::rightToLeftText

Definition at line 118 of file qdeclarativetext_p_p.h.

◆ singleline

bool QDeclarativeTextPrivate::singleline

Definition at line 113 of file qdeclarativetext_p_p.h.

◆ sourceFont

QFont QDeclarativeTextPrivate::sourceFont

Definition at line 86 of file qdeclarativetext_p_p.h.

◆ style

QDeclarativeText::TextStyle QDeclarativeTextPrivate::style

Definition at line 88 of file qdeclarativetext_p_p.h.

◆ styleColor

QColor QDeclarativeTextPrivate::styleColor

Definition at line 89 of file qdeclarativetext_p_p.h.

◆ text

QString QDeclarativeTextPrivate::text

Definition at line 84 of file qdeclarativetext_p_p.h.

◆ truncated

bool QDeclarativeTextPrivate::truncated

Definition at line 99 of file qdeclarativetext_p_p.h.

◆ updateOnComponentComplete

bool QDeclarativeTextPrivate::updateOnComponentComplete

Definition at line 111 of file qdeclarativetext_p_p.h.

◆ vAlign

QDeclarativeText::VAlignment QDeclarativeTextPrivate::vAlign

Definition at line 92 of file qdeclarativetext_p_p.h.

◆ wrapMode

QDeclarativeText::WrapMode QDeclarativeTextPrivate::wrapMode

Definition at line 95 of file qdeclarativetext_p_p.h.

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

/src/declarative/graphicsitems/qdeclarativetext_p_p.h
/src/declarative/graphicsitems/qdeclarativetext.cpp

Public Functions

Static Public Functions

Public Variables

Static Public Variables

Additional Inherited Members

Detailed Description

Constructors and Destructors

◆ QDeclarativeTextPrivate()

◆ ~QDeclarativeTextPrivate()

Functions

◆ checkImageCache()

◆ determineHorizontalAlignment()

◆ drawOutline() [1/2]

◆ drawOutline() [2/2]

◆ drawTextLayout()

◆ ensureDoc()

◆ get()

◆ implicitWidth()

◆ invalidateImageCache()

◆ mirrorChange()

◆ setHAlign()

◆ setupTextLayout()

◆ textDocument()

◆ textDocumentImage()

◆ textLayoutImage()

◆ updateLayout()

◆ updateSize()

Properties

◆ activeLink

◆ cacheAllTextAsImage

◆ color

◆ doc

◆ elideChar

◆ elideMode

◆ elidePos

◆ font

◆ format

◆ hAlign

◆ hAlignImplicit

◆ imageCache

◆ imageCacheDirty

◆ internalWidthUpdate

◆ layedOutTextRect

◆ layout

◆ layoutTextElided

◆ lineCount

◆ lineHeight

◆ lineHeightMode

◆ maximumLineCount

◆ maximumLineCountValid

◆ naturalWidth

◆ paintedSize

◆ requireImplicitWidth

◆ richText

◆ rightToLeftText

◆ singleline

◆ sourceFont

◆ style

◆ styleColor

◆ text

◆ truncated

◆ updateOnComponentComplete

◆ vAlign

◆ wrapMode