ダイアログボックスの使用

[アーティクル]
06/13/2023

ダイアログボックスを使用して情報を表示し、ユーザーからの入力を求めます。アプリケーションは、ダイアログボックスを読み込んで初期化し、ユーザー入力を処理し、ユーザーがタスクを完了するとダイアログボックスを破棄します。ダイアログボックスを処理するプロセスは、ダイアログボックスがモーダルかモードレスかに応じて異なります。モーダルダイアログボックスでは、アプリケーションで別のウィンドウをアクティブ化する前に、ダイアログボックスを閉じる必要があります。ただし、ユーザーはさまざまなアプリケーションでウィンドウをアクティブ化できます。モードレスダイアログボックスでは、ユーザーからの即時応答は必要ありません。コントロールを含むメインウィンドウに似ています。

次のセクションでは、両方の種類のダイアログボックスを使用する方法について説明します。

メッセージボックスの表示
モーダルダイアログボックスの作成
モードレスダイアログボックスの作成
ダイアログボックスの初期化
メモリ内でのテンプレートの作成

メッセージボックスの表示

モーダルダイアログボックスの最も簡単な形式は、メッセージボックスです。ほとんどのアプリケーションでは、メッセージボックスを使用してユーザーにエラーを警告し、エラーが発生した後に続行する方法の指示を求めます。メッセージボックスを作成するには、 MessageBox または MessageBoxEx 関数を使用して、メッセージと表示するボタンの数と種類を指定します。システムは、独自のダイアログボックステンプレートとプロシージャを提供するモーダルダイアログボックスを作成します。ユーザーがメッセージボックスを閉じると、 MessageBox または MessageBoxEx は、メッセージボックスを閉じるユーザーが選択したボタンを識別する値を返します。

次の例では、エラー条件が発生した後にユーザーにアクションを求めるメッセージボックスがアプリケーションに表示されます。メッセージボックスには、エラー条件とその解決方法を説明するメッセージが表示されます。 MB_YESNO スタイルは MessageBox に指示し、ユーザーが続行する方法を選択できる 2 つのボタンを提供します。

int DisplayConfirmSaveAsMessageBox()
{
    int msgboxID = MessageBox(
        NULL,
        L"temp.txt already exists.\nDo you want to replace it?",
        L"Confirm Save As",
        MB_ICONEXCLAMATION | MB_YESNO
    );

    if (msgboxID == IDYES)
    {
        // TODO: add code
    }

    return msgboxID;    
}

次の図は、前のコード例からの出力を示しています。

メッセージボックス

DialogBox 関数を使用してモーダルダイアログボックスを作成します。ダイアログボックステンプレートリソースの識別子または名前と、ダイアログボックスプロシージャへのポインターを指定する必要があります。 DialogBox 関数は、テンプレートを読み込み、ダイアログボックスを表示し、ユーザーがダイアログボックスを閉じるまですべてのユーザー入力を処理します。

次の例では、ユーザーがアプリケーションメニューから [ アイテムの削除 ] をクリックすると、モーダルダイアログボックスが表示されます。ダイアログボックスには、編集コントロール (ユーザーが項目の名前を入力) と [OK] ボタンと [キャンセル] ボタンが含まれています。これらのコントロールのコントロール識別子は、それぞれID_ITEMNAME、IDOK、IDCANCEL です。

この例の最初の部分は、モーダルダイアログボックスを作成するステートメントで構成されています。これらのステートメントは、アプリケーションのメインウィンドウのウィンドウプロシージャで、IDM_DELETEITEM メニュー識別子を持つWM_COMMAND メッセージをシステムが受信したときにダイアログボックスを作成します。この例の 2 番目の部分は、編集コントロールの内容を取得し、 WM_COMMAND メッセージを受信したときにダイアログボックスを閉じるダイアログボックスプロシージャです。

