QStyleOptionQ3ListViewItem Class Reference

The QStyleOptionQ3ListViewItem class is used to describe an item drawn in a Q3ListView. More...

#include <qstyleoption.h>

Inheritance diagram for QStyleOptionQ3ListViewItem:

Public Types
enum	Q3ListViewItemFeature {   None = 0x00, Expandable = 0x01, MultiLine = 0x02, Visible = 0x04,   ParentControl = 0x08 }
	This enum describes the features a list view item can have. More...
enum	StyleOptionType { Type = SO_Q3ListViewItem }
	This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More...
enum	StyleOptionVersion { Version = 1 }
	This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More...
Public Types inherited from QStyleOption
enum	OptionType {   SO_Default, SO_FocusRect, SO_Button, SO_Tab,   SO_MenuItem, SO_Frame, SO_ProgressBar, SO_ToolBox,   SO_Header, SO_Q3DockWindow, SO_DockWidget, SO_Q3ListViewItem,   SO_ViewItem, SO_TabWidgetFrame, SO_TabBarBase, SO_RubberBand,   SO_ToolBar, SO_GraphicsItem, SO_Complex = 0xf0000, SO_Slider,   SO_SpinBox, SO_ToolButton, SO_ComboBox, SO_Q3ListView,   SO_TitleBar, SO_GroupBox, SO_SizeGrip, SO_CustomBase = 0xf00,   SO_ComplexCustomBase = 0xf000000 }
	This enum is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. More...
enum	StyleOptionType { Type = SO_Default }
	This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More...
enum	StyleOptionVersion { Version = 1 }
	This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More...

Public Functions
	QStyleOptionQ3ListViewItem ()
	Constructs a QStyleOptionQ3ListViewItem, initializing the members variables to their default values. More...
	QStyleOptionQ3ListViewItem (const QStyleOptionQ3ListViewItem &other)
	Constructs a copy of the other style option. More...
Public Functions inherited from QStyleOption
void	init (const QWidget *w)
	Use initFrom(widget) instead. More...
void	initFrom (const QWidget *w)
QStyleOption &	operator= (const QStyleOption &other)
	Assign other to this QStyleOption. More...
	QStyleOption (int version=QStyleOption::Version, int type=SO_Default)
	Constructs a QStyleOption with the specified version and type. More...
	QStyleOption (const QStyleOption &other)
	Constructs a copy of other. More...
	~QStyleOption ()
	Destroys this style option object. More...

Public Variables
int	childCount
	the number of children the item has More...
Q3ListViewItemFeatures	features
	the features for this item More...
int	height
	the height of the item More...
int	itemY
	the Y-coordinate for the item More...
int	totalHeight
	the total height of the item, including its children More...
Public Variables inherited from QStyleOption
Qt::LayoutDirection	direction
	the text layout direction that should be used when drawing text in the control More...
QFontMetrics	fontMetrics
	the font metrics that should be used when drawing text in the control More...
QPalette	palette
	the palette that should be used when painting the control More...
QRect	rect
	the area that should be used for various calculations and painting More...
QStyle::State	state
	the style flags that are used when drawing the control More...
int	type
	the option type of the style option More...
int	version
	the version of the style option More...

Protected Functions
	QStyleOptionQ3ListViewItem (int version)

Additional Inherited Members
Related Functions inherited from QStyleOption
T	qstyleoption_cast (const QStyleOption *option)
T	qstyleoption_cast (QStyleOption *option)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More...

Detailed Description

The QStyleOptionQ3ListViewItem class is used to describe an item drawn in a Q3ListView.

This class is used for drawing the compatibility Q3ListView's items. It is not recommended for new classes.

QStyleOptionQ3ListViewItem contains all the information that QStyle functions need to draw the Q3ListView items.

For performance reasons, the access to the member variables is direct (i.e., using the . or -> operator). This low-level feel makes the structures straightforward to use and emphasizes that these are simply parameters used by the style functions.

For an example demonstrating how style options can be used, see the widgets/styles{Styles} example.

See also

QStyleOption, QStyleOptionQ3ListView, Q3ListViewItem

Definition at line 463 of file qstyleoption.h.

Enumerations

Q3ListViewItemFeature

enum QStyleOptionQ3ListViewItem::Q3ListViewItemFeature

This enum describes the features a list view item can have.

