1
<?xml version="1.0" encoding="iso-8859-1"?>
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
<!-- /tmp/qt-4.0.0-espenr-1119621036935/qt-x11-opensource-desktop-4.0.0/src/qt3support/text/q3stylesheet.cpp -->
7
<title>Qt 4.0: Q3StyleSheetItem Class Reference</title>
8
<style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
9
a:link { color: #004faf; text-decoration: none }
10
a:visited { color: #672967; text-decoration: none }
11
td.postheader { font-family: sans-serif }
12
tr.address { font-family: sans-serif }
13
body { background: #ffffff; color: black; }</style>
16
<table border="0" cellpadding="0" cellspacing="0" width="100%">
18
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></td>
19
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="annotated.html"><font color="#004faf">Annotated</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
20
<td align="right" valign="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">Q3StyleSheetItem Class Reference</h1>
21
<p>The Q3StyleSheetItem class provides an encapsulation of a set of text styles. <a href="#details">More...</a></p>
22
<pre>#include <Q3StyleSheetItem></pre><p><b>This class is part of the Qt 3 support library.</b> It is provided to keep old source code working. We strongly advise against using it in new code. See the <a href="porting4.html">Porting Guide</a> for more information.</p>
23
<p>Part of the <a href="qt3support.html">Qt3Support</a> module.</p>
25
<li><a href="q3stylesheetitem-members.html">List of all members, including inherited members</a></li>
27
<a name="public-types"></a>
30
<li><div class="fn"/>enum <b><a href="q3stylesheetitem.html#DisplayMode-enum">DisplayMode</a></b> { DisplayBlock, DisplayInline, DisplayListItem, DisplayNone }</li>
31
<li><div class="fn"/>enum <b><a href="q3stylesheetitem.html#ListStyle-enum">ListStyle</a></b> { ListDisc, ListCircle, ListSquare, ListDecimal, ListLowerAlpha, ListUpperAlpha }</li>
32
<li><div class="fn"/>enum <b><a href="q3stylesheetitem.html#Margin-enum">Margin</a></b> { MarginLeft, MarginRight, MarginTop, MarginBottom, ..., MarginUndefined }</li>
33
<li><div class="fn"/>enum <b><a href="q3stylesheetitem.html#VerticalAlignment-enum">VerticalAlignment</a></b> { VAlignBaseline, VAlignSub, VAlignSuper }</li>
34
<li><div class="fn"/>enum <b><a href="q3stylesheetitem.html#WhiteSpaceMode-enum">WhiteSpaceMode</a></b> { WhiteSpaceNormal, WhiteSpacePre, WhiteSpaceNoWrap }</li>
36
<a name="public-functions"></a>
37
<h3>Public Functions</h3>
39
<li><div class="fn"/><b><a href="q3stylesheetitem.html#Q3StyleSheetItem">Q3StyleSheetItem</a></b> ( Q3StyleSheet * <i>parent</i>, const QString & <i>name</i> )</li>
40
<li><div class="fn"/><b><a href="q3stylesheetitem.html#Q3StyleSheetItem-2">Q3StyleSheetItem</a></b> ( const Q3StyleSheetItem & <i>other</i> )</li>
41
<li><div class="fn"/><b><a href="q3stylesheetitem.html#dtor.Q3StyleSheetItem">~Q3StyleSheetItem</a></b> ()</li>
42
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#alignment">alignment</a></b> () const</li>
43
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#allowedInContext">allowedInContext</a></b> ( const Q3StyleSheetItem * <i>s</i> ) const</li>
44
<li><div class="fn"/>QColor <b><a href="q3stylesheetitem.html#color">color</a></b> () const</li>
45
<li><div class="fn"/>QString <b><a href="q3stylesheetitem.html#contexts">contexts</a></b> () const</li>
46
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#definesFontItalic">definesFontItalic</a></b> () const</li>
47
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#definesFontStrikeOut">definesFontStrikeOut</a></b> () const</li>
48
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#definesFontUnderline">definesFontUnderline</a></b> () const</li>
49
<li><div class="fn"/>DisplayMode <b><a href="q3stylesheetitem.html#displayMode">displayMode</a></b> () const</li>
50
<li><div class="fn"/>QString <b><a href="q3stylesheetitem.html#fontFamily">fontFamily</a></b> () const</li>
51
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#fontItalic">fontItalic</a></b> () const</li>
52
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#fontSize">fontSize</a></b> () const</li>
53
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#fontStrikeOut">fontStrikeOut</a></b> () const</li>
54
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#fontUnderline">fontUnderline</a></b> () const</li>
55
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#fontWeight">fontWeight</a></b> () const</li>
56
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#isAnchor">isAnchor</a></b> () const</li>
57
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#lineSpacing">lineSpacing</a></b> () const</li>
58
<li><div class="fn"/>ListStyle <b><a href="q3stylesheetitem.html#listStyle">listStyle</a></b> () const</li>
59
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#logicalFontSize">logicalFontSize</a></b> () const</li>
60
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#logicalFontSizeStep">logicalFontSizeStep</a></b> () const</li>
61
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#margin">margin</a></b> ( Margin <i>m</i> ) const</li>
62
<li><div class="fn"/>QString <b><a href="q3stylesheetitem.html#name">name</a></b> () const</li>
63
<li><div class="fn"/>int <b><a href="q3stylesheetitem.html#numberOfColumns">numberOfColumns</a></b> () const</li>
64
<li><div class="fn"/>bool <b><a href="q3stylesheetitem.html#selfNesting">selfNesting</a></b> () const</li>
65
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setAlignment">setAlignment</a></b> ( int <i>f</i> )</li>
66
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setAnchor">setAnchor</a></b> ( bool <i>anc</i> )</li>
67
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setColor">setColor</a></b> ( const QColor & <i>c</i> )</li>
68
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setContexts">setContexts</a></b> ( const QString & <i>c</i> )</li>
69
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setDisplayMode">setDisplayMode</a></b> ( DisplayMode <i>m</i> )</li>
70
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setFontFamily">setFontFamily</a></b> ( const QString & <i>fam</i> )</li>
71
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setFontItalic">setFontItalic</a></b> ( bool <i>italic</i> )</li>
72
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setFontSize">setFontSize</a></b> ( int <i>s</i> )</li>
73
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setFontStrikeOut">setFontStrikeOut</a></b> ( bool <i>strikeOut</i> )</li>
74
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setFontUnderline">setFontUnderline</a></b> ( bool <i>underline</i> )</li>
75
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setFontWeight">setFontWeight</a></b> ( int <i>w</i> )</li>
76
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setListStyle">setListStyle</a></b> ( ListStyle <i>s</i> )</li>
77
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setLogicalFontSize">setLogicalFontSize</a></b> ( int <i>s</i> )</li>
78
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setLogicalFontSizeStep">setLogicalFontSizeStep</a></b> ( int <i>s</i> )</li>
79
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setMargin">setMargin</a></b> ( Margin <i>m</i>, int <i>v</i> )</li>
80
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setNumberOfColumns">setNumberOfColumns</a></b> ( int <i>ncols</i> )</li>
81
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setSelfNesting">setSelfNesting</a></b> ( bool <i>nesting</i> )</li>
82
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setVerticalAlignment">setVerticalAlignment</a></b> ( VerticalAlignment <i>valign</i> )</li>
83
<li><div class="fn"/>void <b><a href="q3stylesheetitem.html#setWhiteSpaceMode">setWhiteSpaceMode</a></b> ( WhiteSpaceMode <i>m</i> )</li>
84
<li><div class="fn"/>Q3StyleSheet * <b><a href="q3stylesheetitem.html#styleSheet">styleSheet</a></b> ()</li>
85
<li><div class="fn"/>const Q3StyleSheet * <b><a href="q3stylesheetitem.html#styleSheet-2">styleSheet</a></b> () const</li>
86
<li><div class="fn"/>VerticalAlignment <b><a href="q3stylesheetitem.html#verticalAlignment">verticalAlignment</a></b> () const</li>
87
<li><div class="fn"/>WhiteSpaceMode <b><a href="q3stylesheetitem.html#whiteSpaceMode">whiteSpaceMode</a></b> () const</li>
88
<li><div class="fn"/>Q3StyleSheetItem & <b><a href="q3stylesheetitem.html#operator-eq">operator=</a></b> ( const Q3StyleSheetItem & <i>other</i> )</li>
90
<a name="details"></a>
92
<h2>Detailed Description</h2>
93
<p>The Q3StyleSheetItem class provides an encapsulation of a set of text styles.</p>
94
<p>A style sheet item consists of a name and a set of attributes that specify its font, color, etc. When used in a <a href="q3stylesheet.html">style sheet</a> (see <a href="q3stylesheetitem.html#styleSheet">styleSheet</a>()), items define the <a href="q3stylesheetitem.html#name">name</a>() of a rich text tag and the display property changes associated with it.</p>
95
<p>The <a href="q3stylesheetitem.html#DisplayMode-enum">display mode</a> attribute indicates whether the item is a block, an inline element or a list element; see <a href="q3stylesheetitem.html#setDisplayMode">setDisplayMode</a>(). The treatment of whitespace is controlled by the <a href="q3stylesheetitem.html#WhiteSpaceMode-enum">white space mode</a>; see <a href="q3stylesheetitem.html#setWhiteSpaceMode">setWhiteSpaceMode</a>(). An item's margins are set with <a href="q3stylesheetitem.html#setMargin">setMargin</a>(), In the case of list items, the list style is set with <a href="q3stylesheetitem.html#setListStyle">setListStyle</a>(). An item may be a hypertext link anchor; see <a href="q3stylesheetitem.html#setAnchor">setAnchor</a>(). Other attributes are set with <a href="q3stylesheetitem.html#setAlignment">setAlignment</a>(), <a href="q3stylesheetitem.html#setVerticalAlignment">setVerticalAlignment</a>(), <a href="q3stylesheetitem.html#setFontFamily">setFontFamily</a>(), <a href="q3stylesheetitem.html#setFontSize">setFontSize</a>(), <a href="q3stylesheetitem.html#setFontWeight">setFontWeight</a>(), <a href="q3stylesheetitem.html#setFontItalic">setFontItalic</a>(), <a href="q3stylesheetitem.html#setFontUnderline">setFontUnderline</a>(), setFontStrikeOut and <a href="q3stylesheetitem.html#setColor">setColor</a>().</p>
97
<h2>Member Type Documentation</h2>
98
<h3 class="fn"><a name="DisplayMode-enum"></a>enum Q3StyleSheetItem::DisplayMode</h3>
99
<p>This enum type defines the way adjacent elements are displayed.</p>
100
<table border="1" cellpadding="2" cellspacing="1" width="100%">
101
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
102
<tr><td valign="top"><tt>Q3StyleSheetItem::DisplayBlock</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">elements are displayed as a rectangular block (e.g. <tt><p>...</p></tt>).</td></tr>
103
<tr><td valign="top"><tt>Q3StyleSheetItem::DisplayInline</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">elements are displayed in a horizontally flowing sequence (e.g. <tt><em>...</em></tt>).</td></tr>
104
<tr><td valign="top"><tt>Q3StyleSheetItem::DisplayListItem</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">elements are displayed in a vertical sequence (e.g. <tt><li>...</li></tt>).</td></tr>
105
<tr><td valign="top"><tt>Q3StyleSheetItem::DisplayNone</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">elements are not displayed at all.</td></tr>
107
<h3 class="fn"><a name="ListStyle-enum"></a>enum Q3StyleSheetItem::ListStyle</h3>
108
<p>This enum type defines how the items in a list are prefixed when displayed.</p>
109
<table border="1" cellpadding="2" cellspacing="1" width="100%">
110
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
111
<tr><td valign="top"><tt>Q3StyleSheetItem::ListDisc</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">a filled circle (i.e. a bullet)</td></tr>
112
<tr><td valign="top"><tt>Q3StyleSheetItem::ListCircle</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">an unfilled circle</td></tr>
113
<tr><td valign="top"><tt>Q3StyleSheetItem::ListSquare</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">a filled square</td></tr>
114
<tr><td valign="top"><tt>Q3StyleSheetItem::ListDecimal</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">an integer in base 10: <i>1</i>, <i>2</i>, <i>3</i>, ...</td></tr>
115
<tr><td valign="top"><tt>Q3StyleSheetItem::ListLowerAlpha</tt></td><td align="center" valign="top"><tt>4</tt></td><td valign="top">a lowercase letter: <i>a</i>, <i>b</i>, <i>c</i>, ...</td></tr>
116
<tr><td valign="top"><tt>Q3StyleSheetItem::ListUpperAlpha</tt></td><td align="center" valign="top"><tt>5</tt></td><td valign="top">an uppercase letter: <i>A</i>, <i>B</i>, <i>C</i>, ...</td></tr>
118
<h3 class="fn"><a name="Margin-enum"></a>enum Q3StyleSheetItem::Margin</h3>
119
<table border="1" cellpadding="2" cellspacing="1" width="100%">
120
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
121
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginLeft</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">left margin</td></tr>
122
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginRight</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">right margin</td></tr>
123
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginTop</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">top margin</td></tr>
124
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginBottom</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">bottom margin</td></tr>
125
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginAll</tt></td><td align="center" valign="top"><tt>5</tt></td><td valign="top">all margins (left, right, top and bottom)</td></tr>
126
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginVertical</tt></td><td align="center" valign="top"><tt>6</tt></td><td valign="top">top and bottom margins</td></tr>
127
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginHorizontal</tt></td><td align="center" valign="top"><tt>7</tt></td><td valign="top">left and right margins</td></tr>
128
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginFirstLine</tt></td><td align="center" valign="top"><tt>4</tt></td><td valign="top">margin (indentation) of the first line of a paragarph (in addition to the MarginLeft of the paragraph)</td></tr>
129
<tr><td valign="top"><tt>Q3StyleSheetItem::MarginUndefined</tt></td><td align="center" valign="top"><tt>-1</tt></td><td valign="top"> </td></tr>
131
<h3 class="fn"><a name="VerticalAlignment-enum"></a>enum Q3StyleSheetItem::VerticalAlignment</h3>
132
<p>This enum type defines the way elements are aligned vertically. This is only supported for text elements.</p>
133
<table border="1" cellpadding="2" cellspacing="1" width="100%">
134
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
135
<tr><td valign="top"><tt>Q3StyleSheetItem::VAlignBaseline</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">align the baseline of the element (or the bottom, if the element doesn't have a baseline) with the baseline of the parent</td></tr>
136
<tr><td valign="top"><tt>Q3StyleSheetItem::VAlignSub</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">subscript the element</td></tr>
137
<tr><td valign="top"><tt>Q3StyleSheetItem::VAlignSuper</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">superscript the element</td></tr>
139
<h3 class="fn"><a name="WhiteSpaceMode-enum"></a>enum Q3StyleSheetItem::WhiteSpaceMode</h3>
140
<p>This enum defines the ways in which <a href="q3stylesheet.html">Q3StyleSheet</a> can treat whitespace.</p>
141
<table border="1" cellpadding="2" cellspacing="1" width="100%">
142
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
143
<tr><td valign="top"><tt>Q3StyleSheetItem::WhiteSpaceNormal</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">any sequence of whitespace (including line-breaks) is equivalent to a single space.</td></tr>
144
<tr><td valign="top"><tt>Q3StyleSheetItem::WhiteSpacePre</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">whitespace must be output exactly as given in the input.</td></tr>
145
<tr><td valign="top"><tt>Q3StyleSheetItem::WhiteSpaceNoWrap</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">multiple spaces are collapsed as with WhiteSpaceNormal, but no automatic line-breaks occur. To break lines manually, use the <tt><br></tt> tag.</td></tr>
148
<h2>Member Function Documentation</h2>
149
<h3 class="fn"><a name="Q3StyleSheetItem"></a>Q3StyleSheetItem::Q3StyleSheetItem ( <a href="q3stylesheet.html">Q3StyleSheet</a> * <i>parent</i>, const <a href="qstring.html">QString</a> & <i>name</i> )</h3>
150
<p>Constructs a new style called <i>name</i> for the stylesheet <i>parent</i>.</p>
151
<p>All properties in <a href="q3stylesheetitem.html">Q3StyleSheetItem</a> are initially in the "do not change" state, except <a href="q3stylesheetitem.html#DisplayMode-enum">display mode</a>, which defaults to <tt>DisplayInline</tt>.</p>
152
<h3 class="fn"><a name="Q3StyleSheetItem-2"></a>Q3StyleSheetItem::Q3StyleSheetItem ( const Q3StyleSheetItem & <i>other</i> )</h3>
153
<p>Copy constructor. Constructs a copy of <i>other</i> that is not bound to any style sheet.</p>
154
<h3 class="fn"><a name="dtor.Q3StyleSheetItem"></a>Q3StyleSheetItem::~Q3StyleSheetItem ()</h3>
155
<p>Destroys the style. Note that <a href="q3stylesheetitem.html">Q3StyleSheetItem</a> objects become owned by <a href="q3stylesheet.html">Q3StyleSheet</a> when they are created.</p>
156
<h3 class="fn"><a name="alignment"></a>int Q3StyleSheetItem::alignment () const</h3>
157
<p>Returns the alignment of this style. Possible values are <tt>Qt::AlignAuto</tt>, <tt>Qt::AlignLeft</tt>, <tt>Qt::AlignRight</tt>, <tt>Qt::AlignCenter</tt> or <tt>Qt::AlignJustify</tt>.</p>
158
<p>See also <a href="q3stylesheetitem.html#setAlignment">setAlignment</a>() and <a href="qt.html#AlignmentFlag-enum">Qt::Alignment</a>.</p>
159
<h3 class="fn"><a name="allowedInContext"></a>bool Q3StyleSheetItem::allowedInContext ( const Q3StyleSheetItem * <i>s</i> ) const</h3>
160
<p>Returns true if this style can be nested into an element of style <i>s</i>; otherwise returns false.</p>
161
<p>See also <a href="q3stylesheetitem.html#contexts">contexts</a>() and <a href="q3stylesheetitem.html#setContexts">setContexts</a>().</p>
162
<h3 class="fn"><a name="color"></a><a href="qcolor.html">QColor</a> Q3StyleSheetItem::color () const</h3>
163
<p>Returns the text color of this style or an invalid color if no color has been set.</p>
164
<p>See also <a href="q3stylesheetitem.html#setColor">setColor</a>() and <a href="qcolor.html#isValid">QColor::isValid</a>().</p>
165
<h3 class="fn"><a name="contexts"></a><a href="qstring.html">QString</a> Q3StyleSheetItem::contexts () const</h3>
166
<p>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.</p>
167
<p>See also <a href="q3stylesheetitem.html#setContexts">setContexts</a>().</p>
168
<h3 class="fn"><a name="definesFontItalic"></a>bool Q3StyleSheetItem::definesFontItalic () const</h3>
169
<p>Returns true if the style defines a font shape; otherwise returns false. A style does not define any shape until <a href="q3stylesheetitem.html#setFontItalic">setFontItalic</a>() is called.</p>
170
<p>See also <a href="q3stylesheetitem.html#setFontItalic">setFontItalic</a>() and <a href="q3stylesheetitem.html#fontItalic">fontItalic</a>().</p>
171
<h3 class="fn"><a name="definesFontStrikeOut"></a>bool Q3StyleSheetItem::definesFontStrikeOut () const</h3>
172
<p>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 <a href="q3stylesheetitem.html#setFontStrikeOut">setFontStrikeOut</a>() is called.</p>
173
<p>See also <a href="q3stylesheetitem.html#setFontStrikeOut">setFontStrikeOut</a>() and <a href="q3stylesheetitem.html#fontStrikeOut">fontStrikeOut</a>().</p>
174
<h3 class="fn"><a name="definesFontUnderline"></a>bool Q3StyleSheetItem::definesFontUnderline () const</h3>
175
<p>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 <a href="q3stylesheetitem.html#setFontUnderline">setFontUnderline</a>() is called.</p>
176
<p>See also <a href="q3stylesheetitem.html#setFontUnderline">setFontUnderline</a>() and <a href="q3stylesheetitem.html#fontUnderline">fontUnderline</a>().</p>
177
<h3 class="fn"><a name="displayMode"></a><a href="q3stylesheetitem.html#DisplayMode-enum">DisplayMode</a> Q3StyleSheetItem::displayMode () const</h3>
178
<p>Returns the <a href="q3stylesheetitem.html#DisplayMode-enum">display mode</a> of the style.</p>
179
<p>See also <a href="q3stylesheetitem.html#setDisplayMode">setDisplayMode</a>().</p>
180
<h3 class="fn"><a name="fontFamily"></a><a href="qstring.html">QString</a> Q3StyleSheetItem::fontFamily () const</h3>
181
<p>Returns the style's font family setting. This is either a valid font family or an empty string if no family has been set.</p>
182
<p>See also <a href="q3stylesheetitem.html#setFontFamily">setFontFamily</a>(), <a href="qfont.html#family">QFont::family</a>(), and <a href="qfont.html#setFamily">QFont::setFamily</a>().</p>
183
<h3 class="fn"><a name="fontItalic"></a>bool Q3StyleSheetItem::fontItalic () const</h3>
184
<p>Returns true if the style sets an italic font; otherwise returns false.</p>
185
<p>See also <a href="q3stylesheetitem.html#setFontItalic">setFontItalic</a>() and <a href="q3stylesheetitem.html#definesFontItalic">definesFontItalic</a>().</p>
186
<h3 class="fn"><a name="fontSize"></a>int Q3StyleSheetItem::fontSize () const</h3>
187
<p>Returns the font size setting of the style. This is either a valid point size or <tt>Q3StyleSheetItem::Undefined</tt>.</p>
188
<p>See also <a href="q3stylesheetitem.html#setFontSize">setFontSize</a>(), <a href="qfont.html#pointSize">QFont::pointSize</a>(), and <a href="qfont.html#setPointSize">QFont::setPointSize</a>().</p>
189
<h3 class="fn"><a name="fontStrikeOut"></a>bool Q3StyleSheetItem::fontStrikeOut () const</h3>
190
<p>Returns true if the style sets a strike out font; otherwise returns false.</p>
191
<p>See also <a href="q3stylesheetitem.html#setFontStrikeOut">setFontStrikeOut</a>() and <a href="q3stylesheetitem.html#definesFontStrikeOut">definesFontStrikeOut</a>().</p>
192
<h3 class="fn"><a name="fontUnderline"></a>bool Q3StyleSheetItem::fontUnderline () const</h3>
193
<p>Returns true if the style sets an underlined font; otherwise returns false.</p>
194
<p>See also <a href="q3stylesheetitem.html#setFontUnderline">setFontUnderline</a>() and <a href="q3stylesheetitem.html#definesFontUnderline">definesFontUnderline</a>().</p>
195
<h3 class="fn"><a name="fontWeight"></a>int Q3StyleSheetItem::fontWeight () const</h3>
196
<p>Returns the font weight setting of the style. This is either a valid <tt>QFont::Weight</tt> or the value <tt>Q3StyleSheetItem::Undefined</tt>.</p>
197
<p>See also <a href="q3stylesheetitem.html#setFontWeight">setFontWeight</a>() and <a href="qfont.html">QFont</a>.</p>
198
<h3 class="fn"><a name="isAnchor"></a>bool Q3StyleSheetItem::isAnchor () const</h3>
199
<p>Returns whether this style is an anchor.</p>
200
<p>See also <a href="q3stylesheetitem.html#setAnchor">setAnchor</a>().</p>
201
<h3 class="fn"><a name="lineSpacing"></a>int Q3StyleSheetItem::lineSpacing () const</h3>
202
<p>Returns the line spacing.</p>
203
<h3 class="fn"><a name="listStyle"></a><a href="q3stylesheetitem.html#ListStyle-enum">ListStyle</a> Q3StyleSheetItem::listStyle () const</h3>
204
<p>Returns the list style of the style.</p>
205
<p>See also <a href="q3stylesheetitem.html#setListStyle">setListStyle</a>() and <a href="q3stylesheetitem.html#ListStyle-enum">ListStyle</a>.</p>
206
<h3 class="fn"><a name="logicalFontSize"></a>int Q3StyleSheetItem::logicalFontSize () const</h3>
207
<p>Returns the logical font size setting of the style. This is either a valid size between 1 and 7 or <tt>Q3StyleSheetItem::Undefined</tt>.</p>
208
<p>See also <a href="q3stylesheetitem.html#setLogicalFontSize">setLogicalFontSize</a>(), <a href="q3stylesheetitem.html#setLogicalFontSizeStep">setLogicalFontSizeStep</a>(), <a href="qfont.html#pointSize">QFont::pointSize</a>(), and <a href="qfont.html#setPointSize">QFont::setPointSize</a>().</p>
209
<h3 class="fn"><a name="logicalFontSizeStep"></a>int Q3StyleSheetItem::logicalFontSizeStep () const</h3>
210
<p>Returns the logical font size step of this style.</p>
211
<p>The default is 0. Tags such as <tt>big</tt> define <tt>+1</tt>; <tt>small</tt> defines <tt>-1</tt>.</p>
212
<p>See also <a href="q3stylesheetitem.html#setLogicalFontSizeStep">setLogicalFontSizeStep</a>().</p>
213
<h3 class="fn"><a name="margin"></a>int Q3StyleSheetItem::margin ( <a href="q3stylesheetitem.html#Margin-enum">Margin</a> <i>m</i> ) const</h3>
214
<p>Returns the width of margin <i>m</i> in pixels.</p>
215
<p>The margin, <i>m</i>, can be <tt>MarginLeft</tt>, <tt>MarginRight</tt>, <tt>MarginTop</tt>, <tt>MarginBottom</tt>, <tt>MarginAll</tt>, <tt>MarginVertical</tt> or <tt>MarginHorizontal</tt>.</p>
216
<p>See also <a href="q3stylesheetitem.html#setMargin">setMargin</a>() and <a href="q3stylesheetitem.html#Margin-enum">Margin</a>.</p>
217
<h3 class="fn"><a name="name"></a><a href="qstring.html">QString</a> Q3StyleSheetItem::name () const</h3>
218
<p>Returns the name of the style item.</p>
219
<h3 class="fn"><a name="numberOfColumns"></a>int Q3StyleSheetItem::numberOfColumns () const</h3>
220
<p>Returns the number of columns for this style.</p>
221
<p>See also <a href="q3stylesheetitem.html#setNumberOfColumns">setNumberOfColumns</a>(), <a href="q3stylesheetitem.html#displayMode">displayMode</a>(), and <a href="q3stylesheetitem.html#setDisplayMode">setDisplayMode</a>().</p>
222
<h3 class="fn"><a name="selfNesting"></a>bool Q3StyleSheetItem::selfNesting () const</h3>
223
<p>Returns true if this style has self-nesting enabled; otherwise returns false.</p>
224
<p>See also <a href="q3stylesheetitem.html#setSelfNesting">setSelfNesting</a>().</p>
225
<h3 class="fn"><a name="setAlignment"></a>void Q3StyleSheetItem::setAlignment ( int <i>f</i> )</h3>
226
<p>Sets the alignment to <i>f</i>. This only makes sense for styles with a <a href="q3stylesheetitem.html#DisplayMode-enum">display mode</a> of <a href="q3stylesheetitem.html#DisplayMode-enum">DisplayBlock</a>. Possible values are <tt>Qt::AlignAuto</tt>, <tt>Qt::AlignLeft</tt>, <tt>Qt::AlignRight</tt>, <tt>Qt::AlignCenter</tt> or <tt>Qt::AlignJustify</tt>.</p>
227
<p>See also <a href="q3stylesheetitem.html#alignment">alignment</a>(), <a href="q3stylesheetitem.html#displayMode">displayMode</a>(), and <a href="qt.html#AlignmentFlag-enum">Qt::Alignment</a>.</p>
228
<h3 class="fn"><a name="setAnchor"></a>void Q3StyleSheetItem::setAnchor ( bool <i>anc</i> )</h3>
229
<p>If <i>anc</i> 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.</p>
230
<p>See also <a href="q3stylesheetitem.html#isAnchor">isAnchor</a>().</p>
231
<h3 class="fn"><a name="setColor"></a>void Q3StyleSheetItem::setColor ( const <a href="qcolor.html">QColor</a> & <i>c</i> )</h3>
232
<p>Sets the text color of this style to <i>c</i>.</p>
233
<p>See also <a href="q3stylesheetitem.html#color">color</a>().</p>
234
<h3 class="fn"><a name="setContexts"></a>void Q3StyleSheetItem::setContexts ( const <a href="qstring.html">QString</a> & <i>c</i> )</h3>
235
<p>Sets a space-separated list of names of styles that may contain elements of this style. If <i>c</i> is empty, the style can be nested everywhere.</p>
236
<p>See also <a href="q3stylesheetitem.html#contexts">contexts</a>().</p>
237
<h3 class="fn"><a name="setDisplayMode"></a>void Q3StyleSheetItem::setDisplayMode ( <a href="q3stylesheetitem.html#DisplayMode-enum">DisplayMode</a> <i>m</i> )</h3>
238
<p>Sets the display mode of the style to <i>m</i>.</p>
239
<p>See also <a href="q3stylesheetitem.html#displayMode">displayMode</a>().</p>
240
<h3 class="fn"><a name="setFontFamily"></a>void Q3StyleSheetItem::setFontFamily ( const <a href="qstring.html">QString</a> & <i>fam</i> )</h3>
241
<p>Sets the font family setting of the style to <i>fam</i>.</p>
242
<p>See also <a href="q3stylesheetitem.html#fontFamily">fontFamily</a>(), <a href="qfont.html#family">QFont::family</a>(), and <a href="qfont.html#setFamily">QFont::setFamily</a>().</p>
243
<h3 class="fn"><a name="setFontItalic"></a>void Q3StyleSheetItem::setFontItalic ( bool <i>italic</i> )</h3>
244
<p>If <i>italic</i> is true sets italic for the style; otherwise sets upright.</p>
245
<p>See also <a href="q3stylesheetitem.html#fontItalic">fontItalic</a>() and <a href="q3stylesheetitem.html#definesFontItalic">definesFontItalic</a>().</p>
246
<h3 class="fn"><a name="setFontSize"></a>void Q3StyleSheetItem::setFontSize ( int <i>s</i> )</h3>
247
<p>Sets the font size setting of the style to <i>s</i> points.</p>
248
<p>See also <a href="q3stylesheetitem.html#fontSize">fontSize</a>(), <a href="qfont.html#pointSize">QFont::pointSize</a>(), and <a href="qfont.html#setPointSize">QFont::setPointSize</a>().</p>
249
<h3 class="fn"><a name="setFontStrikeOut"></a>void Q3StyleSheetItem::setFontStrikeOut ( bool <i>strikeOut</i> )</h3>
250
<p>If <i>strikeOut</i> is true, sets strike out for the style; otherwise sets no strike out.</p>
251
<p>See also <a href="q3stylesheetitem.html#fontStrikeOut">fontStrikeOut</a>() and <a href="q3stylesheetitem.html#definesFontStrikeOut">definesFontStrikeOut</a>().</p>
252
<h3 class="fn"><a name="setFontUnderline"></a>void Q3StyleSheetItem::setFontUnderline ( bool <i>underline</i> )</h3>
253
<p>If <i>underline</i> is true, sets underline for the style; otherwise sets no underline.</p>
254
<p>See also <a href="q3stylesheetitem.html#fontUnderline">fontUnderline</a>() and <a href="q3stylesheetitem.html#definesFontUnderline">definesFontUnderline</a>().</p>
255
<h3 class="fn"><a name="setFontWeight"></a>void Q3StyleSheetItem::setFontWeight ( int <i>w</i> )</h3>
256
<p>Sets the font weight setting of the style to <i>w</i>. Valid values are those defined by <tt>QFont::Weight</tt>.</p>
257
<p>See also <a href="qfont.html">QFont</a> and <a href="q3stylesheetitem.html#fontWeight">fontWeight</a>().</p>
258
<h3 class="fn"><a name="setListStyle"></a>void Q3StyleSheetItem::setListStyle ( <a href="q3stylesheetitem.html#ListStyle-enum">ListStyle</a> <i>s</i> )</h3>
259
<p>Sets the list style of the style to <i>s</i>.</p>
260
<p>This is used by nested elements that have a display mode of <tt>DisplayListItem</tt>.</p>
261
<p>See also <a href="q3stylesheetitem.html#listStyle">listStyle</a>(), <a href="q3stylesheetitem.html#DisplayMode-enum">DisplayMode</a>, and <a href="q3stylesheetitem.html#ListStyle-enum">ListStyle</a>.</p>
262
<h3 class="fn"><a name="setLogicalFontSize"></a>void Q3StyleSheetItem::setLogicalFontSize ( int <i>s</i> )</h3>
263
<p>Sets the logical font size setting of the style to <i>s</i>. Valid logical sizes are 1 to 7.</p>
264
<p>See also <a href="q3stylesheetitem.html#logicalFontSize">logicalFontSize</a>(), <a href="qfont.html#pointSize">QFont::pointSize</a>(), and <a href="qfont.html#setPointSize">QFont::setPointSize</a>().</p>
265
<h3 class="fn"><a name="setLogicalFontSizeStep"></a>void Q3StyleSheetItem::setLogicalFontSizeStep ( int <i>s</i> )</h3>
266
<p>Sets the logical font size step of this style to <i>s</i>.</p>
267
<p>See also <a href="q3stylesheetitem.html#logicalFontSizeStep">logicalFontSizeStep</a>().</p>
268
<h3 class="fn"><a name="setMargin"></a>void Q3StyleSheetItem::setMargin ( <a href="q3stylesheetitem.html#Margin-enum">Margin</a> <i>m</i>, int <i>v</i> )</h3>
269
<p>Sets the width of margin <i>m</i> to <i>v</i> pixels.</p>
270
<p>The margin, <i>m</i>, can be <tt>MarginLeft</tt>, <tt>MarginRight</tt>, <tt>MarginTop</tt>, <tt>MarginBottom</tt>, <tt>MarginAll</tt>, <tt>MarginVertical</tt> or <tt>MarginHorizontal</tt>. The value <i>v</i> must be >= 0.</p>
271
<p>See also <a href="q3stylesheetitem.html#margin">margin</a>().</p>
272
<h3 class="fn"><a name="setNumberOfColumns"></a>void Q3StyleSheetItem::setNumberOfColumns ( int <i>ncols</i> )</h3>
273
<p>Sets the number of columns for this style to <i>ncols</i>. Elements in the style are divided into columns.</p>
274
<p>This makes sense only if the style uses a block display mode (see <a href="q3stylesheetitem.html#DisplayMode-enum">Q3StyleSheetItem::DisplayMode</a>).</p>
275
<p>See also <a href="q3stylesheetitem.html#numberOfColumns">numberOfColumns</a>().</p>
276
<h3 class="fn"><a name="setSelfNesting"></a>void Q3StyleSheetItem::setSelfNesting ( bool <i>nesting</i> )</h3>
277
<p>Sets the self-nesting property for this style to <i>nesting</i>.</p>
278
<p>In order to support "dirty" HTML, paragraphs <tt><p></tt> and list items <tt><li></tt> are not self-nesting. This means that starting a new paragraph or list item automatically closes the previous one.</p>
279
<p>See also <a href="q3stylesheetitem.html#selfNesting">selfNesting</a>().</p>
280
<h3 class="fn"><a name="setVerticalAlignment"></a>void Q3StyleSheetItem::setVerticalAlignment ( <a href="q3stylesheetitem.html#VerticalAlignment-enum">VerticalAlignment</a> <i>valign</i> )</h3>
281
<p>Sets the vertical alignment to <i>valign</i>. Possible values are <tt>VAlignBaseline</tt>, <tt>VAlignSub</tt> or <tt>VAlignSuper</tt>.</p>
282
<p>The vertical alignment property is not inherited.</p>
283
<p>See also <a href="q3stylesheetitem.html#verticalAlignment">verticalAlignment</a>().</p>
284
<h3 class="fn"><a name="setWhiteSpaceMode"></a>void Q3StyleSheetItem::setWhiteSpaceMode ( <a href="q3stylesheetitem.html#WhiteSpaceMode-enum">WhiteSpaceMode</a> <i>m</i> )</h3>
285
<p>Sets the whitespace mode to <i>m</i>.</p>
286
<p>See also <a href="q3stylesheetitem.html#WhiteSpaceMode-enum">WhiteSpaceMode</a>.</p>
287
<h3 class="fn"><a name="styleSheet"></a><a href="q3stylesheet.html">Q3StyleSheet</a> * Q3StyleSheetItem::styleSheet ()</h3>
288
<p>Returns the style sheet this item is in.</p>
289
<h3 class="fn"><a name="styleSheet-2"></a>const <a href="q3stylesheet.html">Q3StyleSheet</a> * Q3StyleSheetItem::styleSheet () const</h3>
290
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
291
<p>Returns the style sheet this item is in.</p>
292
<h3 class="fn"><a name="verticalAlignment"></a><a href="q3stylesheetitem.html#VerticalAlignment-enum">VerticalAlignment</a> Q3StyleSheetItem::verticalAlignment () const</h3>
293
<p>Returns the vertical alignment of the style. Possible values are <tt>VAlignBaseline</tt>, <tt>VAlignSub</tt> or <tt>VAlignSuper</tt>.</p>
294
<p>See also <a href="q3stylesheetitem.html#setVerticalAlignment">setVerticalAlignment</a>().</p>
295
<h3 class="fn"><a name="whiteSpaceMode"></a><a href="q3stylesheetitem.html#WhiteSpaceMode-enum">WhiteSpaceMode</a> Q3StyleSheetItem::whiteSpaceMode () const</h3>
296
<p>Returns the whitespace mode.</p>
297
<p>See also <a href="q3stylesheetitem.html#setWhiteSpaceMode">setWhiteSpaceMode</a>() and <a href="q3stylesheetitem.html#WhiteSpaceMode-enum">WhiteSpaceMode</a>.</p>
298
<h3 class="fn"><a name="operator-eq"></a>Q3StyleSheetItem & Q3StyleSheetItem::operator= ( const Q3StyleSheetItem & <i>other</i> )</h3>
299
<p>Assignment. Assings a copy of <i>other</i> that is not bound to any style sheet. Unbounds first from previous style sheet.</p>
300
<p /><address><hr /><div align="center">
301
<table width="100%" cellspacing="0" border="0"><tr class="address">
302
<td width="30%">Copyright © 2005 <a href="trolltech.html">Trolltech</a></td>
303
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
304
<td width="30%" align="right"><div align="right">Qt 4.0.0</div></td>
305
</tr></table></div></address></body>
added
removed
doc/html/q3stylesheetitem.html
