release_notes.txt

FileList_Example 是s60的一个文件列表控件

S60 Platform: FileList Example v2.0
-------------------------------------------------

This C++ code example demonstrates how to list files from a specific directory. 
It helps developers in creating user-friendly applications that allow 
users to choose files from a list of specific file types.
 
--------------------------------------------------------------------------------

PREREQUISITES

Symbian C++ basics

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

IMPORTANT FILES/CLASSES

src\FileListEngine.cpp 
    GetResourceFilesL(TFileName &aBasePath)
       Fetch the selected file types (including files in subfolders).
	 
    StartFileList()
       This method gets the specific directory.
	 S60 1st Edition devices use hard-coded paths and S60 2nd and 3rd Edition devices 
       get the specific path using PathInfo.

    LaunchCurrentL(TInt aPosition)
       Launch the selected files using CDocumentHandler (all extensions do not work on the emulator).
	
src\FileListContainer.cpp
    Shows the list of selected file types.

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

KNOWN ISSUES

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

RUNNING THE EXAMPLE

When the application is started, choose the 'Options' menu and select Sounds, Pictures, or 
Video. The FileList application shows a numbered list of files. The file name 
is on the first line; and the second line in the listbox item shows the modification date 
or the file size. The date and size can be toggled from the first menu item. 
     
--------------------------------------------------------------------------------

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 /FileList/group
    bldmake bldfiles
    abld build gcce urel
    cd to /FileList/sis
    Edit the FileList_S60_3rd_ed.pkg's paths to match those on your system.
    makesis FileList_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.
    
--Mobile device (S60 1st and 2nd Edition)
    cd to /FileList/group
    bldmake bldfiles
    abld build armi urel
    cd to /FileList/sis
    Edit the FileList_S60_2nd_ed.pkg's (or FileList_S60_1st_ed.pkg's) paths to match those on your system.
    makesis FileList_S60_2nd_ed.pkg's (or FileList_S60_1st_ed.pkg)
    Install the SIS file to the device.

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

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition
S60 1st Edition

TESTED WITH Nokia 3650, Nokia 6670, Nokia E60, Nokia E61, and Nokia N80.
Created / tested with S60 1st Edition SDK for Symbian OS 
and with S60 2nd Edition SDK for Symbian OS, For C++, Supporting Metrowerks CodeWarrior
and with S60 3rd Edition SDK for Symbian OS, For C++, Supporting Metrowerks CodeWarrior

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

VERSION HISTORY		

2.0	Ported from S60 2nd to 3rd Edition.
1.0	First release.

--------------------------------------------------------------------------------
EVALUATE THIS RESOURCE 

Please spare a moment to help us improve documentation quality and recognize the examples you find most valuable, 
by rating this resource at 
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId= 92747d5f-c17d-4660-b571-afd69cbe13c8/S60_Platform_FileList_Example_v2_0_en.zip