共通ダイアログ ボックス ライブラリ
- [アーティクル]
-
-
共通ダイアログ ボックス ライブラリには、ファイルの開き方、色の値の選択、ドキュメントの印刷など、一般的なアプリケーション タスクを実行するための一連のダイアログ ボックスが含まれています。 共通のダイアログ ボックスを使用すると、アプリケーションのユーザー インターフェイスに一貫したアプローチを実装できます。 これにより、ユーザーがアプリケーションのユーザー インターフェイスの動作を学習するために費やす労力が減ります。
このセクションでは、[ ファイルを開く ] ダイアログ ボックスと [ ファイルとして保存 ] ダイアログ ボックスを含む一般的なダイアログ ボックスについて説明します。[ 検索 と 置換 ] 編集ダイアログ ボックス。 [印刷]、[ 印刷設定]、[ プロパティ シートの印刷]、[ ページ設定] の各印刷ダイアログ ボックス。および [ 色 ] ダイアログ ボックスと [フォント] ダイアログ ボックス。
注意
Windows Vista 以降では、[ 開く ] ダイアログ ボックスと [ 名前を付けて保存] ダイアログ ボックスが [ 共通項目] ダイアログボックスに置き換えられます。 共通ダイアログ ボックス ライブラリのダイアログ ボックスではなく、共通項目ダイアログ API を使用することをお勧めします。
このセクションの内容
関数
Name |
説明 |
CCHookProc |
[色] ダイアログ ボックスの既定のダイアログ ボックス プロシージャを対象としたメッセージまたは通知を受信します。 これは、 ChooseColor 関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数です。
|
CFHookProc |
[フォント] ダイアログ ボックスの既定のダイアログ ボックス プロシージャを対象としたメッセージまたは通知を受信します。 これは、 ChooseFont 関数で使用されるアプリケーション定義またはライブラリ定義のコールバック プロシージャです。
|
ChooseColor |
ユーザーが 色 を選択できるようにする [色] ダイアログ ボックスを作成します。
|
ChooseFont |
ユーザーが論理フォントの属性を選択できるようにする [ フォント ] ダイアログ ボックスを作成します。 これらの属性には、フォント ファミリと関連するフォント スタイル、ポイント サイズ、効果 (下線、取り消し線、テキストの色)、スクリプト (または文字セット) が含まれます。
|
CommDlgExtendedError |
ダイアログ ボックスの一般的なエラー コードを返します。 このコードは、一般的なダイアログ ボックス関数の 1 つの実行中に発生する最新のエラーを示します。
|
Findtext |
ユーザーが検索する文字列と、ドキュメント内のテキストを検索するときに使用するオプションを指定できる、システム定義の モードレス検索 ダイアログ ボックスを作成します。
|
FRHookProc |
[ 検索 または 置換 ] ダイアログ ボックスの既定のダイアログ ボックス プロシージャを対象としたメッセージまたは通知を受信します。 これは、 FindText 関数または ReplaceText 関数で使用される、アプリケーション定義またはライブラリ定義のコールバック関数です。
|
GetFileTitle |
指定したファイルの名前を取得します。
|
GetOpenFileName |
ユーザーが開くファイルまたはファイルのセットのドライブ、ディレクトリ、名前を指定できる [ 開 く] ダイアログ ボックスを作成します。
|
GetSaveFileName |
ユーザーが 保存 するファイルのドライブ、ディレクトリ、名前を指定できる [保存] ダイアログ ボックスを作成します。
|
OFNHookProc |
ダイアログ ボックスから送信された通知メッセージを受信します。 関数は、子ダイアログ テンプレートを指定して定義した追加のコントロールのメッセージも受け取ります。 これは、エクスプローラー スタイルの [開く] ダイアログ ボックスと [名前を付けて保存] ダイアログ ボックスで使用される、アプリケーション定義またはライブラリ定義のコールバック関数です。
|
OFNHookProcOldStyle |
ダイアログ ボックス の手順を目的としたメッセージまたは通知を受信します。 これは、[ 開く ] ダイアログ ボックスと [ 名前を付けて保存] ダイアログ ボックスで使用される、アプリケーション定義またはライブラリ定義のコールバック関数です。
|
PagePaintHook |
[ ページ設定] ダイアログ ボックスでサンプル ページの描画をカスタマイズできるメッセージを受信します。 これは、 PageSetupDlg 関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数です。
|
PageSetupDlg |
ユーザーが印刷ページの属性を指定できるようにする [ページ 設定 ] ダイアログ ボックスを作成します。 これらの属性には、用紙のサイズとソース、ページの向き (縦または横)、ページの余白の幅が含まれます。
|
PageSetupHook |
[ページ設定] ダイアログ ボックスの既定のダイアログ ボックス プロシージャを対象としたメッセージまたは通知を受信します。 これは、PageSetupDlg関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数です。
|
PrintDlg |
[印刷] ダイアログ ボックスを表示します。 [ 印刷 ] ダイアログ ボックスを使用すると、ユーザーは特定の印刷ジョブのプロパティを指定できます。
|
PrintDlgEx |
ユーザーが特定の印刷ジョブのプロパティを指定できるようにする Print プロパティ シートを表示します。Printプロパティ シートには、[印刷] ダイアログ ボックスのようなコントロールを含む [全般] ページがあります。 プロパティ シートには、アプリケーション固有およびドライバー固有の追加のプロパティ ページ、および [全般 ] ページを含めることもできます。
|
PrintHookProc |
[印刷] ダイアログ ボックスの既定のダイアログ ボックス プロシージャを対象としたメッセージまたは通知を受信します。 これは、 PrintDlg 関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数です。
|
ReplaceText |
検索する文字列と置換文字列、および検索および置換操作を制御するオプションをユーザーが指定できるシステム定義のモードレス ダイアログ ボックスを作成します。
|
SetupHookProc |
PrintDlg 関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数。 フック プロシージャは、[ 印刷設定] ダイアログ ボックスの既定のダイアログ ボックス プロシージャを対象としたメッセージまたは通知を受け取ります。
|
インターフェイス
メッセージ
名前 |
説明 |
CDM_GETFILEPATH |
エクスプローラー スタイルの [名前を付けて開く] ダイアログ ボックスまたは [名前を付けて保存] ダイアログ ボックスで、選択したファイルのパスとファイル名を取得します。 ダイアログ ボックスは、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
CDM_GETFOLDERIDLIST |
エクスプローラー スタイルの [開く] ダイアログ ボックスまたは [名前を付けて保存] ダイアログ ボックスが現在開いているフォルダーに対応するアイテム識別子リストのアドレスを取得します。 ダイアログ ボックスは 、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
CDM_GETFOLDERPATH |
エクスプローラー スタイルの [開く] または [名前を付けて保存] ダイアログ ボックスの現在開いているフォルダーまたはディレクトリのパスを取得します。 ダイアログ ボックスは 、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
CDM_GETSPEC |
エクスプローラー スタイルの [名前を付けて開く] または [名前を付けて保存] ダイアログ ボックスで現在選択されているファイルのファイル名 (パスを含まない) を取得します。 ダイアログ ボックスは 、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
CDM_HIDECONTROL |
エクスプローラー スタイルの [開く] ダイアログ ボックスまたは [名前を付けて保存] ダイアログ ボックスで、指定したコントロールを非表示にします。 ダイアログ ボックスは 、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
CDM_SETCONTROLTEXT |
エクスプローラー スタイルの [開く] ダイアログ ボックスまたは [名前を付けて保存] ダイアログ ボックスで、指定したコントロールのテキストを設定します。 ダイアログ ボックスは 、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
CDM_SETDEFEXT |
エクスプローラー スタイルの [開く] または [名前を付けて保存] ダイアログ ボックスの既定のファイル名拡張子を設定します。 ダイアログ ボックスは 、OFN_EXPLORER フラグを使用して作成されている必要があります。それ以外の場合、メッセージは失敗します。
|
SETRGBSTRING |
[色] ダイアログ ボックスのフック プロシージャ CCHookProc は、SETRGBSTRING 登録済みメッセージをダイアログ ボックスに送信して、現在の色の選択を設定できます。
|
WM_CHOOSEFONT_GETLOGFONT |
アプリケーションは 、WM_CHOOSEFONT_GETLOGFONT メッセージを [フォント ] ダイアログ ボックスに送信して、ユーザーの現在のフォント選択に関する情報を取得します。
|
WM_CHOOSEFONT_SETFLAGS |
アプリケーションは、 WM_CHOOSEFONT_SETFLAGS メッセージを [ フォント ] ダイアログ ボックスに送信して、ダイアログ ボックスの表示オプションを設定します。
|
WM_CHOOSEFONT_SETLOGFONT |
アプリケーションは 、WM_CHOOSEFONT_SETLOGFONT メッセージを [ フォント ] ダイアログ ボックスに送信して、現在の論理フォント情報を設定します。
|
通知
Name |
説明 |
CDN_FILEOK |
ユーザーがファイル名を指定して [OK] ボタンをクリックしたときに、エクスプローラースタイルの [開く] または [名前を付けて保存] ダイアログ ボックスによって送信されます。
|
CDN_FOLDERCHANGE |
新しいフォルダーを開いたときに、エクスプローラー スタイルの [開く] または [名前を付けて保存] ダイアログ ボックスによって送信されます。
|
CDN_HELP |
ユーザーが [ヘルプ] ボタンをクリックしたときに、エクスプローラースタイルの [開く] または [名前を付けて保存] ダイアログ ボックスによって送信されます。
|
CDN_INCLUDEITEM |
[ 開く ] または [ 名前を付けて保存] ダイアログ ボックスによって送信され、ダイアログ ボックスでシェル フォルダーのアイテム リストにアイテムを表示するかどうかを決定します。 ユーザーがフォルダーを開くと、ダイアログ ボックスはフォルダー内の各項目 に対してCDN_INCLUDEITEM 通知を送信します。 ダイアログ ボックスは、ダイアログ ボックスの作成時に OFN_ENABLEINCLUDENOTIFY フラグが設定された場合にのみ、この通知を送信します。
|
CDN_INITDONE |
エクスプローラースタイルの [開く] ダイアログ ボックスまたは [名前を付けて保存] ダイアログ ボックスで、コントロールの配置が完了したときに送信されます。 標準コントロールが移動され、子ダイアログ ボックスのコントロール用のスペースが作成されます。
|
CDN_SELCHANGE |
現在開いているフォルダーまたはディレクトリの内容を表示するリスト ボックスで選択内容が変更されたときに、エクスプローラー スタイルの [開く] または [名前を付けて保存] ダイアログ ボックスによって送信されます。
|
CDN_SHAREVIOLATION |
ユーザーが [OK] ボタンをクリックし、選択したファイルに対してネットワーク共有違反が発生したときに、エクスプローラー スタイルの [開く] または [名前を付けて保存] ダイアログ ボックスによって送信されます。
|
CDN_TYPECHANGE |
ユーザーが [ファイルの種類] コンボ ボックスから新しいファイルの種類を選択したときに、エクスプローラー スタイルの [開く] または [名前を付けて保存] ダイアログ ボックスによって送信されます。
|
COLOROKSTRING |
[色] ダイアログ ボックスは、ユーザーが色を選択して [OK] ボタンをクリックすると、COLOROKSTRING 登録済みメッセージをフック プロシージャ CCHookProc に送信します。 フック プロシージャは、色を受け入れてダイアログ ボックスを閉じるか、色を拒否してダイアログ ボックスを強制的に開いたままにすることができます。
|
FILEOKSTRING |
[名前を付けて開く] または [名前を付けて保存] ダイアログ ボックスでは、ユーザーがファイル名を指定して [OK] ボタンをクリックすると、FILEOKSTRING 登録済みメッセージがフック プロシージャ OFNHookProc に送信されます。 フック プロシージャは、ファイル名を受け入れ、ダイアログ ボックスを閉じるか、ファイル名を拒否して、ダイアログ ボックスを強制的に開いたままにすることができます。
|
FINDMSGSTRING |
[検索または置換] ダイアログ ボックスは、ユーザーが [次の検索]、[置換]、または [すべて置換] ボタンをクリックするか、ダイアログ ボックスを閉じると、FINDMSGSTRING 登録済みメッセージを所有者ウィンドウのウィンドウ プロシージャに送信します。
|
HELPMSGSTRING |
共通ダイアログ ボックスは、ユーザーが [ヘルプ] ボタンをクリックすると、HELPMSGSTRING 登録済みメッセージを所有者ウィンドウのウィンドウ プロシージャに送信します。
|
LBSELCHSTRING |
[ 名前を付けて開く ] または [ 名前を付けて保存 ] ダイアログ ボックスは、ダイアログ ボックスのリスト ボックスまたはコンボ ボックスで選択内容が変更されたときに 、LBSELCHSTRING 登録済みメッセージをフック プロシージャに送信します。
|
SHAREVISTRING |
[開く] または [名前を付けて保存] ダイアログ ボックスは、ユーザーが [OK] ボタンをクリックしたときに選択したファイルに対して共有違反が発生した場合に、SHAREVISTRING 登録済みメッセージをフック プロシージャ OFNHookProc に送信します。
|
WM_PSD_ENVSTAMPRECT |
ページ 設定 ダイアログ ボックス PagePaintHook のフック プロシージャに、ダイアログ ボックスがサンプル ページの封筒スタンプ四角形を描画しようとしていることを通知します。
|
WM_PSD_FULLPAGERECT |
[ページ設定] ダイアログ ボックスのサンプル ページ四角形の座標を PagePaintHook フック プロシージャに通知します。 このダイアログ ボックスは、サンプル ページの内容を描画するときにこのメッセージを送信します。
|
WM_PSD_GREEKTEXTRECT |
ダイアログ ボックスがサンプル ページの余白の四角形内にギリシャ語のテキストを描画しようとしていることを、PagePaintHook ダイアログ ボックスのフック プロシージャに通知します。
|
WM_PSD_MARGINRECT |
ページ 設定 ダイアログ ボックス PagePaintHook のフック プロシージャに、ダイアログ ボックスがサンプル ページの余白の四角形を描画しようとしていることを通知します。
|
WM_PSD_MINMARGINRECT |
サンプル ページの余白の四角形の座標を PagePaintHook フック プロシージャに通知します。 サンプル ページの内容を描画するときに、このメッセージが [ページ 設定] ダイアログ ボックスから送信されます。
|
WM_PSD_PAGESETUPDLG |
[ページ設定] ダイアログ ボックスがサンプル ページの内容を描画しようとしていることを PagePaintHook フック プロシージャに通知します。 フック プロシージャは、このメッセージを使用して、サンプル ページの内容の描画に関連する初期化タスクを実行できます。
|
WM_PSD_YAFULLPAGERECT |
ダイアログ ボックスが封筒のサンプル ページの差出人住所 部分を描画 しようとしていることを、 PagePaintHook ダイアログ ボックスのフック プロシージャに通知します。
|
構造