次のステートメントは、モーダルダイアログボックスを作成します。ダイアログボックステンプレートは、アプリケーションの実行可能ファイル内のリソースであり、リソース識別子DLG_DELETEITEM。

case WM_COMMAND: 
    switch (LOWORD(wParam)) 
    { 
        case IDM_DELETEITEM: 
            if (DialogBox(hinst, 
                          MAKEINTRESOURCE(DLG_DELETEITEM), 
                          hwnd, 
                          (DLGPROC)DeleteItemProc)==IDOK) 
            {
                // Complete the command; szItemName contains the 
                // name of the item to delete. 
            }

            else 
            {
                // Cancel the command. 
            } 
            break; 
    } 
    return 0L;

この例では、アプリケーションはダイアログボックスの所有者ウィンドウとしてメインウィンドウを指定します。システムが最初にダイアログボックスを表示すると、その位置は、所有者ウィンドウのクライアント領域の左上隅を基準とします。アプリケーションは DialogBox からの戻り値を使用して、操作を続行するか取り消すかを決定します。次のステートメントは、ダイアログボックスプロシージャを定義します。

char szItemName[80]; // receives name of item to delete. 
 
BOOL CALLBACK DeleteItemProc(HWND hwndDlg, 
                             UINT message, 
                             WPARAM wParam, 
                             LPARAM lParam) 
{ 
    switch (message) 
    { 
        case WM_COMMAND: 
            switch (LOWORD(wParam)) 
            { 
                case IDOK: 
                    if (!GetDlgItemText(hwndDlg, ID_ITEMNAME, szItemName, 80)) 
                         *szItemName=0; 
 
                    // Fall through. 
 
                case IDCANCEL: 
                    EndDialog(hwndDlg, wParam); 
                    return TRUE; 
            } 
    } 
    return FALSE; 
}

この例では、プロシージャは GetDlgItemText を 使用して、ID_ITEMNAMEで識別される編集コントロールから現在のテキストを取得します。次に、 EndDialog 関数を呼び出して、受信したメッセージに応じてダイアログボックスの戻り値を IDOK または IDCANCEL に設定し、ダイアログボックスを閉じるプロセスを開始します。 IDOK 識別子と IDCANCEL 識別子は 、[OK] ボタンと [キャンセル ] ボタンに対応します。プロシージャが EndDialog を呼び出した後、システムはダイアログボックスを破棄する追加のメッセージをプロシージャに送信し、ダイアログボックスの戻り値をダイアログボックスを作成した関数に戻します。

モードレスダイアログボックスの作成

モードレスダイアログボックスを作成するには、 CreateDialog 関数を使用して、ダイアログボックステンプレートリソースの識別子または名前と、ダイアログボックスプロシージャへのポインターを指定します。 CreateDialog は テンプレートを読み込み、ダイアログボックスを作成して、必要に応じて表示します。アプリケーションは、ユーザー入力メッセージを取得してダイアログボックスプロシージャにディスパッチする役割を担います。

次の例では、ユーザーがアプリケーションメニューから [移動 ] をクリックすると、モードレスダイアログボックス (まだ表示されていない場合) が表示されます。ダイアログボックスには、編集コントロール、チェックボックス、および [OK] ボタンと [キャンセル] ボタンが含まれています。ダイアログボックステンプレートは、アプリケーションの実行可能ファイル内のリソースであり、リソース識別子DLG_GOTO。ユーザーは編集コントロールに行番号を入力し、[チェック] ボックスをオンにして、行番号が現在の行を基準にしていることを指定します。コントロール識別子は、ID_LINE、ID_ABSREL、IDOK、IDCANCEL です。

