release_notes.txt

symbian C++ 开发学习的一个很好的例子

S60 Platform: Rich Text Editor Example v2.0
-------------------------------------------------

This C++ code example demonstrates the usage of Rich Text Editor. Most of the features
are handled automatically when the dialog framework creates the editor. However, 
some steps, such as inserting an image, setting the text input type, or showing 
the scroller require the use of methods or classes.
 
--------------------------------------------------------------------------------

PREREQUISITES

Symbian C++ basics

--------------------------------------------------------------------------------

IMPORTANT FILES/CLASSES

src\RichTextEditorContainer.cpp
   Shows, for example, how to insert an image, scroller, and text input type for RichTextEditor.

Important classes: CEikRichTextEditor, CFbsBitmap, TPictureHeader, CPicture

--------------------------------------------------------------------------------

KNOWN ISSUES

No known issues.
    
--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

Start the application. An editor opens.

Select any part of the text: press and hold the Edit key while moving the scroller key
to left or right. The selected text is highlighted.

You can select various formatting options from the Options menu (character format, color, 
alignment, and font).


--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

Steps for building and installing the application to a device depend on the S60 platform version:

--Mobile device (S60 3rd Edition)
    cd to /RichTextEditor/group
    bldmake bldfiles
    abld build gcce urel
    cd to /RichTextEditor/sis
    Edit the RichTextEditor_S60_3rd_ed.pkg's paths to match those on your system.
    makesis RichTextEditor_S60_3rd_ed.pkg
    
    Sign the SIS package 
      - See the SDK Help for information about self-signed .sis packages, or
        www.symbiansigned.com for information about Developer Certificates.

    Install the signed .sis file to an S60 3rd Edition device.
      - If you get a "Certificate error" during installation of a self-signed 
	package, check that App.Manager -> Settings -> Software Installation is set to "All". 
    
--Mobile device (S60 1st and 2nd Edition)
    cd to /RichTextEditor/group
    bldmake bldfiles
    abld build armi urel
    cd to /RichTextEditor/sis
    Edit the RichTextEditor_S60_2nd_ed.pkg's (or RichTextEditor_S60_1st_ed.pkg's) paths to match 
	those on your system.
    makesis RichTextEditor_S60_2nd_ed.pkg (or RichTextEditor_S60_1st_ed.pkg)
    Install the SIS file to the device.

--Emulator (WINSCW)
    cd to /RichTextEditor/group
    bldmake bldfiles
    abld build winscw udeb
    Start the emulator.

--Carbide.c++ IDE

You can also import the example into Carbide.c++ IDE. Note that the source 
code of this code example itself supports building to both S60 2nd and 3rd Edition. 
However, when importing it to Carbide, you need to import to separate S60 2nd Edition
and 3rd Edition projects. This is because Carbide only supports multiple project 
configurations between S60 2nd Edition releases and S60 3rd Edition releases, 
but it is not possible to build from the same source to both S60 2nd and 
3rd Edition. So for further development in Carbide, you need to implement the 
changes twice.

Note also that Carbide does not deal with MMP files when creating and building 
applications but it is still possible to import existing applications to Carbide 
from an MMP file. In this code example, the MMP provides some additional definitions
that allow seamless importing of all required application directories and files to 
Carbide.

Steps for importing to Carbide.c++:

    1. Make sure that the path for the current Carbide workspace does not contain any 
       whitespace characters.
       If necessary, select a new workspace folder in Carbide (File -> Switch workspace