Visual C++ 2005 または Visual C++ .NET を使用して、ユーザーとアプリケーションのデータを適切な場所に格納する Windows XP アプリケーションを記述する方法

• Win32 アプリケーションを作成します。
• [ファイル] メニューに [名前を付けて保存] オプションを追加します。
• 標準の [上書き保存] ダイアログ ボックスを使用して適切な場所をデフォルトの場所にします。
• 適切なファイルの保存場所を指定します。
• ユーザーの前回の選択内容を記憶します。
• ユーザーの前回の選択内容を確認します。

• アプリケーション データを分類します。
• アプリケーション データを適切な場所に格納します。
• レジストリを適切に使用します。

先頭へ戻る

必要条件

• Windows XP Home Edition または Windows XP Professional
• Visual Studio 2005、Visual Studio .NET、または Visual Studio 6.0
• Win32 アプリケーション開発に関する予備知識

先頭へ戻る

Win32 アプリケーションを作成する

• Visual C++ 6.0 では、使用可能なプロジェクトの種類の一覧から [Win32 Application] をクリックして、アプリケーションの設定ウィザードで [標準的な "Hello World" アプリケーション] をクリックします。
• Visual Studio .NET では、[プロジェクトの種類] ボックスの一覧の [Visual C++ プロジェクト] をクリックし、[テンプレート] ボックスの一覧の [Win32 プロジェクト] をクリックします。アプリケーションの設定ウィザードで表示されるアプリケーションのデフォルトの設定をそのまま使用します。
• Visual Studio 2005 では、[プロジェクトの種類] ボックスの一覧の [Visual C++] をクリックし、[テンプレート] ボックスの一覧の [Win32 プロジェクト] をクリックします。アプリケーションのデフォルトの設定をそのまま使用します。

先頭へ戻る

[名前を付けて保存] オプションを [ファイル] メニューに追加する

1. [リソース ビュー] をクリックし、[Menu] フォルダにある [IDC_SAVINGDATA] をダブルクリックします。
2. メニューの [名前を付けて保存] オプションを [ファイル] メニューに追加します。メニュー項目の ID として IDM_FILE_SAVEAS を使用します。
3. SavingData.cpp の内部のアプリケーションの WndProc ウィンドウ プロシージャを探し、WM_COMMAND セクション内部に新しい case ステートメントを追加して、[名前を付けて保存] メニュー オプションを処理します。次のセクションで作成する OnFileSaveAs 関数を呼び出します。この関数はパラメータを受け取りません。
   
   コードは以下のようになります。

   case WM_COMMAND:
      wmId    = LOWORD(wParam); 
      wmEvent = HIWORD(wParam); 
      // Parse the menu selections.
      switch (wmId)
      {
      case IDM_ABOUT:
         DialogBox(hInst, (LPCTSTR)IDD_ABOUTBOX, hWnd, (DLGPROC)About);
         break;
      case IDM_EXIT:
         DestroyWindow(hWnd);
         break;
      case IDM_FILE_SAVEAS:
         OnFileSaveAs();
         break;
      default:
         return DefWindowProc(hWnd, message, wParam, lParam);
      }
      break;
   					

先頭へ戻る

標準の [上書き保存] ダイアログ ボックスを使用して、適切な場所をデフォルトの場所にする

1. SavingData.cpp の先頭に、以下の include ステートメントを追加します。

   #include <commdlg.h>   // for GetSaveFileName
   #include <shlobj.h>    // for SHGetFolderPath
   					

2. 次の OnFileSaveAs 関数のプロトタイプを追加します。

   void OnFileSaveAs();
   					

3. 新しい OnFileSaveAs 関数を作成します。この関数の内部で、CSIDL_MYPICTURES という CSIDL 識別子と共に SHGetFolderPath 関数を使用すると、適切なフォルダの場所を取得して、画像データを格納します。このフォルダの場所を GetSaveFileName 関数に渡して、標準の [上書き保存] ダイアログ ボックスを表示します。
   
   コードは以下のようになります。

   void OnFileSaveAs()
   {
      OPENFILENAME openFile;
      TCHAR szPath[MAX_PATH];
   
   // Initialize OPENFILENAME structure.
   ZeroMemory( &openFile, sizeof(OPENFILENAME) );
   openFile.lStructSize = sizeof(OPENFILENAME);
   // Default to My Pictures. First, get its path.
   if ( SUCCEEDED( SHGetFolderPath( NULL, CSIDL_MYPICTURES, 
                                         NULL, 0, szPath ) ) )
   {
      // Set lpstrInitialDir to the path that SHGetFolderPath obtains. 
      // This causes GetSaveFileName to point to the My Pictures folder.
         openFile.lpstrInitialDir = szPath;
   }
   // Display the standard File Save dialog box, defaulting to My Pictures.
   if ( GetSaveFileName( &openFile ) == TRUE )
   {
         // User clicks the Save button.
      // Save the file
   }
   else
   {
      // User cancels the File Save dialog box.
   }
   }
   					