この例の最初の部分のステートメントは、モードレスダイアログボックスを作成します。これらのステートメントは、アプリケーションのメインウィンドウのウィンドウプロシージャで、IDM_GOTO メニュー識別子を持つWM_COMMAND メッセージをウィンドウプロシージャが受信したときにダイアログボックスを作成します。ただし、グローバル変数に有効なハンドルがまだ含まれていない場合に限ります。この例の 2 番目の部分は、アプリケーションのメインメッセージループです。ループには IsDialogMessage 関数が含まれています。これにより、ユーザーはこのモードレスダイアログボックスでダイアログボックスのキーボードインターフェイスを使用できるようになります。この例の 3 番目の部分は、ダイアログボックスプロシージャです。このプロシージャは、ユーザーが [OK] ボタンをクリックしたときに編集コントロールとチェックボックスの内容を取得します。ユーザーが [キャンセル ] ボタンをクリックすると、このプロシージャによってダイアログボックスが破棄されます。

HWND hwndGoto = NULL;  // Window handle of dialog box 
                
...

case WM_COMMAND: 
    switch (LOWORD(wParam)) 
    { 
        case IDM_GOTO: 
            if (!IsWindow(hwndGoto)) 
            { 
                hwndGoto = CreateDialog(hinst, 
                                        MAKEINTRESOURCE(DLG_GOTO), 
                                        hwnd, 
                                        (DLGPROC)GoToProc); 
                ShowWindow(hwndGoto, SW_SHOW); 
            } 
            break; 
    } 
    return 0L;

上記のステートメントでは、有効なウィンドウハンドルが含まれていない場合hwndGotoにのみ CreateDialog が呼び出されます。これにより、アプリケーションで 2 つのダイアログボックスが同時に表示されないようにします。このチェック方法をサポートするには、ダイアログボックスを破棄するときに、ダイアログプロシージャを NULL に設定する必要があります。

アプリケーションのメッセージループは、次のステートメントで構成されます。

BOOL bRet;

while ((bRet = GetMessage(&msg, NULL, 0, 0)) != 0) 
{ 
    if (bRet == -1)
    {
        // Handle the error and possibly exit
    }
    else if (!IsWindow(hwndGoto) || !IsDialogMessage(hwndGoto, &msg)) 
    { 
        TranslateMessage(&msg); 
        DispatchMessage(&msg); 
    } 
}

ループは、ダイアログボックスに対するウィンドウハンドルの有効性をチェックし、ハンドルが有効な場合にのみ IsDialogMessage 関数を呼び出します。 IsDialogMessage は、 メッセージがダイアログボックスに属している場合にのみ処理します。それ以外の場合は FALSE を返し、ループはメッセージを適切なウィンドウにディスパッチします。

次のステートメントは、ダイアログボックスプロシージャを定義します。

int iLine;             // Receives line number.
BOOL fRelative;        // Receives check box status. 
 
BOOL CALLBACK GoToProc(HWND hwndDlg, UINT message, WPARAM wParam, LPARAM lParam) 
{ 
    BOOL fError; 
 
    switch (message) 
    { 
        case WM_INITDIALOG: 
            CheckDlgButton(hwndDlg, ID_ABSREL, fRelative); 
            return TRUE; 
 
        case WM_COMMAND: 
            switch (LOWORD(wParam)) 
            { 
                case IDOK: 
                    fRelative = IsDlgButtonChecked(hwndDlg, ID_ABSREL); 
                    iLine = GetDlgItemInt(hwndDlg, ID_LINE, &fError, fRelative); 
                    if (fError) 
                    { 
                        MessageBox(hwndDlg, SZINVALIDNUMBER, SZGOTOERR, MB_OK); 
                        SendDlgItemMessage(hwndDlg, ID_LINE, EM_SETSEL, 0, -1L); 
                    } 
                    else 

                    // Notify the owner window to carry out the task. 
 
                    return TRUE; 
 
                case IDCANCEL: 
                    DestroyWindow(hwndDlg); 
                    hwndGoto = NULL; 
                    return TRUE; 
            } 
    } 
    return FALSE; 
}

