epoc32/include/mw/commondialogs.rh
branchSymbian2
changeset 2 2fe1408b6811
parent 1 666f914201fb
child 4 837f303aceeb
--- 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