先頭へ戻る

適切なファイルの保存場所を確認する

1. F5 キーを押して、プロジェクトをビルドします。
2. アプリケーションを実行して、[ファイル] メニューの [名前を付けて保存] をクリックします。
3. CSIDL_MYPICTURES で指定されたとおりに、標準の [上書き保存] ダイアログ ボックスのデフォルトの場所がマイ ピクチャ フォルダになっていることを確認します。
4. [キャンセル] をクリックして、ダイアログ ボックスを閉じ、アプリケーションを終了します。

先頭へ戻る

ユーザーの前回の選択内容を記憶する

1. OnFileSaveAs 関数に bFirstSave という名前のブール型の静的変数を作成し、その変数を TRUE に初期化します。
2. OnFileSaveAs 内部のコードを変更して、bFirstSave が TRUE の場合のみ、SHGetFolderPath を呼び出し、OPENFILENAME 構造体の lpstrInitialDir メンバを設定します。
3. ユーザーが [上書き保存] ダイアログ ボックスで [保存] をクリックした場合に、bFirstSave を FALSE に設定します。
   
   コードは以下のようになります。

   void OnFileSaveAs()
   {
      OPENFILENAME openFile;
      TCHAR szPath[MAX_PATH];
      static BOOL bFirstSave = TRUE;
   
   // Initialize OPENFILENAME structure.
   ZeroMemory( &openFile, sizeof(OPENFILENAME) );
   openFile.lStructSize = sizeof(OPENFILENAME);
   // The first time the user saves a document, default to My Pictures.
      if ( TRUE == bFirstSave )
   {
      if ( SUCCEEDED( SHGetFolderPath( NULL, CSIDL_MYPICTURES, 
                                            NULL, 0, szPath ) ) )
      {
            // Set lpstrInitialDir to the path that SHGetFolderPath obtains.
            // This causes GetSaveFileName to point to the My Pictures folder.
            openFile.lpstrInitialDir = szPath;
      }
   }
   // Display standard File Save dialog box, defaulting to My Pictures
   // or the user's previously selected location.
   if ( GetSaveFileName( &openFile ) == TRUE )
   {
      // User clicks Save.
      // Save the file.
         bFirstSave = FALSE;
   }
   else
   {
         // User cancels the File Save dialog box.
   }
   }
   					

先頭へ戻る

ユーザーの前回の選択内容を確認する

1. プロジェクトをビルドして、アプリケーションを実行します。
2. [ファイル] メニューの [名前を付けて保存] をクリックします。
3. マイ ピクチャ フォルダからマイ ドキュメント フォルダを参照し、ファイルを選択して、[保存] をクリックします。
4. 再度、[ファイル] メニューの [名前を付けて保存] をクリックします。
5. ダイアログ ボックスで前回の選択内容がデフォルトになっていること (この場合、マイ ドキュメントを指すこと) を確認します。
6. [キャンセル] をクリックしてダイアログ ボックスを閉じ、アプリケーションを終了します。
7. アプリケーションを実行して、[ファイル] メニューの [名前を付けて保存] をクリックします。
8. ダイアログ ボックスでマイ ピクチャ フォルダがデフォルトの場所に戻っていることを確認します。
9. ダイアログ ボックスを閉じて、アプリケーションを終了します。

先頭へ戻る

アプリケーション データを分類する

