diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-66EFFCF5-581A-4EE7-B784-8087A1081B6D.dita --- a/Symbian3/SDK/Source/GUID-66EFFCF5-581A-4EE7-B784-8087A1081B6D.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-66EFFCF5-581A-4EE7-B784-8087A1081B6D.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,40 +1,44 @@ - - - - - -Title -pane -

The Title pane displays a context-dependent application -title or state name. Title pane in Home screen view can work with touch down -and release but by default, there is no functionality.

- -Title pane - - - -
Using -the title pane in C++ applications

The API to use for the title -pane component is the Title pane API. For observing title pane touch events, -use the Title Pane Touch Observer API.

To use a title pane -in your application, create an instance of the class CAknTitlePane.

Use the method SetTextL() in the class CAknTitlePane to set the title pane text and display it. To set the text to scroll -if it does not fit the title pane text area, set the flag aScroll to ETrue. -To set the text to the default (name of the application), use the method SetTextToDefault().

Use the method SetPicture() to display a picture in the title pane. -To set the icon from a file, use the method SetPictureFromFileL(). Alternatively, to set a small -icon to be displayed together with text, use the method SetSmallPicture().

To set the title pane contents -from a resource file, use the method SetFromResourceL().

+ + + + + +Title +pane +

The Title pane displays a context-dependent application +title or state name. Title pane in Home screen view can work with touch down +and release but by default, there is no functionality.

+ +Title pane + + +
    +
  • Typically, the title text is the descriptive name of the current main +pane view.

  • +
  • In an application title pane, the title text is typically +the application name.

  • +
  • In the home screen, the Title pane may contain +an operator logo (left-aligned in the area available) instead of the operator +name as text.

  • +
+
Using +the title pane in applications

The API to use for the title pane +component is the Title pane API. For observing title pane touch events, use +the Title Pane Touch Observer API.

To use a title pane in your application, +create an instance of the CAknTitlePane class.

Use +the CAknTitlePane::SetTextL() method to set the title pane +text and display it. To set the text to scroll if it does not fit the title +pane text area, set the flag aScroll to ETrue. +To set the text to the default (name of the application), use the CAknTitlePane::SetTextToDefault() method.

Use +the CAknTitlePane::SetPicture() method to display a picture +in the title pane. To set the icon from a file, use the CAknTitlePane::SetPictureFromFileL() method. +Alternatively, to set a small icon to be displayed together with text, use +the CAknTitlePane::SetSmallPicture() method.

To set +the title pane contents from a resource file, use the CAknTitlePane::SetFromResourceL() method.

\ No newline at end of file