上記のステートメントでは、プロシージャは メッセージのWM_INITDIALOG と WM_COMMAND を処理します。 WM_INITDIALOG処理中に、プロシージャはグローバル変数の現在の値を CheckDlgButton に渡すことによって、チェックボックスを初期化します。その後、プロシージャは TRUE を 返して、既定の入力フォーカスを設定するようにシステムに指示します。

WM_COMMAND処理中に、ユーザーが [キャンセル] ボタン (IDCANCEL 識別子を持つボタン) をクリックした場合にのみ、このプロシージャはダイアログボックスを閉じます。このプロシージャは、モードレスダイアログボックスを閉じるには DestroyWindow を呼び出す必要があります。また、このプロシージャは変数を NULL に設定して、この変数に依存する他のステートメントが正しく動作することを確認します。

ユーザーが [OK] ボタンをクリックすると、プロシージャはチェックボックスの現在の状態を取得し、fRelative 変数に割り当てます。次に、変数を使用して、編集コントロールから行番号を取得します。 GetDlgItemInt は、編集コントロール内のテキストを整数に変換します。 fRelative の値は、関数が数値を符号付き値と符号なし値のどちらとして解釈するかを決定します。編集コントロールのテキストが有効な数値でない場合、 GetDlgItemInt は fError 変数の値を 0 以外に設定します。この手順では、この値をチェックして、エラーメッセージを表示するか、タスクを実行するかを決定します。エラーが発生した場合、ダイアログボックスプロシージャは、ユーザーが簡単に置き換えることができるように、コントロール内のテキストを選択するように指示するメッセージを編集コントロールに送信します。 GetDlgItemInt がエラーを返さない場合、プロシージャは要求されたタスク自体を実行するか、所有者ウィンドウにメッセージを送信して操作を実行するように指示できます。

ダイアログボックスの初期化

WM_INITDIALOG メッセージの処理中に、ダイアログボックスとその内容を初期化します。最も一般的なタスクは、現在のダイアログボックスの設定を反映するようにコントロールを初期化することです。もう 1 つの一般的なタスクは、画面またはその所有者ウィンドウ内でダイアログボックスを中央に配置することです。一部のダイアログボックスで便利なタスクは、既定の入力フォーカスを受け入れるのではなく、指定したコントロールに入力フォーカスを設定することです。

次の例では、ダイアログボックスプロシージャがダイアログボックスの中央に移動し、 WM_INITDIALOG メッセージの処理中に入力フォーカスを設定します。ダイアログボックスを中央に配置するために、プロシージャはダイアログボックスと所有者ウィンドウのウィンドウの四角形を取得し、ダイアログボックスの新しい位置を計算します。入力フォーカスを設定するために、プロシージャは wParam パラメーターをチェックして、既定の入力フォーカスの識別子を決定します。

HWND hwndOwner; 
RECT rc, rcDlg, rcOwner; 

....
 
case WM_INITDIALOG: 

    // Get the owner window and dialog box rectangles. 

    if ((hwndOwner = GetParent(hwndDlg)) == NULL) 
    {
        hwndOwner = GetDesktopWindow(); 
    }

    GetWindowRect(hwndOwner, &rcOwner); 
    GetWindowRect(hwndDlg, &rcDlg); 
    CopyRect(&rc, &rcOwner); 

    // Offset the owner and dialog box rectangles so that right and bottom 
    // values represent the width and height, and then offset the owner again 
    // to discard space taken up by the dialog box. 

    OffsetRect(&rcDlg, -rcDlg.left, -rcDlg.top); 
    OffsetRect(&rc, -rc.left, -rc.top); 
    OffsetRect(&rc, -rcDlg.right, -rcDlg.bottom); 

    // The new position is the sum of half the remaining space and the owner's 
    // original position. 

    SetWindowPos(hwndDlg, 
                 HWND_TOP, 
                 rcOwner.left + (rc.right / 2), 
                 rcOwner.top + (rc.bottom / 2), 
                 0, 0,          // Ignores size arguments. 
                 SWP_NOSIZE); 

    if (GetDlgCtrlID((HWND) wParam) != ID_ITEMNAME) 
    { 
        SetFocus(GetDlgItem(hwndDlg, ID_ITEMNAME)); 
        return FALSE; 
    } 
    return TRUE;