• None A standard item.
• Expandable The item has children that can be shown.
• MultiLine The item is more than one line tall.
• Visible The item is visible.
• ParentControl The item's parent is a type of item control (Q3CheckListItem::Controller).

See also

features, Q3ListViewItem::isVisible(), Q3ListViewItem::multiLinesEnabled(), Q3ListViewItem::isExpandable()

Enumerator
None
Expandable
MultiLine
Visible
ParentControl

Definition at line 469 of file qstyleoption.h.

                               { None = 0x00, Expandable = 0x01, MultiLine = 0x02, Visible = 0x04,
                                 ParentControl = 0x08 };

StyleOptionType

enum QStyleOptionQ3ListViewItem::StyleOptionType

This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass.

• Type The type of style option provided (SO_Q3ListViewItem for this class).

The type is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles.

See also

StyleOptionVersion

Enumerator
Type

Definition at line 466 of file qstyleoption.h.

{ Type = SO_Q3ListViewItem };

StyleOptionVersion

enum QStyleOptionQ3ListViewItem::StyleOptionVersion

This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass.

• Version 1

The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally do not need to check it.

See also

StyleOptionType

Enumerator
Version

Definition at line 467 of file qstyleoption.h.

{ Version = 1 };

Constructors and Destructors

QStyleOptionQ3ListViewItem() [1/3]

QStyleOptionQ3ListViewItem::QStyleOptionQ3ListViewItem

(

)

Constructs a QStyleOptionQ3ListViewItem, initializing the members variables to their default values.

Definition at line 3733 of file qstyleoption.cpp.

    : QStyleOption(Version, SO_Q3ListViewItem), features(None), height(0), totalHeight(0),
      itemY(0), childCount(0)
{
}

QStyleOptionQ3ListViewItem() [2/3]

QStyleOptionQ3ListViewItem::QStyleOptionQ3ListViewItem ( const QStyleOptionQ3ListViewItem &  other )

inline

Constructs a copy of the other style option.

Definition at line 480 of file qstyleoption.h.

: QStyleOption(Version, Type) { *this = other; }

QStyleOptionQ3ListViewItem() [3/3]

QStyleOptionQ3ListViewItem::QStyleOptionQ3ListViewItem ( int  version )

protected

Warning

This function is not part of the public interface.

Definition at line 3742 of file qstyleoption.cpp.

    : QStyleOption(version, SO_Q3ListViewItem), features(None), height(0), totalHeight(0),
      itemY(0), childCount(0)
{
}

Properties

childCount

QStyleOptionQ3ListViewItem::childCount

the number of children the item has

Definition at line 477 of file qstyleoption.h.

Referenced by QWindowsStyle::drawComplexControl(), QMotifStyle::drawComplexControl(), and QMacStyle::drawComplexControl().

features

QStyleOptionQ3ListViewItem::features

the features for this item

This variable is a bitwise OR of the features of the item. The deafult value is None .

See also

Q3ListViewItemFeature

Definition at line 473 of file qstyleoption.h.

Referenced by QWindowsStyle::drawComplexControl(), QMotifStyle::drawComplexControl(), QMacStyle::drawComplexControl(), and QCommonStyle::drawPrimitive().

height

QStyleOptionQ3ListViewItem::height

the height of the item

This doesn't include the height of the item's children. The default height is 0.

See also

Q3ListViewItem::height()

Definition at line 474 of file qstyleoption.h.

Referenced by QWindowsStyle::drawComplexControl(), QMotifStyle::drawComplexControl(), QMacStyle::drawComplexControl(), and QCommonStyle::drawPrimitive().

itemY

QStyleOptionQ3ListViewItem::itemY

the Y-coordinate for the item

The default value is 0.

See also

Q3ListViewItem::itemPos()

Definition at line 476 of file qstyleoption.h.

Referenced by QWindowsStyle::drawComplexControl().

totalHeight

QStyleOptionQ3ListViewItem::totalHeight

the total height of the item, including its children

The default total height is 0.

See also

Q3ListViewItem::totalHeight()

Definition at line 475 of file qstyleoption.h.

Referenced by QWindowsStyle::drawComplexControl(), QMotifStyle::drawComplexControl(), and QMacStyle::drawComplexControl().

---

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

• /src/gui/styles/qstyleoption.h
• /src/gui/styles/qstyleoption.cpp