UIQ Technology
 Developer Library

UIQ 3 SDK

UIQ developer portal

FEEDBACK 

[Index] [Spacer] [Previous] [Next]



Location: QikListBoxRow.h
Link against: qiklbx.lib

Class CQikListBoxRow

class CQikListBoxRow : public CQikListBoxLayoutElement;

Description

Representation of a row in a CQikListBox .

Derivation

Members

Defined in CQikListBoxRow:
GetProperties(), NewColumnL(), NewColumnLeftOfL(), SetProperties()

Inherited from CBase:
Delete(), Extension_(), operator new()

Inherited from CQikListBoxLayoutElement:
ApplyRect(), CalculateSize(), Column(), ContentType(), DoColumnInterlacing(), DynamicSized(), FixedSized(), FromSubTreeSized(), GetContentTypeProperties(), GetContentTypePropertiesL(), IsHideIfEmpty(), Margins(), MinimumSize(), Row(), SemiFixedSized(), SetContentTypeL(), SetContentTypePropertiesL(), SetMargins(), SizeGrabWeight(), SizeInPixels(), iComponent, iComponentSize, iDrawingMargins, iFirstElement, iLayoutValues, iLeftElement, iRect, iRightElement, iSlotId


Member functions


NewColumnL()

IMPORT_C CQikListBoxColumn *NewColumnL(TInt aSlotId);

Description

Construct a new CQikListBoxColumn and adds it to this row. The column will be constructed with default properties. To change the properties of the column see CQikListBoxColumn::SetProperties .

Parameters

TInt aSlotId

The slot id for the new column.

Return value

CQikListBoxColumn *

The newly created row.

Panic codes

EQikListBoxPanicContentTypeMismatch

Raised if the row already contains a content type that is not parent since an element containing an other content type can not be parent to other elements. Debug builds only.


NewColumnLeftOfL()

IMPORT_C CQikListBoxColumn *NewColumnLeftOfL(TInt aNewColumnSlotId, TInt aExistingColumnSlotId);

Description

Creates and inserts a new column, left of an existing child column of this row.

Parameters

TInt aNewColumnSlotId

Slot id that will be assigned to the new column to create.

TInt aExistingColumnSlotId

Slot id of an existing child column of this row. The new column will be inserted left of this one.

Return value

CQikListBoxColumn *

The newly created and inserted column.

Panic codes

EQikListBoxPanicContentTypeMismatch

Raised if the row already contains a content type that is not parent since an element containing an other content type can not be parent to other elements. Debug builds only.

EQikListBoxPanicSlotIdIsNotZeroOrHigher

Slot id of aNewColumnSlotId is not positive. Debug builds only.

EQikListBoxPanicElementIsNull

The column with slot id aLeftColumnSlotId was not found as a child of this row. Debug builds only.


SetProperties()

IMPORT_C void SetProperties(const TQikListBoxPropertiesRow &aRowProps);

Description

Set properties for this row. Whether a row can have a type of size set to EQikListBoxSizeTypeFromContentType depends upon the component it contains and the properties of that component, therefor the component of the row must be set using CQikListBoxLayoutElement::SetComponentL prior to calling this method. Failure to do so might cause a panic.

Parameters

const TQikListBoxPropertiesRow &aRowProps

Properties to be applied to this row.

Panic codes

EQikListBoxPanicSizeTypeNotApplicable

Raised when trying to set the row to use EQikListBoxRowHeightFromContentType when it has no content type it can get content size from. Debug builds only.

EQikListBoxPanicGrabSizeMustBeGreaterThanZero

Raised when trying to set row to use EQikListBoxSizeTypeGrab but the grab size is invalid.

EQikListBoxPanicPixelSizeMustBeEqualOrGreaterThanZero

Raised when trying to set column to use EQikListBoxSizeTypePixels but the size specified is negative. Debug builds only.


GetProperties()

IMPORT_C void GetProperties(TQikListBoxPropertiesRow &aRowProps) const;

Description

Gets the properties of this row. The properties are copied into aRowProps.

Parameters

TQikListBoxPropertiesRow &aRowProps

Will contains the properties of this row upon return.

Terms and conditions of use of the material