上記のステートメントでは、プロシージャは GetParent 関数を使用して、ダイアログボックスへの所有者ウィンドウハンドルを取得します。関数は、ダイアログボックスに所有者ウィンドウハンドルを返し、親ウィンドウハンドルを子ウィンドウに返します。アプリケーションは所有者のないダイアログボックスを作成できるため、プロシージャは返されたハンドルをチェックし、必要に応じて GetDesktopWindow 関数を使用してデスクトップウィンドウハンドルを取得します。新しい位置を計算した後、プロシージャは SetWindowPos 関数を使用してダイアログボックスを移動し、HWND_TOP値を指定して、ダイアログボックスが所有者ウィンドウの上に残っていることを確認します。

入力フォーカスを設定する前に、プロシージャは既定の入力フォーカスのコントロール識別子を確認します。システムは 、wParam パラメーターで既定の入力フォーカスのウィンドウハンドルを渡します。 GetDlgCtrlID 関数は、ウィンドウハンドルによって識別されるコントロールの識別子を返します。識別子が正しい識別子と一致しない場合、プロシージャは SetFocus 関数を使用して入力フォーカスを設定します。目的のコントロールのウィンドウハンドルを取得するには、 GetDlgItem 関数が必要です。

メモリ内でのテンプレートの作成

アプリケーションは、処理されているデータの現在の状態に応じて、ダイアログボックスの内容を調整または変更することがあります。このような場合、使用可能なすべてのダイアログボックステンプレートをアプリケーションの実行可能ファイル内のリソースとして提供することは実用的ではありません。ただし、メモリ内にテンプレートを作成すると、アプリケーションはあらゆる状況に適応する柔軟性が高くなります。

次の例では、メッセージと [OK] ボタンと [ヘルプ ] ボタンを含むモーダルダイアログボックスのテンプレートがメモリ内に作成されます。

ダイアログテンプレートでは、ダイアログボックスやボタンのタイトルなど、すべての文字列が Unicode 文字列である必要があります。この例では、 MultiByteToWideChar 関数を使用して、これらの Unicode 文字列を生成します。

ダイアログテンプレート内の DLGITEMTEMPLATE 構造体は 、DWORD 境界に配置する必要があります。これらの構造体を配置するために、この例では、入力ポインターを受け取り、 DWORD 境界に配置されている最も近いポインターを返すヘルパールーチンを使用します。

#define ID_HELP   150
#define ID_TEXT   200

LPWORD lpwAlign(LPWORD lpIn)
{
    ULONG ul;

    ul = (ULONG)lpIn;
    ul ++;
    ul >>=1;
    ul <<=1;
    return (LPWORD)ul;
}

