Home · All Classes · Main Classes · Deprecated
Public Types | Public Member Functions | Protected Member Functions | Properties

MDetailedListItem Class Reference

MDetailedListItem implementation of a detailed widget which can be used with MList. More...

Inherits MListItem.

List of all members.

Public Types

enum  ItemStyle { IconTitleSubtitleAndTwoSideIcons, IconTitleSubtitleAndSideIconWithLabel, ThumbnailTitleSubtitleAndTwoSideIcons, ThumbnailTitleAndTwoSideIcons }
enum  IconStyle { Icon, Thumbnail }

Public Member Functions

 MDetailedListItem (MDetailedListItem::ItemStyle style=IconTitleSubtitleAndTwoSideIcons, QGraphicsItem *parent=NULL)
virtual ~MDetailedListItem ()
void initLayout ()
void setItemStyle (ItemStyle itemStyle)
ItemStyle itemStyle () const
void setIconStyle (IconStyle style)
IconStyle iconStyle () const
void setImageWidget (MImageWidget *icon)
MImageWidgetimageWidget ()
MImageWidgetsideTopImageWidget ()
MImageWidgetsideBottomImageWidget ()
void setTitle (const QString &title)
QString title ()
void setSubtitle (const QString &subtitle)
QString subtitle ()
void setSideBottomTitle (const QString &text)
QString sideBottomTitle ()

Protected Member Functions

MLabeltitleLabelWidget ()
MLabelsubtitleLabelWidget ()
MLabelsideBottomLabelWidget ()
virtual QGraphicsLayoutcreateLayout ()
virtual void clearLayout ()

Properties

QString title
QString subtitle
QString sideBottomTitle
MImageWidget imageWidget
MImageWidget sideTopImageWidget
MImageWidget sideBottomImageWidget

Detailed Description

MDetailedListItem implementation of a detailed widget which can be used with MList.

Overview

MDetailedListItem can show several lines of text, main icon and two icons or one top icon and sub label on left side of the item. The main icon can have two styles, as Icon and as Thumbnail. Exact layout depends on the style and can be set in:

Text and icon can be set using following functions:

Overview

MDetailedListItem appearance can be customized in 2 ways.

Title, subtitle, main icon, side icons and side label are using styles provided by common layout.

Another way is to inherit MDetailedListItem and override:


Member Enumeration Documentation

Specifies main icon styles for MDetailedListItem.

Enumerator:
Icon 

Defines main icon style as an icon with margins.

Thumbnail 

Defines main icon styles as a thumbnail without margins.

Specifies layout of MDetailedListItem.

Enumerator:
IconTitleSubtitleAndTwoSideIcons 

Defines style which contains a main icon, title with subtitle and two icons on the side.

IconTitleSubtitleAndSideIconWithLabel 

Defines style which contains a main icon, title with subtitle and small icon with a sublabel on the side.

ThumbnailTitleSubtitleAndTwoSideIcons 

Defines style which contains a main thumbnail, title with subtitle and two icons on the side.

ThumbnailTitleAndTwoSideIcons 

Defines style which contains a main thumbnail, a single title and two icons on the side.


Constructor & Destructor Documentation

MDetailedListItem::MDetailedListItem ( MDetailedListItem::ItemStyle  style = IconTitleSubtitleAndTwoSideIcons,
QGraphicsItem parent = NULL 
)

MDetailedListItem constructor.

Parameters:
style The style of item to be initialized with, defaults to MDetailedListItem::IconTitleSubtitleAndTwoSideIcons.
parent The item parent.
See also:
MDetailedListItem::ItemStyle
MDetailedListItem::setItemStyle()
MDetailedListItem::~MDetailedListItem (  )  [virtual]

MDetailedListItem destructor.


Member Function Documentation

void MDetailedListItem::clearLayout (  )  [protected, virtual]

Clears layout created by createLayout() function.

QGraphicsLayout * MDetailedListItem::createLayout (  )  [protected, virtual]
MDetailedListItem::IconStyle MDetailedListItem::iconStyle (  )  const

Returns current main icon style.

See also:
MDetailedListItem::setIconStyle()
MImageWidget* MDetailedListItem::imageWidget (  ) 

Creates or returns already created pointer to an item icon widget.

See also:
MDetailedListItem::setImageWidget()
void MDetailedListItem::initLayout (  ) 
Deprecated:
The method is no longer required to be called after constructing the item. There shouldn't be any need for this function.
MDetailedListItem::ItemStyle MDetailedListItem::itemStyle (  )  const

Returns current item style.

See also:
MDetailedListItem::setItemStyle()
void MDetailedListItem::setIconStyle ( IconStyle  style  ) 
void MDetailedListItem::setImageWidget ( MImageWidget icon  ) 

Sets item icon widget. Ownership is transfered to the item.

See also:
MDetailedListItem::imageWidget()
void MDetailedListItem::setItemStyle ( ItemStyle  itemStyle  ) 
void MDetailedListItem::setSideBottomTitle ( const QString text  ) 

Sets the item bottom side title text.

See also:
MDetailedListItem::sideBottomTitle()
void MDetailedListItem::setSubtitle ( const QString subtitle  ) 

Sets the item subtitle text.

See also:
MDetailedListItem::subtitle()
void MDetailedListItem::setTitle ( const QString title  ) 

Sets the item title text.

See also:
MDetailedListItem::title()
MImageWidget* MDetailedListItem::sideBottomImageWidget (  ) 

Creates or returns already created pointer to an item side bottom icon widget.

MLabel * MDetailedListItem::sideBottomLabelWidget (  )  [protected]

Creates or returns already created bottom side title widget.

See also:
MDetailedListItem::setSideBottomTitle()
MDetailedListItem::sideBottomTitle()
QString MDetailedListItem::sideBottomTitle (  ) 

Returns the item bottom side title text.

See also:
MDetailedListItem::setSideBottomTitle()
MImageWidget* MDetailedListItem::sideTopImageWidget (  ) 

Creates or returns already created pointer to an item side top icon widget.

QString MDetailedListItem::subtitle (  ) 

Returns the item subtitle text.

See also:
MDetailedListItem::setSubtitle()
MLabel * MDetailedListItem::subtitleLabelWidget (  )  [protected]

Creates or returns already created subtitle widget.

See also:
MDetailedListItem::setSubtitle()
MDetailedListItem::subtitle()
QString MDetailedListItem::title (  ) 

Returns the item title text.

See also:
MDetailedListItem::setTitle()
MLabel * MDetailedListItem::titleLabelWidget (  )  [protected]

Creates or returns already created title widget.

See also:
MDetailedListItem::setTitle()
MDetailedListItem::title()

Property Documentation

MDetailedListItem::imageWidget [read, write]

Contains pointer to main icon MImageWidget.

MDetailedListItem::sideBottomImageWidget [read]

Contains pointer to side bottom icon MImageWidget.

MDetailedListItem::sideBottomTitle [read, write]

Contains side bottom label text.

MDetailedListItem::sideTopImageWidget [read]

Contains pointer to side top icon MImageWidget.

MDetailedListItem::subtitle [read, write]

Contains subtitle text.

MDetailedListItem::title [read, write]

Contains title text.


Copyright © 2010 Nokia Corporation
MeeGo Touch