• ユーザーごとのデータ (移動する) : このカテゴリは、特定のユーザー固有のアプリケーション データを示し、ドメイン内のコンピュータ間で移動するユーザーから使用できます (ユーザー辞書など)。この設定は、ドメイン環境で実行するように設定されていないアプリケーションには適用されないことに注意してください。
• ユーザーごとのデータ (移動しない) : このカテゴリは、特定のユーザー固有のアプリケーション データを示しますが、1 台のコンピュータのみに適用されます (ユーザー指定のモニタ解像度など)。
• コンピュータごとのデータ (ユーザー固有ではなく、移動しない) : このカテゴリは、すべてのユーザーと特定のコンピュータに適用されるアプリケーション データを示しています (アプリケーション辞書、ログ ファイル、一時ファイルなど)。

先頭へ戻る

アプリケーション データを適切な場所に格納する

• 「ユーザーごとのデータ (移動する)」のデータは、CSIDL_APPDATA 値を使用します。これは、デフォルトでは次のパスになります。
  \Documents and Settings\<User Name>\Application Data
• 「ユーザーごとのデータ (移動なし)」のデータは、CSIDL_LOCAL_APPDATA 値を使用します。これは、デフォルトでは次のパスになります。
  \Documents and Settings\<User Name>\Local Settings\Application Data
• 「コンピュータごとのデータ (ユーザー固有ではなく、移動しない)」のデータは、CSIDL_COMMON_APPDATA 値を使用します。これは、デフォルトでは次のパスになります。
  \Documents and Settings\All Users\Application Data

void CreateTemporaryFile()
{
   TCHAR szPath[MAX_PATH];
   // Get path for each computer, non-user specific and non-roaming data.
   if ( SUCCEEDED( SHGetFolderPath( NULL, CSIDL_COMMON_APPDATA, 
                                    NULL, 0, szPath ) ) )
   {
      TCHAR szTempFileName[MAX_PATH];
      // Append product-specific path.
      PathAppend( szPath, "\\My Company\\My Product\\1.0\\" );
      // Generate a temporary file name within this folder.
      if (GetTempFileName( szPath, 
                           "PRE",
                           0,
                           szTempFileName ) != 0 )
      {
         HANDLE hFile = NULL;
         // Open the file.
         if (( hFile = CreateFile( szTempFileName, 
                                     GENERIC_WRITE, 
                                     0, 
                                   NULL, 
                                   CREATE_ALWAYS, 
                                   FILE_ATTRIBUTE_NORMAL, 
                                   NULL )) != INVALID_HANDLE_VALUE )
         {
            // Write temporary data (code omitted).
            CloseHandle( hFile );
         }
      }
   }
}
				

先頭へ戻る

レジストリを適切に使用する

• 少量のユーザー データの場合は、HKEY_CURRENT_USER (HKCU) レジストリ キーを使用します。
• 少量のコンピュータ データの場合は、HKEY_LOCAL_MACHINE (HKLM) レジストリ キーを使用します。デフォルトでは、管理者以外のユーザーには HKLM ツリーに読み取り専用のアクセス許可しかないため、アプリケーションは実行時に HKLM に書き込むべきではありません。
• アプリケーションのインストール時に、HKCU と HKLM 全体で合計 128 KB 以上を格納してはいけません。
• コンポーネント オブジェクト モデル (COM) コンポーネントは HKEY_CLASSES_ROOT (HKCR) レジストリ キーに登録されます。最大値 128 KB には、HKCR は含まれません。
• HKLM または HKCU に書き込むとき、会社名、製品名、および製品のバージョン番号を次のように作成する必要があります。
  HKLM\Software\Company Name\Product Name\Product Version
  HKCU\Software\Company Name\Product Name\Product Version
• (RegCreateKeyEx や RegSetValueEx などの) レジストリ関数を使用して、レジストリ エントリの読み取りと書き込みを行います。

先頭へ戻る

トラブルシューティング

• Windows XP 以外に、旧バージョンの Windows でアプリケーションを実行できるようにするには、常に Shfolder.dll の SHGetFolderPath にリンクします。Windows XP は Shell32.dll の SHGetFolderPath を持っていますが、旧バージョンの Windows の中にはこのダイナミック リンク ライブラリ (DLL) 内部の関数をサポートしないものがあります。
• Shfolder.dll は再配布可能なコンポーネントなので、アプリケーションと共に配布できます。
• 長期間アプリケーションを使用している間に、ユーザーまたは管理者がマイ ドキュメント フォルダを再配置する可能性があるため、最近使用したファイルの一覧など、アプリケーション固有の場所にあるマイ ドキュメント フォルダ (またはその他のシステム フォルダ) へのフルパスを保存しないでください。

先頭へ戻る