qstylesheetitem.3qt

tmark1.11:用于生成QT/EMBEDDED应用工程的Markfile文件

.TH QStyleSheetItem 3qt "6 July 1999" "Troll Tech AS" \" -*- nroff -*-
.\" Copyright 1992-1999 Troll Tech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QStyleSheetItem \- Encapsulates a text format
.SH SYNOPSIS
.br
.PP
\fC#include <qstylesheet.h>\fR
.PP
Inherits Qt.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQStyleSheetItem\fR ( QStyleSheet * " "parent" ", const QString & name )"
.br
.ti -1c
.BI "\fB~QStyleSheetItem\fR ()"
.br
.ti -1c
.BI "QString \fBname\fR () const"
.br
.ti -1c
.BI "QStyleSheet* \fBstyleSheet\fR ()"
.br
.ti -1c
.BI "const QStyleSheet* \fBstyleSheet\fR () const"
.br
.ti -1c
.BI "enum \fBAdditionalStyleValues\fR { Undefined = - 1}"
.br
.ti -1c
.BI "enum \fBDisplayMode\fR {DisplayBlock, DisplayInline, DisplayListItem, DisplayNone}"
.br
.ti -1c
.BI "DisplayMode \fBdisplayMode\fR () const"
.br
.ti -1c
.BI "void \fBsetDisplayMode\fR ( DisplayMode m )"
.br
.ti -1c
.BI "int \fBalignment\fR () const"
.br
.ti -1c
.BI "void \fBsetAlignment\fR ( int f )"
.br
.ti -1c
.BI "int \fBfontWeight\fR () const"
.br
.ti -1c
.BI "void \fBsetFontWeight\fR ( int w )"
.br
.ti -1c
.BI "int \fBlogicalFontSize\fR () const"
.br
.ti -1c
.BI "void \fBsetLogicalFontSize\fR ( int s )"
.br
.ti -1c
.BI "int \fBlogicalFontSizeStep\fR () const"
.br
.ti -1c
.BI "void \fBsetLogicalFontSizeStep\fR ( int s )"
.br
.ti -1c
.BI "int \fBfontSize\fR () const"
.br
.ti -1c
.BI "void \fBsetFontSize\fR ( int s )"
.br
.ti -1c
.BI "QString \fBfontFamily\fR () const"
.br
.ti -1c
.BI "void \fBsetFontFamily\fR ( const QString & )"
.br
.ti -1c
.BI "int \fBnumberOfColumns\fR () const"
.br
.ti -1c
.BI "void \fBsetNumberOfColumns\fR ( int ncols )"
.br
.ti -1c
.BI "QColor \fBcolor\fR () const"
.br
.ti -1c
.BI "void \fBsetColor\fR ( const QColor & )"
.br
.ti -1c
.BI "bool \fBfontItalic\fR () const"
.br
.ti -1c
.BI "void \fBsetFontItalic\fR ( bool )"
.br
.ti -1c
.BI "bool \fBdefinesFontItalic\fR () const"
.br
.ti -1c
.BI "bool \fBfontUnderline\fR () const"
.br
.ti -1c
.BI "void \fBsetFontUnderline\fR ( bool )"
.br
.ti -1c
.BI "bool \fBdefinesFontUnderline\fR () const"
.br
.ti -1c
.BI "bool \fBisAnchor\fR () const"
.br
.ti -1c
.BI "void \fBsetAnchor\fR ( bool anc )"
.br
.ti -1c
.BI "enum \fBWhiteSpaceMode\fR {WhiteSpaceNormal, WhiteSpacePre }"
.br
.ti -1c
.BI "WhiteSpaceMode \fBwhiteSpaceMode\fR () const"
.br
.ti -1c
.BI "void \fBsetWhiteSpaceMode\fR ( WhiteSpaceMode m )"
.br
.ti -1c
.BI "enum \fBMargin\fR { MarginLeft, MarginRight, MarginTop, MarginBottom, MarginAll, MarginVertical, MarginHorizontal }"
.br
.ti -1c
.BI "int \fBmargin\fR ( Margin m ) const"
.br
.ti -1c
.BI "void \fBsetMargin\fR ( Margin, int )"
.br
.ti -1c
.BI "enum \fBListStyle\fR { ListDisc, ListCircle, ListSquare, ListDecimal, ListLowerAlpha, ListUpperAlpha }"
.br
.ti -1c
.BI "ListStyle \fBlistStyle\fR () const"
.br
.ti -1c
.BI "void \fBsetListStyle\fR ( ListStyle )"
.br
.ti -1c
.BI "QString \fBcontexts\fR () const"
.br
.ti -1c
.BI "void \fBsetContexts\fR ( const QString & )"
.br
.ti -1c
.BI "bool \fBallowedInContext\fR ( const QStyleSheetItem * ) const"
.br
.ti -1c
.BI "bool \fBselfNesting\fR () const"
.br
.ti -1c
.BI "void \fBsetSelfNesting\fR ( bool )"
.br
.in -1c
.SH DESCRIPTION
The QStyleSheetItem class encapsulates a text format.
.PP
A style consists of a name and a set of font, color, and other display properties. When used in a style sheet, items define the name of a rich text tag, and the display property changes associated with it.
.PP
Examples:
.(l
qbrowser/main.cpp
.)l
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QStyleSheetItem::QStyleSheetItem ( QStyleSheet * parent, const QString & name )"
Constructs a new style named \fIname\fR for the stylesheet \fIparent.\fR
.PP
All properties in QStyleSheetItem are initially in the "do not change" state, except , which defaults to \fCDisplayInline.\fR
.SH "QStyleSheetItem::~QStyleSheetItem ()"
Destroys the style. Note that QStyleSheetItem objects become owned by QStyleSheet when they are created.
.SH "int QStyleSheetItem::alignment () const"
Returns the alignment of this style. Possible values are AlignLeft, AlignRight and AlignCenter.
.PP
See also: setAlignment().
.SH "bool QStyleSheetItem::allowedInContext ( const QStyleSheetItem * s ) const"
Returns whether this style can be nested into an element of style \fIs\fR .
.PP
See also: contxts() and setContexts().
.SH "QColor QStyleSheetItem::color () const"
Returns the text color of this style, or an invalid color if no color has been set yet.
.PP
See also: setColor().
.SH "QString QStyleSheetItem::contexts () const"
Returns a space separated list of names of styles that may contain elements of this style. As default, contexs() returns an empty string, which indicates that this style can be nested everywhere.
.PP
See also: setContexts().
.SH "bool QStyleSheetItem::definesFontItalic () const"
Returns whether the style defines a font shape. A style does not define any shape until setFontItalic() is called.
.PP
See also: setFontItalic() and fontItalic().
.SH "bool QStyleSheetItem::definesFontUnderline () const"
Returns whether the style defines a setting for the underline property of the font. A style does not define this until setFontUnderline() is called.
.PP
See also: setFontUnderline() and fontUnderline().
.SH "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.
.PP
See also: setFontFamily(), QFont::family() and QFont::setFamily().
.SH "bool QStyleSheetItem::fontItalic () const"
Returns whether the styles sets an italic or upright font.
.PP
See also: setFontItalic() and definesFontItalic().
.SH "int QStyleSheetItem::fontSize () const"
Returns the font size setting of the style. This is either a valid pointsize or QStyleSheetItem::Undefined.
.PP
See also: setFontSize(), QFont::pointSize() and QFont::setPointSize().
.SH "bool QStyleSheetItem::fontUnderline () const"
Returns whether the styles sets an underlined font.
.PP
See also: setFontUnderline() and definesFontUnderline().
.SH "int QStyleSheetItem::fontWeight () const"
Returns the font weight setting of the style. This is either a valid QFont::Weight or the value QStyleSheetItem::Undefined.
.PP
See also: setFontWeight and QFont.
.SH "bool QStyleSheetItem::isAnchor () const"
Returns whether this style is an anchor.
.PP
See also: setAnchor().
.SH "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.
.PP
See also: setLogicalFontSize(), setLogicalFontSizeStep(), QFont::pointSize() and QFont::setPointSize().
.SH "int QStyleSheetItem::logicalFontSizeStep () const"
Returns the logical font size step of this style.
.PP
The default is 0. Tags like \fCbig\fR define \fC+1, small\fR defines \fC-1\fR
.PP
See also: setLogicalFontSizeStep().
.SH "int QStyleSheetItem::margin ( Margin m ) const"
Returns the width of margin \fIm\fR in pixel.
.PP
The margin determinator \fIm\fR can be \fCMarginLeft, MarginRight, MarginTop, MarginBottom, MarginAll, MarginVertical\fR or \fCMarginHorizontal.\fR
.PP
See also: setMargin().
.SH "QString QStyleSheetItem::name () const"
Returns the name of style.
.SH "int QStyleSheetItem::numberOfColumns () const"
Returns the number of columns for this style.
.PP
See also: setNumberOfColumns(), displayMode() and setDisplayMode().
.SH "bool QStyleSheetItem::selfNesting () const"
Returns whether this style has self nesting enabled.
.PP
See also: setSelfNesting().
.SH "void QStyleSheetItem::setAlignment ( int f )"
Sets the alignment. This only makes sense for styles with
.PP
DisplayBlock. Possible values are AlignLeft, AlignRight and AlignCenter.
.PP
See also: alignment() and displayMode().
.SH "void QStyleSheetItem::setAnchor ( bool anc )"
Sets whether the style is an anchor (link). Elements in this style have connections to other documents or anchors.
.PP
See also: isAnchor().
.SH "void QStyleSheetItem::setColor ( const QColor & c )"
Sets the text color of this style.
.PP
See also: color().
.SH "void QStyleSheetItem::setContexts ( const QString & c )"
Sets a space separated list of names of styles that may contain elements of this style. If \fIc\fR is empty, the style can be nested everywhere.
.PP
See also: contexts().
.PP
Examples:
.(l
qbrowser/main.cpp
.)l
.SH "void QStyleSheetItem::setDisplayMode ( DisplayMode m )"
Sets the display mode of the style to \fIm.\fR
.PP
The affect of the available values are:
.TP
\fCDisplayBlock\fR - elements will be displayed as a rectangular block. (eg. <P> ... </P>)
.TP
\fCDisplayInline\fR - elements will be displayed in a horizontally flowing sequence. (eg. <EM> ... </EM>)
.TP
\fCDisplayListItem\fR - elements will be displayed vertically sequenced. (eg. <EM> ... </EM>)
.TP
\fCDisplayNone\fR - elements which are not displayed at all.
.PP
See also: displayMode().
.PP
Examples:
.(l
qbrowser/main.cpp
.)l
.SH "void QStyleSheetItem::setFontFamily ( const QString & fam )"
Sets the font family setting of the style.
.PP
See also: fontFamily(), QFont::family() and QFont::setFamily().
.SH "void QStyleSheetItem::setFontItalic ( bool italic )"
Sets italic or upright shape for the style.
.PP
See also: fontItalic() and definesFontItalic().
.SH "void QStyleSheetItem::setFontSize ( int s )"
Sets the font size setting of the style, in point measures.
.PP
See also: fontSize(), QFont::pointSize() and QFont::setPointSize().
.SH "void QStyleSheetItem::setFontUnderline ( bool underline )"
Sets underline for the style.
.PP
See also: fontUnderline() and definesFontUnderline().
.SH "void QStyleSheetItem::setFontWeight ( int w )"
Sets the font weight setting of the style. Valid values are those defined by QFont::Weight.
.PP
See also: QFont and fontWeight().
.SH "void QStyleSheetItem::setListStyle ( ListStyle s )"
Sets the list style of the style
.PP
This is used by nested elements which have a of DisplayListItem.
.PP
The affect of the available values are:
.TP
\fCListDisc\fR - a filled circle
.TP
\fCListCircle\fR - an unfilled circle
.TP
\fCListSquare\fR - a filled circle
.TP
\fCListDecimal\fR - an integer in base 10: \fI1, 2, 3,\fR ...
.TP
\fCListLowerAlpha\fR - a lowercase letter: \fIa, b, c,\fR ...
.TP
\fCListUpperAlpha\fR - an uppercase letter: \fIA, B, C,\fR ...
.PP
See also: listStyle().
.SH "void QStyleSheetItem::setLogicalFontSize ( int s )"
Sets the logical font size setting of the style tp \fIs.\fR Valid logical sizes are 1 to 7.
.PP
See also: logicalFontSize(), QFont::pointSize() and QFont::setPointSize().
.SH "void QStyleSheetItem::setLogicalFontSizeStep ( int s )"
Sets the logical font size step of this style to \fIs.\fR
.PP
See also: logicalFontSizeStep().
.SH "void QStyleSheetItem::setMargin ( Margin m, int v )"
Sets the width of margin \fIm\fR to \fIv\fR pixels.
.PP
The margin determinator \fIm\fR can be \fCMarginLeft, MarginRight, MarginTop, MarginBottom, MarginAll, MarginVertical\fR or \fCMarginHorizontal.\fR The value \fIv\fR must be >= 0.
.PP
See also: border().
.SH "void QStyleSheetItem::setNumberOfColumns ( int ncols )"
Sets the number of columns for this style. Elements in the style are divided into columns.
.PP
This only makes sense if the style uses a .
.PP
See also: numberOfColumns().
.SH "void QStyleSheetItem::setSelfNesting ( bool nesting )"
Sets the self nesting property for this style to \fInesting.\fR
.PP
Usually, all styles are self nesting, i.e. they can legally be nested recursively. A paragraph, for example, might contain other paragraphs as subparagraphs.
.PP
You may nevertheles want to disable self nesting for common HTML tags such as \fC<p>\fR or \fC<li>,\fR if you want to parse and display rich text documents based on "dirty" HTML. However, we recommend fixing the documents instead to close all non-empty tags, if that is possible.
.SH "void QStyleSheetItem::setWhiteSpaceMode ( WhiteSpaceMode m )"
Sets the white space mode to \fIm.\fR Possible values are
.TP
\fCWhiteSpaceNormal\fR - white spaces in the document only serve as seperators. Multiple spaces or indentation therefore is ignored.
.TP
\fCWhiteSpacePre\fR - white spaces are preserved. This is particulary useful to display programming code.
.SH "QStyleSheet* QStyleSheetItem::styleSheet ()"
Returns the stylesheet this item is in.
.SH "const QStyleSheet* QStyleSheetItem::styleSheet () const"
Returns the stylesheet this item is in.
.SH "SEE ALSO"
.BR http://www.troll.no/qt/qstylesheetitem.html
.SH COPYRIGHT
Copyright 1992-1999 Troll Tech AS.  See the license file included in
the distribution for a complete license statement.
.SH AUTHOR
Generated automatically from the source code.