gsgetfile.dll version 0.05?

In beginning

As for this software, those where Y.Nagamidori was drawn up, obtaining the permission of the writer, it is something which it releases.
* Because presently development is discontinued, it is non support.
As for the inquiry and the like please make sure not to do.
It is WindowsCE general-purpose file selective dialogue.

There is once the file selective dialogue with PocketPC, but it cannot select the file of the folder other than My Documents
Multiple file selections of the file cannot do with the file selective dialogue of HPC
l'agenda, with the pocket post pet there is no file selective dialogue itself

And so on those which can be used general-purpose from the reason were drawn up.
Please use the one which likes freely and do development.

Summary

" Opens the file " of PocketPC standard portion of dialogue and " acquiring name it cannot access in only the folder where file selective dialogue of retention " is limited My Documents etc which and it is inconvenient.
In addition, function has been limited also those of HPC standard from those of PC Windows, dissatisfaction remains.
gsgetfile.dll is DLL which with PocketPC offers the functional dialogue above file selective dialogue of standard with offer and HPC of file selective dialogue above HPC equality (dynamic link library).
Dialogue changes PocketPC/HPC/[popope] (the breadth 320pixel edition of HPC)/Palm-sizePC (the breadth 240pixel edition of HPC) with.

Hardware requirement, and necessary DLL

Those above WindowsCE2.11 Japanese edition
It does not depend on the platform.
When it builds from the source, you think that you can use even with WindowsCE 2.0.

Necessary environment for software development

embedded Visual C++ 3.0

Operation verification

Operation verification is done with jornada720/GENIOe550X/E-65.

Usage

Please include gsgetfile.h of the include folder, link gsgetfile.lib of the lib folder and use.
In addition when dll is loaded with LoadLibrary function, it is unnecessary.
Lib and dll of CPU which corresponds when from the source please build by your.
When gsgetlib.lib of the lib folder when gsgetfile.dll exists, uses gsgetfile.dll, does not exist, it is the static library which mounts the function which calls those of OS standard.
Including gsgetlib.h of the include folder, please use with the taste.

Reference

The function which is equal to the common dialogue of OS standard is mounted on gsgetfile.dll.
Basically GetOpenFileName and GetSaveFileName and usage of common dialogue are the same.

BOOL gsGetOpenFileName (OPENFILENAME* pofn)

Function:	File selective dialogue (the dialogue which is opened) it indicates and acquires file name.
Argument:	OPENFILENAME* pofn:	Pointer to information structure body
Return value:	TRUE: Success/FALSE: Failure
Details:	GetOpenFileName of common dialogue () with it operates equally.

BOOL gsGetSaveFileName (OPENFILENAME* pofn)

Function:	File selective dialogue (retention dialogue) it indicates and acquires file name.
Argument:	OPENFILENAME* pofn:	Pointer to information structure body
Return value:	TRUE: Success/FALSE: Failure
Details:	GetSaveFileName of common dialogue () with it operates equally.

Information structure body OPENFILENAME

Information structure body OPENFILENAME is defined as follows.
The right side is notice of each value.
Those which do not have the especially point of caution are the field which is supported.
typedef struct tagOFN {

??	DWORD	lStructSize;	//	Size of structure: Sizeof (OPENFILENAME) please be sure to set.
	HWND	hwndOwner;
	HINSTANCE	hInstance;	//	Not yet support
	LPCTSTR	lpstrFilter;	//	Support of group of extensions (* note 1)
	LPTSTR	lpstrCustomFilter;	//	Not yet support
	DWORD	nMaxCustFilter;	//	Not yet support
	DWORD	nFilterIndex;
	LPTSTR	lpstrFile;
	DWORD	nMaxFile;
	LPTSTR	lpstrFileTitle;	//	(* Note 2)
	DWORD	nMaxFileTitle;
	LPCTSTR	lpstrInitialDir;
	LPCTSTR	lpstrTitle;
	DWORD	Flags;	//	Referring to the support circumstance of the value Flags of below-mentioned OPENFILENAME
	WORD	nFileOffset;	//	Not yet support
	WORD	nFileExtension;	//	Not yet support
	LPCTSTR	lpstrDefExt;
	LPARAM	lCustData;	//	Not yet support
	LPOFNHOOKPROC	lpfnHook;	//	Not yet support
	LPCTSTR	lpTemplateName;	//	Not yet support

} OPENFILENAME and *LPOPENFILENAME;
* Note 1: With HPC " *.mp3; *mp2; *.mpa " the way the extension plural it is not possible to appoint with comma pause, but with gsgetfile.dll appointment with this comma pause is supported. (We wanted this function.)
* Note 2: At the time of file name plural selections value is not housed with the OFN_ALLOWMULTISELECT flag. It is equal to the dialogue for PC Windows.
As for the information whose each field is detailed please refer to the MSDN library and the like.

The support circumstance of Flags of OPENFILENAME

The flag below the 0 is supported.
OFN_ALLOWMULTISELECT
OFN_CREATEPROMPT
OFN_OVERWRITEPROMPT
OFN_PATHMUSTEXIST
OFN_FILEMUSTEXIST
The flag below the 0 is not yet support.
OFN_ENABLEHOOK
OFN_ENABLESIZING
OFN_ENABLETEMPLATE
OFN_ENABLETEMPLATEHANDLE
OFN_EXPLORER
OFN_HIDEREADONLY
OFN_LONGNAMES
OFN_NOCHANGEDIR
OFN_NODEREFERENCELINKS
OFN_NOLONGNAMES
OFN_NONETWORKBUTTON
OFN_NOREADONLYRETURN
OFN_NOTESTFILECREATE
OFN_NOVALIDATE
OFN_PROJECT
OFN_PROPERTY
OFN_READONLY
OFN_SHAREAWARE
OFN_SHOWHELP
The flag below the 0 under present conditions is not yet support, if but it is necessary, perhaps it will support in the future.
OFN_EXTENSIONDIFFERENT
As for the information whose each flag is detailed please refer to the MSDN library and the like.

