CEikBorderedControl Class Reference

API published in: S60 1st Ed

Link against: eikcoctl.lib avkon.lib

Capability Information

Required Capabilities

None


#include <eikbctrl.h>

Inherits CAknControl.

Inherited by CAknInputFrame, CAknPopupField, CAknPopupFieldList, CAknPopupList, CAknSlider, CEikButtonBase, CEikControlGroup, CEikDialog, CEikEdwin, CEikFileNameLabel, CEikListBox, CEikMenuBar, CEikMenuPane, CEikMenuPaneTitle, CEikMfne, CEikProgressInfo, CEikScrollBar, and CEikSecretEditor.


Detailed Description

A control which is drawn surrounded by a rectangular border.

The screen appearance of derived classes can be changed by overriding the protected method Draw(). By default, this draws a border of the appropriate type around the control.


Public Member Functions

IMPORT_C  CEikBorderedControl ()
  Default C++ Constructor.
IMPORT_C  CEikBorderedControl (const TGulBorder &aBorder)
  Constructor that creates a new bordered control with a specified border.
IMPORT_C TBool  HasBorder () const
  Checks whether the control has a border.
IMPORT_C void  SetAdjacent (TInt aAdjacent)
  Sets the control's adjacency.
IMPORT_C void  GetColorUseListL (CArrayFix< TCoeColorUse > &aColorUseList) const
  Not used in S60.
IMPORT_C void  HandleResourceChange (TInt aType)
  Handles a change to the control's resources.
IMPORT_C void  HandlePointerEventL (const TPointerEvent &aPointerEvent)
  Handles pointer events.
IMPORT_C void  SetBorder (TGulBorder::TBorderType aBorderType)
  Sets the border type of the control to a type defined in TGulBorder::TBorderType.
IMPORT_C void  SetBorder (TInt aBorderType)
  Sets the border type.
IMPORT_C TGulBorder  Border () const
  Gets the control's border.

Protected Member Functions

IMPORT_C void  Draw (const TRect &aRect) const
  Draws the border around the control.
IMPORT_C void  WriteInternalStateL (RWriteStream &aWriteStream) const
  Writes the internal state of the control and its components to aWriteStream.

Protected Attributes

TGulBorder  iBorder
  The control's border.

Constructor & Destructor Documentation

IMPORT_C CEikBorderedControl::CEikBorderedControl  ) 
 

Default C++ Constructor.

Constructs a new bordered control that has no border.

IMPORT_C CEikBorderedControl::CEikBorderedControl const TGulBorder &  aBorder  ) 
 

Constructor that creates a new bordered control with a specified border.

Parameters:
aBorder  The border of the control.

Member Function Documentation

IMPORT_C TGulBorder CEikBorderedControl::Border  )  const
 

Gets the control's border.

Returns:
The border of the control.
IMPORT_C void CEikBorderedControl::Draw const TRect &  aRect  )  const [protected]
 

Draws the border around the control.

This function also clears the central area if the IsBlank() method returns ETrue.

From CCoeControl

Parameters:
aRect  Not used.
See also:
CCoeControl::IsBlank()

Border()

Reimplemented in CAknDialog, CAknGMSStyleGrid, CAknSetStyleListBox, CAknPopupField, CAknSelectionListDialog, CAknSlider, CEikCba, CEikCommandButtonBase, CEikEdwin, CEikFileNameLabel, CEikListBox, CEikMenuBar, CEikMenuPaneTitle, CEikMenuPane, AknListBoxLinesTemplate< CEikSettingsListBox >, AknListBoxLinesTemplate< CAknColumnListBox >, and AknListBoxLinesTemplate< CEikFormattedCellListBox >.

IMPORT_C void CEikBorderedControl::GetColorUseListL CArrayFix< TCoeColorUse > &  aColorUseList  )  const
 

Not used in S60.

From CCoeControl.

Parameters:
aColorUseList  Not used.

