Detailed Description
The QStyleSheetItem class provides an encapsulation of a set of text styles.
A style sheet item consists of a name and a set of attributes that
specifiy its font, color, etc. When used in a style sheet (see styleSheet()), items define the name() of
a rich text tag and the display property changes associated with
it.
The display mode
attribute indicates whether the item is a block, an inline element
or a list element; see setDisplayMode(). The treatment of
whitespace is controlled by the white space mode; see
setWhiteSpaceMode(). An item's margins are set with setMargin(),
In the case of list items, the list style is set with
setListStyle(). An item may be a hypertext link anchor; see
setAnchor(). Other attributes are set with setAlignment(),
setVerticalAlignment(), setFontFamily(), setFontSize(),
setFontWeight(), setFontItalic(), setFontUnderline(),
setFontStrikeOut and setColor().
See also Text Related Classes.
Member Type Documentation
QStyleSheetItem::DisplayMode
This enum type defines the way adjacent elements are displayed.
- QStyleSheetItem::DisplayBlock - elements are displayed as a rectangular block
(e.g. <p>...</p>).
- QStyleSheetItem::DisplayInline - elements are displayed in a horizontally
flowing sequence (e.g. <em>...</em>).
- QStyleSheetItem::DisplayListItem - elements are displayed in a vertical
sequence (e.g. <li>...</li>).
- QStyleSheetItem::DisplayNone - elements are not displayed at all.
QStyleSheetItem::ListStyle
This enum type defines how the items in a list are prefixed when
displayed.
- QStyleSheetItem::ListDisc - a filled circle (i.e. a bullet)
- QStyleSheetItem::ListCircle - an unfilled circle
- QStyleSheetItem::ListSquare - a filled square
- QStyleSheetItem::ListDecimal - an integer in base 10: 1, 2, 3, ...
- QStyleSheetItem::ListLowerAlpha - a lowercase letter: a, b, c, ...
- QStyleSheetItem::ListUpperAlpha - an uppercase letter: A, B, C, ...
QStyleSheetItem::Margin
- QStyleSheetItem::MarginLeft - left margin
- QStyleSheetItem::MarginRight - right margin
- QStyleSheetItem::MarginTop - top margin
- QStyleSheetItem::MarginBottom - bottom margin
- QStyleSheetItem::MarginAll - all margins (left, right, top and bottom)
- QStyleSheetItem::MarginVertical - top and bottom margins
- QStyleSheetItem::MarginHorizontal - left and right margins
- QStyleSheetItem::MarginFirstLine - margin (indentation) of the first line of
a paragarph (in addition to the MarginLeft of the paragraph)
QStyleSheetItem::VerticalAlignment
This enum type defines the way elements are aligned vertically.
This is only supported for text elements.
- QStyleSheetItem::VAlignBaseline - align the baseline of the element (or the
bottom, if the element doesn't have a baseline) with the
baseline of the parent
- QStyleSheetItem::VAlignSub - subscript the element
- QStyleSheetItem::VAlignSuper - superscript the element
QStyleSheetItem::WhiteSpaceMode
This enum defines the ways in which QStyleSheet can treat
whitespace.
- QStyleSheetItem::WhiteSpaceNormal - any sequence of whitespace (including
line-breaks) is equivalent to a single space.
- QStyleSheetItem::WhiteSpacePre - whitespace must be output exactly as given
in the input.
- QStyleSheetItem::WhiteSpaceNoWrap - multiple spaces are collapsed as with
WhiteSpaceNormal, but no automatic line-breaks occur. To break
lines manually, use the <br> tag.
Member Function Documentation
QStyleSheetItem::QStyleSheetItem ( QStyleSheet * parent, const QString & name )
Constructs a new style called name for the stylesheet parent.
All properties in QStyleSheetItem are initially in the "do not
change" state, except display
mode, which defaults to DisplayInline.
QStyleSheetItem::QStyleSheetItem ( const QStyleSheetItem & other )
Copy constructor. Constructs a copy of other that is not bound
to any style sheet.
QStyleSheetItem::~QStyleSheetItem ()
Destroys the style. Note that QStyleSheetItem objects become
owned by QStyleSheet when they are created.
int QStyleSheetItem::alignment () const
Returns the alignment of this style. Possible values are AlignAuto, AlignLeft, AlignRight, AlignCenter or AlignJustify.
See also setAlignment() and Qt::AlignmentFlags.
bool QStyleSheetItem::allowedInContext ( const QStyleSheetItem * s ) const
Returns TRUE if this style can be nested into an element of style
s; otherwise returns FALSE.
See also contexts() and setContexts().
QColor QStyleSheetItem::color () const
Returns the text color of this style or an invalid color if no
color has been set.
See also setColor() and QColor::isValid().
QString QStyleSheetItem::contexts () const
Returns a space-separated list of names of styles that may contain
elements of this style. If nothing has been set, contexts()
returns an empty string, which indicates that this style can be
nested everywhere.
See also setContexts().
bool QStyleSheetItem::definesFontItalic () const
Returns TRUE if the style defines a font shape; otherwise returns
FALSE. A style does not define any shape until setFontItalic() is
called.
See also setFontItalic() and fontItalic().
bool QStyleSheetItem::definesFontStrikeOut () const
Returns TRUE if the style defines a setting for the strikeOut
property of the font; otherwise returns FALSE. A style does not
define this until setFontStrikeOut() is called.
See also setFontStrikeOut() and fontStrikeOut().
bool QStyleSheetItem::definesFontUnderline () const
Returns TRUE if the style defines a setting for the underline
property of the font; otherwise returns FALSE. A style does not
define this until setFontUnderline() is called.
See also setFontUnderline() and fontUnderline().
DisplayMode QStyleSheetItem::displayMode () const
Returns the display
mode of the style.
See also setDisplayMode().
QString QStyleSheetItem::fontFamily () const
Returns the font family setting of the style. This is either a
valid font family or QString::null if no family has been set.
See also setFontFamily(), QFont::family(), and QFont::setFamily().
bool QStyleSheetItem::fontItalic () const
Returns TRUE if the style sets an italic font; otherwise returns
FALSE.
See also setFontItalic() and definesFontItalic().
int QStyleSheetItem::fontSize () const
Returns the font size setting of the style. This is either a valid
point size or QStyleSheetItem::Undefined.
See also setFontSize(), QFont::pointSize(), and QFont::setPointSize().
bool QStyleSheetItem::fontStrikeOut () const
Returns TRUE if the style sets a strike out font; otherwise
returns FALSE.
See also setFontStrikeOut() and definesFontStrikeOut().
bool QStyleSheetItem::fontUnderline () const
Returns TRUE if the style sets an underlined font; otherwise
returns FALSE.
See also setFontUnderline() and definesFontUnderline().
int QStyleSheetItem::fontWeight () const
Returns the font weight setting of the style. This is either a
valid QFont::Weight or the value QStyleSheetItem::Undefined.
See also setFontWeight() and QFont.
bool QStyleSheetItem::isAnchor () const
Returns whether this style is an anchor.
See also setAnchor().
int QStyleSheetItem::lineSpacing () const
This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code.
Returns the linespacing
ListStyle QStyleSheetItem::listStyle () const
Returns the list style of the style.
See also setListStyle() and ListStyle.
int QStyleSheetItem::logicalFontSize () const
Returns the logical font size setting of the style. This is either
a valid size between 1 and 7 or QStyleSheetItem::Undefined.
See also setLogicalFontSize(), setLogicalFontSizeStep(), QFont::pointSize(), and QFont::setPointSize().
int QStyleSheetItem::logicalFontSizeStep () const
Returns the logical font size step of this style.
The default is 0. Tags such as big define +1; small
defines -1.
See also setLogicalFontSizeStep().
int QStyleSheetItem::margin ( Margin m ) const
Returns the width of margin m in pixels.
The margin, m, can be MarginLeft, MarginRight, MarginTop, MarginBottom, or MarginFirstLine.
See also setMargin() and Margin.
QString QStyleSheetItem::name () const
Returns the name of the style item.
int QStyleSheetItem::numberOfColumns () const
This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code.
Returns the number of columns for this style.
See also setNumberOfColumns(), displayMode(), and setDisplayMode().
Assignment. Assings a copy of other that is not bound to any style sheet.
Unbounds first from previous style sheet.
bool QStyleSheetItem::selfNesting () const
Returns TRUE if this style has self-nesting enabled; otherwise
returns FALSE.
See also setSelfNesting().
void QStyleSheetItem::setAlignment ( int f )
Sets the alignment to f. This only makes sense for styles with
a display mode of
DisplayBlock. Possible values are AlignAuto, AlignLeft,
AlignRight, AlignCenter or AlignJustify.
See also alignment(), displayMode(), and Qt::AlignmentFlags.
void QStyleSheetItem::setAnchor ( bool anc )
If anc is TRUE, sets this style to be an anchor (hypertext
link); otherwise sets it to not be an anchor. Elements in this
style link to other documents or anchors.
See also isAnchor().
void QStyleSheetItem::setColor ( const QColor & c )
Sets the text color of this style to c.
See also color().
void QStyleSheetItem::setContexts ( const QString & c )
Sets a space-separated list of names of styles that may contain
elements of this style. If c is empty, the style can be nested
everywhere.
See also contexts().
void QStyleSheetItem::setDisplayMode ( DisplayMode m )
Sets the display mode of the style to m.
See also displayMode().
void QStyleSheetItem::setFontFamily ( const QString & fam )
Sets the font family setting of the style to fam.
See also fontFamily(), QFont::family(), and QFont::setFamily().
void QStyleSheetItem::setFontItalic ( bool italic )
If italic is TRUE sets italic for the style; otherwise sets
upright.
See also fontItalic() and definesFontItalic().
void QStyleSheetItem::setFontSize ( int s )
Sets the font size setting of the style to s points.
See also fontSize(), QFont::pointSize(), and QFont::setPointSize().
void QStyleSheetItem::setFontStrikeOut ( bool strikeOut )
If strikeOut is TRUE, sets strike out for the style; otherwise
sets no strike out.
See also fontStrikeOut() and definesFontStrikeOut().
void QStyleSheetItem::setFontUnderline ( bool underline )
If underline is TRUE, sets underline for the style; otherwise
sets no underline.
See also fontUnderline() and definesFontUnderline().
void QStyleSheetItem::setFontWeight ( int w )
Sets the font weight setting of the style to w. Valid values
are those defined by QFont::Weight.
See also QFont and fontWeight().
void QStyleSheetItem::setListStyle ( ListStyle s )
Sets the list style of the style to s.
This is used by nested elements that have a display mode of DisplayListItem.
See also listStyle(), DisplayMode, and ListStyle.
void QStyleSheetItem::setLogicalFontSize ( int s )
Sets the logical font size setting of the style to s. Valid
logical sizes are 1 to 7.
See also logicalFontSize(), QFont::pointSize(), and QFont::setPointSize().
void QStyleSheetItem::setLogicalFontSizeStep ( int s )
Sets the logical font size step of this style to s.
See also logicalFontSizeStep().
void QStyleSheetItem::setMargin ( Margin m, int v )
Sets the width of margin m to v pixels.
The margin, m, can be MarginLeft, MarginRight, MarginTop, MarginBottom, MarginFirstLine, MarginAll,
MarginVertical or MarginHorizontal. The value v must
be >= 0.
See also margin().
void QStyleSheetItem::setNumberOfColumns ( int ncols )
This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code.
Sets the number of columns for this style. Elements in the style
are divided into columns.
This makes sense only if the style uses a block display mode
(see QStyleSheetItem::DisplayMode).
See also numberOfColumns().
void QStyleSheetItem::setSelfNesting ( bool nesting )
Sets the self-nesting property for this style to nesting.
In order to support "dirty" HTML, paragraphs <p> and list
items <li> are not self-nesting. This means that starting a
new paragraph or list item automatically closes the previous one.
See also selfNesting().
void QStyleSheetItem::setVerticalAlignment ( VerticalAlignment valign )
Sets the vertical alignment to valign. Possible values are
VAlignBaseline, VAlignSub or VAlignSuper.
The vertical alignment property is not inherited.
See also verticalAlignment().
void QStyleSheetItem::setWhiteSpaceMode ( WhiteSpaceMode m )
Sets the whitespace mode to m.
See also WhiteSpaceMode.
QStyleSheet * QStyleSheetItem::styleSheet ()
Returns the style sheet this item is in.
const QStyleSheet * QStyleSheetItem::styleSheet () const
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
Returns the style sheet this item is in.
VerticalAlignment QStyleSheetItem::verticalAlignment () const
Returns the vertical alignment of the style. Possible values are
VAlignBaseline, VAlignSub or VAlignSuper.
See also setVerticalAlignment().
WhiteSpaceMode QStyleSheetItem::whiteSpaceMode () const
Returns the whitespace mode.
See also setWhiteSpaceMode() and WhiteSpaceMode.
This file is part of the Qt toolkit.
Copyright © 1995-2005
Trolltech. All Rights Reserved.