Restriction item

About 0OFN_ALLOWMULTISELECT
It is selection of the multiple files. It is supported. With only GetOpenFileName it is effective.
The single file selective time full path name is housed in lpstrFile of the OPENFILENAME structure, but
At the time of plural selections
< Pass >NULL< file name 1>NULL< file name 2>NULL< file name 3>:
The way it is housed.
It is the operation which is equal to GetOpenFileName for PC Windows.
The operation restriction with 0HPC
The desktop exists in HPC and with those of OS standard it is accessible in the desktop, but
It cannot access with gsgetfile.dll.
Operation with the device which does not do 0 operation verification
The idea contest and the like of the folder however the [ku] are times when it is not indicated.
When there is a device which is not indicated please report to the writer. Perhaps it supports.
Acquisition of information of 0 error
When GetOpenFileName () /GetSaveFileName () it fails, CommDlgExtendedError () with information of error
You can acquire, but you cannot acquire with gsgetfile.dll.

The working condition of dll itself

gsgetfile.dll is the free software. The redistribution of dll itself/reprinting etc please go freely. There is no restriction.

Working condition of source code

There is a working condition in regard to the source.
As for that

When there is a fatal bug, reports to the writer
Offering information of operation verification with the device which does not have operation verification to the writer (especially l'agenda and the [po] [po] [pe])

Is.
After how being utilized, you are not concerned.
Commercial business utilization, distribution of alteration edition and the installation etc to the software etc favorite the way please use.
It will gain also you do not think with this ones and.
With say, changing name, just a little just improvement another name attaching the person whom it adds to the source, it makes the shareware
However you think that the one which is not done excessively is good (as much as xx mascot disturbance there was a wretched behavior where with you said and)

Sample cord/code

When 0gsgetfile.dll exists, gsgetfile.dll is used,
When it does not exist, the functional saw which calls calling the OS standard - the [do] (from gsgetlib.lib excerpt)
BOOL GetOpenFileNameEx (OPENFILENAME* pofn)
{
HINSTANCE hInst = LoadLibrary (_T ("gsgetfile.dll"));
if (hInst) {
BOOL (*gsGetOpenFileName) (OPENFILENAME* pofn);
(FARPROC&) gsGetOpenFileName = GetProcAddress (hInst and _T ("gsGetOpenFileName"));
if (gsGetOpenFileName) {
BOOL ret = gsGetOpenFileName (pofn);
FreeLibrary (hInst);
return ret;
}
FreeLibrary (hInst);
}
return GetOpenFileName (pofn);
}
The 0 normality the cord/code which indicates the dialogue which " opens the file "
void OnFileOpen ()
{
WCHAR szFile [MAX_PATH] = L " \ 0 ";
OPENFILENAME ofn;
memset (& (ofn), 0, sizeof (ofn));
ofn.lStructSize = sizeof (ofn);
ofn.hwndOwner = m_hWnd;
ofn.lpstrFile = szFile;
ofn.nMaxFile = MAX_PATH;
": where ofn.lpstrTitle = L MP3 file is opened ";
ofn.lpstrFilter = L " active file \ 0*.mp3; *.rmp; *.mp2; *.mpa \ 0MP3 file (*.MP3) \ 0*.mp3 \ 0RMP file (*.RMP) \ 0*.rmp \ 0Layer-2 (*.mp2) \ 0*.mp2 \ 0Layer-1 (*.mpa) \ 0*.mpa \ 0 all files (*.*) \ 0*.* \ 0 \ 0 ";
ofn. Flags = OFN_EXPLORER | OFN_FILEMUSTEXIST | OFN_ALLOWMULTISELECT;
ofn.lpstrInitialDir = m_szInitDir;
if (GetOpenFileName (&ofn) == IDOK)
{
// processing when it succeeds
}
}

Reference material

Difference with the file selective dialogue of 0HPC standard

Plural selections of the file are possible
It cannot access the desktop
There is no new folder compilation button
Comma pause plural extension appointments are possible

Difference with the file selective dialogue of 0PocketPC standard

Access of the file of the folder other than My Documents is possible
Plural selections of the file are possible
Those of PocketPC standard are slow strangely

Renewal past record

0.00?	First edition compilation
0.01?	When there is a extension the single selective time of the file, because it does not operate just, correction
	With PocketPC modification of operation at time of plural selections
0.02?	Breadth 320pixel correspondence
	When ramming down the filter to the text box, operation correction
	The bug Fix where shortcut of the folder is indicated in doubly
0.03?	When the file is not selected from the list, the bug where the extension is not attached Fix
	Because the folder two there are times when it is indicated, correction
	When the extension is not attached, because memory it is destructive, correction
0.04?	When plural selective possible all selection button additions (PocketPC)
	Keyboard shortcut (Ctrl+A) correspondence (HPC)
0.05?	Modification of character string additional deletion processing to text box at time of plural selections
	Deletion of CEF edition

To foam/home

Rollover date: 2004-12-26 QVE00513@nifty.com