Reimplemented in CEikButtonBase, CEikCba, CEikColumnListBox, CEikCommandButtonBase, CEikControlGroup, CEikDialog, CEikEdwin, CEikFileNameLabel, CEikFormattedCellListBox, CEikListBox, CEikSnakingListBox, CEikMenuBar, CEikMenuPaneTitle, CEikMenuPane, CEikMfne, CEikProgressInfo, CEikSecretEditor, CEikToolBar, CEikTextListBox, and CEikSnakingTextListBox.

IMPORT_C void CEikBorderedControl::HandlePointerEventL const TPointerEvent &  aPointerEvent  ) 
 

Handles pointer events.

This function gets called whenever a pointer event occurs in the control, i.e. when the pointer is within the control's extent, or when the control has grabbed the pointer.

If overriding this method, the implementation must include a base call to this method.

From CCoeControl.

Parameters:
aPointerEvent  The pointer event.

Reimplemented in CAknDialog, CAknForm, CAknGMSStyleGrid, CAknGMSPopupGrid, CAknGrid, CAknIpFieldEditor, CAknListQueryDialog, CAknColumnListBox, CAknSingleStyleListBox, CAknSingleGraphicStyleListBox, CAknSingleGraphicHeadingStyleListBox, CAknSingleLargeStyleListBox, CAknDoubleNumberStyleListBox, CAknDoubleTimeStyleListBox, CAknDouble2GraphicStyleListBox, CAknDouble2LargeStyleListBox, CAknSettingStyleListBox, CAknSinglePopupMenuStyleListBox, CAknSingleGraphicPopupMenuStyleListBox, CAknSingleGraphicBtPopupMenuStyleListBox, CAknSingleHeadingPopupMenuStyleListBox, CAknSingleGraphicHeadingPopupMenuStyleListBox, CAknDoublePopupMenuStyleListBox, CAknSinglePopupSubmenuStyleListBox, CAknDoubleLargeGraphicPopupMenuStyleListBox, CAknDouble2PopupMenuStyleListBox, CAknSingle2GraphicPopupMenuStyleListBox, CAknDoubleGraphicPopupMenuStyleListBox, CAknSetStyleListBox, CAknFormGraphicStyleListBox, CAknFormGraphicWideStyleListBox, CAknPinbStyleGrid, CAknQdialStyleGrid, CAknCaleMonthStyleGrid, CAknMessageQueryDialog, CAknNoteDialog, CAknNoteWrapper, CAknResourceNoteDialog, CAknConfirmationNote, CAknInformationNote, CAknErrorNote, CAknWarningNote, CAknNumericEdwin, CAknIntegerEdwin, CAknNumericSecretEditor, CAknPopupList, CAknPopupField, CAknPopupFieldList, CAknPopupFieldText, CAknPopupSettingList, CAknProgressDialog, CAknQueryDialog, CAknTextQueryDialog, CAknNumberQueryDialog, CAknTimeQueryDialog, CAknDurationQueryDialog, CAknFloatingPointQueryDialog, CAknMultiLineDataQueryDialog, CAknSelectionListDialog, CAknMarkableListDialog, CAknSlider, CAknStaticNoteDialog, CAknWaitDialog, CEikAlert, CEikButtonBase, CEikCba, CEikColumnListBox, CEikCommandButtonBase, CEikCommandButton, CEikTwoPictureCommandButton, CEikInverterCommandButton, CEikTextButton, CEikBitmapButton, CEikControlGroup, CEikDialog, CEikEdwin, CEikFileNameLabel, CEikFloatingPointEditor, CEikFixedPointEditor, CEikFormattedCellListBox, CEikGlobalTextEditor, CEikInfoDialog, CEikListBox, CEikSnakingListBox, CEikMenuBar, CEikMenuPaneTitle, CEikMenuPane, CEikMfne, CEikNumberEditor, CEikRangeEditor, CEikTimeEditor, CEikDateEditor, CEikTimeAndDateEditor, CEikDurationEditor, CEikTimeOffsetEditor, CEikMenuButton, CEikProgressInfo, CEikRichTextEditor, CEikScrollButton, CEikScrollBar, CEikArrowHeadScrollBar, CAknDoubleSpanScrollBar, CEikSecretEditor, CEikSettingsListBox, CEikToolBar, CEikTextListBox, and CEikSnakingTextListBox.