LRESULT DisplayMyMessage(HINSTANCE hinst, HWND hwndOwner, LPSTR lpszMessage)
{
    HGLOBAL hgbl;
    LPDLGTEMPLATE lpdt;
    LPDLGITEMTEMPLATE lpdit;
    LPWORD lpw;
    LPWSTR lpwsz;
    LRESULT ret;
    int nchar;

    hgbl = GlobalAlloc(GMEM_ZEROINIT, 1024);
    if (!hgbl)
        return -1;
 
    lpdt = (LPDLGTEMPLATE)GlobalLock(hgbl);
 
    // Define a dialog box.
 
    lpdt->style = WS_POPUP | WS_BORDER | WS_SYSMENU | DS_MODALFRAME | WS_CAPTION;
    lpdt->cdit = 3;         // Number of controls
    lpdt->x  = 10;  lpdt->y  = 10;
    lpdt->cx = 100; lpdt->cy = 100;

    lpw = (LPWORD)(lpdt + 1);
    *lpw++ = 0;             // No menu
    *lpw++ = 0;             // Predefined dialog box class (by default)

    lpwsz = (LPWSTR)lpw;
    nchar = 1 + MultiByteToWideChar(CP_ACP, 0, "My Dialog", -1, lpwsz, 50);
    lpw += nchar;

    //-----------------------
    // Define an OK button.
    //-----------------------
    lpw = lpwAlign(lpw);    // Align DLGITEMTEMPLATE on DWORD boundary
    lpdit = (LPDLGITEMTEMPLATE)lpw;
    lpdit->x  = 10; lpdit->y  = 70;
    lpdit->cx = 80; lpdit->cy = 20;
    lpdit->id = IDOK;       // OK button identifier
    lpdit->style = WS_CHILD | WS_VISIBLE | BS_DEFPUSHBUTTON;

    lpw = (LPWORD)(lpdit + 1);
    *lpw++ = 0xFFFF;
    *lpw++ = 0x0080;        // Button class

    lpwsz = (LPWSTR)lpw;
    nchar = 1 + MultiByteToWideChar(CP_ACP, 0, "OK", -1, lpwsz, 50);
    lpw += nchar;
    *lpw++ = 0;             // No creation data

    //-----------------------
    // Define a Help button.
    //-----------------------
    lpw = lpwAlign(lpw);    // Align DLGITEMTEMPLATE on DWORD boundary
    lpdit = (LPDLGITEMTEMPLATE)lpw;
    lpdit->x  = 55; lpdit->y  = 10;
    lpdit->cx = 40; lpdit->cy = 20;
    lpdit->id = ID_HELP;    // Help button identifier
    lpdit->style = WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON;

    lpw = (LPWORD)(lpdit + 1);
    *lpw++ = 0xFFFF;
    *lpw++ = 0x0080;        // Button class atom

    lpwsz = (LPWSTR)lpw;
    nchar = 1 + MultiByteToWideChar(CP_ACP, 0, "Help", -1, lpwsz, 50);
    lpw += nchar;
    *lpw++ = 0;             // No creation data

    //-----------------------
    // Define a static text control.
    //-----------------------
    lpw = lpwAlign(lpw);    // Align DLGITEMTEMPLATE on DWORD boundary
    lpdit = (LPDLGITEMTEMPLATE)lpw;
    lpdit->x  = 10; lpdit->y  = 10;
    lpdit->cx = 40; lpdit->cy = 20;
    lpdit->id = ID_TEXT;    // Text identifier
    lpdit->style = WS_CHILD | WS_VISIBLE | SS_LEFT;

    lpw = (LPWORD)(lpdit + 1);
    *lpw++ = 0xFFFF;
    *lpw++ = 0x0082;        // Static class

    for (lpwsz = (LPWSTR)lpw; *lpwsz++ = (WCHAR)*lpszMessage++;);
    lpw = (LPWORD)lpwsz;
    *lpw++ = 0;             // No creation data

    GlobalUnlock(hgbl); 
    ret = DialogBoxIndirect(hinst, 
                           (LPDLGTEMPLATE)hgbl, 
                           hwndOwner, 
                           (DLGPROC)DialogProc); 
    GlobalFree(hgbl); 
    return ret; 
}

次の方法で共有

ダイアログボックスの使用

メッセージボックスの表示

モードレスダイアログボックスの作成

ダイアログボックスの初期化

メモリ内でのテンプレートの作成

フィードバック

その他のリソース

次の方法で共有

ダイアログ ボックスの使用

メッセージ ボックスの表示

モーダル ダイアログ ボックスの作成

モードレス ダイアログ ボックスの作成

ダイアログ ボックスの初期化

メモリ内でのテンプレートの作成

フィードバック

その他のリソース

ダイアログボックスの使用

メッセージボックスの表示

モーダルダイアログボックスの作成

モードレスダイアログボックスの作成

ダイアログボックスの初期化