diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/commondialogs.rh --- a/epoc32/include/mw/commondialogs.rh Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/commondialogs.rh Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,131 @@ -commondialogs.rh +/* +* Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: This file contains declarations for resources of +* Common File Dialogs. The file can be included only in +* resource file. +* +*/ + + +// INCLUDES + +// STRUCTURE DEFINITIONS + +// --------------------------------------------------------- +// FILTER +// FILTER is a resource structure for filter definition. +// "filter_type" defines if the filter is an attribute or a filename filter. +// "filter_style" defines if the filter is an inclusive or an exclusive filter. +// Inclusive filter doesn't accept anything but the files and folders (entries) +// that match with the filter. Exclusive filter accepts only those entries +// that match with the filter. +// "filter_data" is an array of strings: +// In filename filter data is wildcards ("*.jpg", "*.gif", ...). +// In attribute filter data is first letters of attributes +// ("R", "H", "S", ... or "RHS"). +// The attributes in Symbian OS file system are: +// Read only, Hidden, System, Volume, Directory and Archive +// Note! Files and directories with System attribute are always hidden +// from user. +// --------------------------------------------------------- +// +STRUCT FILTER + { + WORD filter_type; + WORD filter_style; + LTEXT filter_data[]; + } + +// --------------------------------------------------------- +// LOCATION +// LOCATION is a resource structure that defines a root path and a default folder. +// "root_path" is the absolute path to be considered as root when browsing. +// e.g. "C:\\Nokia\\" +// "default_folder" is the folder where browsing is started. +// e.g. "Images\\Pictures\\" +// Note! Do not put folder names in .LOC file! These are +// physical file system paths. Possible localization is done +// in the DLL. +// Note! Remeber to use trailing backslash! +// --------------------------------------------------------- +// +STRUCT LOCATION + { + LTEXT root_path; + LTEXT default_folder; + } + +// --------------------------------------------------------- +// MEMORYSELECTIONDIALOG +// MEMORYSELECTIONDIALOG is a resource structure for memory selection dialog. +// In this structure a title and texts for softkeys can be defined. +// "title" is "Select memory:" by default if it is not defined. +// Locations of the memories can be defined. +// NOTE: Locations for memory selection dialog is deprecated. Only use it +// when using TMemory parameter in CAknMemorySelectionDialog +// @see CAknMemorySelectionDialog +// --------------------------------------------------------- +// +STRUCT MEMORYSELECTIONDIALOG + { + LTEXT title; + LTEXT softkey_1; + LTEXT softkey_2; + STRUCT locations[]; // LOCATION + } + +// --------------------------------------------------------- +// FILESELECTIONDIALOG +// This is a resource structure for file selection dialog. +// In this structure a title and texts for softkeys can be defined. +// "title" is "Select from:" by default if it is not defined. +// "softkey_1_file" is shown when a file is focused. +// "softkey_1_folder" is shown when a folder is focused. +// "softkey_2_root_level" is shown when user is browsing in the first level (root folder). +// "softkey_2_subfolder" is shown when user is browsing in a subfolder +// "root_path" and "default_folder" can be defined. They are explained in LOCATION struct. +// Filters can be defined with FILTER structures. +// --------------------------------------------------------- +// +STRUCT FILESELECTIONDIALOG + { + LTEXT title; + LTEXT softkey_1_file; + LTEXT softkey_1_folder; + LTEXT softkey_2_root_level; + LTEXT softkey_2_subfolder; + LTEXT root_path; + LTEXT default_folder; + STRUCT filters[]; // FILTER structs + } + +// --------------------------------------------------------- +// FILENAMEPROMPTDIALOG +// A structure for prompting a single filename. +// In this structure a title and texts for softkeys can be defined. +// "default_filename" defines the default filename. Extension is not shown. +// "path" is the path that the file is supposed to save. +// If path is set, it can be checked if file already exists. +// --------------------------------------------------------- +// +STRUCT FILENAMEPROMPTDIALOG + { + LTEXT filename_prompt; // title + LTEXT default_filename; + LTEXT path; + LTEXT softkey_1; + LTEXT softkey_2; + } + +// End of File