IMPORT_C void CEikBorderedControl::HandleResourceChange TInt  aType  ) 
 

Handles a change to the control's resources.

The types of resources handled are those which are shared across the environment, e.g. colours or fonts. For colour scheme changes, DrawDeferred() is called in order to redraw the control.

If overriding this method, the implementation must include a base call to this method.

From CCoeControl.

Parameters:
aType  The type of resource that has changed.

Reimplemented in CAknForm, CAknGrid, CAknInputFrame, CAknListQueryDialog, CAknNoteDialog, CAknIntegerEdwin, CAknPopupList, CAknPopupField, CAknPopupSettingList, CAknMultiLineDataQueryDialog, CAknMultiLineIpQueryDialog, CAknSlider, CEikButtonBase, CEikCba, CEikColumnListBox, CEikCommandButtonBase, CEikControlGroup, CEikDialog, CEikEdwin, CEikFileNameLabel, CEikFloatingPointEditor, CEikFixedPointEditor, CEikFormattedCellListBox, CEikListBox, CEikSnakingListBox, CEikMenuBar, CEikMenuPaneTitle, CEikMenuPane, CEikMfne, CEikProgressInfo, CEikSecretEditor, CEikToolBar, CEikTextListBox, and CEikSnakingTextListBox.

IMPORT_C TBool CEikBorderedControl::HasBorder  )  const
 

Checks whether the control has a border.

From CCoeControl.

Returns:
ETrue if the control has a border, EFalse otherwise.
IMPORT_C void CEikBorderedControl::SetAdjacent TInt  aAdjacent  ) 
 

Sets the control's adjacency.

Declares that a control abuts another control along one edge, and does not need to be drawn with a full border along that side. This is for use by layout engines or any user code which lays out controls next to one another.

Its intended use is to remove the double border that may occur if two controls, both with borders, are adjacent within a container control.

From CCoeControl.

Parameters:
aAdjacent  A value from TGulAdjacent declaring which edge of this control is shared.
See also:
CCoeControl::SetAdjacent()
IMPORT_C void CEikBorderedControl::SetBorder TInt  aBorderType  ) 
 

Sets the border type.

Any one of the values from the enums TGulBorder::TBorderType or TGulBorder::TLogicalType specifies a valid border type.

Custom border types can be created by selecting one value from enum TGulBorder::T3DStyle, one value from enum TGulBorder::TConstructionStyle, at most one value from enum TGulBorder::TOutlineStyle, at most one value from enum TGulBorder::TInlineStyle, at least one value from enum TGulBorder::TThickness and at least one value from enum TGulBorder::TRounding and performing an OR operation to these.

Parameters:
aBorderType  The border type to be set.
IMPORT_C void CEikBorderedControl::SetBorder TGulBorder::TBorderType  aBorderType  ) 
 

Sets the border type of the control to a type defined in TGulBorder::TBorderType.

Parameters:
aBorderType  The border type to be set.
IMPORT_C void CEikBorderedControl::WriteInternalStateL RWriteStream &  aWriteStream  )  const [protected]
 

Writes the internal state of the control and its components to aWriteStream.

Does nothing in release mode.

Designed to be overridden and base called from subclasses.

From CCoeControl

Parameters:
[in,out]  aWriteStream  A connected write stream.

Reimplemented in CEikButtonBase, CEikCommandButtonBase, CEikTwoPictureCommandButton, CEikInverterCommandButton, CEikControlGroup, CEikDialog, CEikEdwin, CEikGlobalTextEditor, CEikMfne, CEikMenuButton, CEikProgressInfo, CEikRichTextEditor, CEikToolBar, and CEikTextListBox.


Field Documentation

TGulBorder CEikBorderedControl::iBorder [protected]
 

The control's border.


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

Copyright © Nokia Corporation 2001-2008
Back to top