On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

Creating a Modeless Dialog Box

You create a modeless dialog box by using the CreateDialog function, specifying the identifier or name of a dialog box template resource and the address of the dialog box procedure. CreateDialog loads the template, creates the dialog box, and optionally displays it. Your application is responsible for retrieving and dispatching user input messages to the dialog box procedure.

In the following example, the application displays a modeless dialog box ѕ if it is not already displayed ѕ when the user chooses a Go To command from an application menu. The dialog box contains an edit control, a check box, and OK and Cancel buttons. The dialog box template is a resource in the application's executable file and has the resource identifier DLG_GOTO. The user enters a line number in the edit control and checks the check box to specify that the line number is relative to the current line. The control identifiers are ID_LINE, ID_ABSREL, IDOK, and IDCANCEL.

The statements in the first part of the example create the modeless dialog box. These statements, in the window procedure for the application's main window, create the dialog box when the window procedure receives a WM_COMMAND message having the IDM_GOTO command identifier, but only if the global variable hwndGoto does not already contain a valid handle. The second part of the example is the application's main message loop. The loop includes the IsDialogMessage function to ensure that the user can use the dialog box keyboard interface in this modeless dialog box. The third part of the example is the dialog box procedure. The procedure retrieves the contents of the edit control and check box when the user chooses the OK button. The procedure destroys the dialog box when the user chooses the Cancel button.

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;

In the preceding statements, CreateDialog is called only if hwndGoto does not contain a valid window handle. This ensures that the application does not display two dialog boxes at the same time. To support this method of checking, the dialog procedure must set hwndGoto to NULL when it destroys the dialog box.
The message loop for an application consists of the following statements:

while (GetMessage(&msg, NULL, NULL, NULL)) {
if (!IsWindow(hwndGoto) || !IsDialogMessage(hwndGoto, &msg)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}

The loop checks the validity of the window handle for the dialog box and only calls the IsDialogMessage function if the handle is valid. IsDialogMessage only processes the message if it belongs to the dialog box. Otherwise, it returns FALSE and the loop dispatches the message to the appropriate window.
The following statements define the dialog box procedure:

int iLine; // receives line number
BOOL fRelative; // receives check box status

.
.
.

BOOL CALLBACK GoToProc(hwndDlg, message, wParam, lParam)
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 command.
.

return TRUE;

case IDCANCEL:
DestroyWindow(hwndDlg);
hwndGoto = NULL;
return TRUE;
}
}
return FALSE;
}

In the preceding statements, the procedure processes the WM_INITDIALOG and WM_COMMAND messages. During WM_INITDIALOG processing, the procedure initializes the check box by passing the current value of the global variable fRelative to CheckDlgButton. The procedure then returns TRUE to direct Windows to set the default input focus.
During WM_COMMAND processing, the procedure closes the dialog box only if the user chooses the Cancel button ѕ that is, the button having the IDCANCEL identifier. The procedure must call DestroyWindow to close a modeless dialog box. Notice that the procedure also sets the hwndGoto variable to NULL to ensure that other statements that depend on this variable operate correctly.

If the user chooses the OK button, the procedure retrieves the current state of the check box and assigns it to the fRelative variable. It then uses the variable to retrieve the line number from the edit control. GetDlgItemInt translates the text in the edit control into an integer. The value of fRelative determines whether the function interprets the number as a signed or unsigned value. If the edit control text is not a valid number, GetDlgItemInt sets the value of the fError variable to nonzero. The procedure checks this value to determine whether to display an error message or carry out the command. In the event of an error, the dialog box procedure sends a message to the edit control, directing it to select the text in the control so that the user can easily replace it. If GetDlgItemInt does not return an error, the procedure can either carry out the requested command itself or send a message to the owner window, directing it to carry out the command.

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Создание Независимого Диалогового Ящика

Вы создаете независимый диалоговый ящик используя функцию CreateDialog, определяющую идентификатор или имя ресурса шаблона диалогового ящика и адрес диалоговой процедуры ящика. CreateDialog ЗАГРУЖАЕТ шаблон, создает диалоговый ящик, и дополнительно отображает это. Ваше приложение ответственное за поиск и отправку ввода пользователя сообщений в диалоговую процедуру ящика.

В следующем примере, приложение отображает независимого диалогового блока U если оно уже не отображено U когда пользователь решает Go, чтобы командовать из прикладного меню. Диалоговый блок содержит управление редактирования, контрольный блок, и OK и кнопки Отмены. Диалоговый шаблон блока является ресурсом в прикладном выполняемом файле и имеет идентификатор ресурса DLG_GOTO. Пользователь вводит номер строки в редактирование управлять и проверяет контрольного блока, чтобы определять, что линия номера - относительно текущей строки. Управляющие идентификаторы - ID_LINE, ID_ABSREL, IDOK, и IDCANCEL.

Утверждения в первой части примера создают независимого диалогового блока. Эти утверждения, в процедуре окна для прикладного основного окна, создают диалогового блока когда процедура окна получает сообщение WM_COMMAND, имеющее командный идентификатор IDM_GOTO, но только если глобальная переменная hwndGoto уже не содержит правильную ручку. Вторая часть примера является прикладным основным циклом сообщения. Цикл включает функцию IsDialogMessage, чтобы проверять, что пользователь может использовать клавишный интерфейс диалогового блока в этом независимом диалоговом блоке. Третья часть примера является диалоговым блоком процедуры. Процедура извлекает содержание редактирования управляющий и контрольный блок когда пользователь выбирает кнопку OK. Процедура уничтожает диалогового блока когда пользователь выбирает кнопку Отмены.

HWND hwndGoto = НЕДЕЙСТВИТЕЛЬНЫЙ; // ручка окна диалогового блока

.
.
.

случай WM_COMMAND: ключ (LOWORD(wParam)) { случай IDM_GOTO: если (!IsWindow(hwndGoto)) { hwndGoto = CreateDialog(hinst, MAKEINTRESOURCE(DLG_GOTO), hwnd, (DLGPROC) GoToProc);
ShowWindow(hwndGoto, SW_SHOW);
}
прерывание;

}
возвращайте 0L;

В предыдущих утверждениях, CreateDialog вызывается только если hwndGoto не содержит правильную ручку окна. Это проверяет, что приложение не отображает два диалоговых блока в то же самое время. Чтобы поддерживать этот метод проверки, диалоговая процедура должна установить hwndGoto на НЕДЕЙСТВИТЕЛЬНЫЙ когда она уничтожает диалогового блока.
Цикл сообщения для приложения состоит из следующих утверждений:

пока (GetMessage(&msg, НЕДЕЙСТВИТЕЛЬНЫЙ, НЕДЕЙСТВИТЕЛЬНЫЙ, НЕДЕЙСТВИТЕЛЬНЫЙ)) { если (!IsWindow(hwndGoto) || !IsDialogMessage(hwndGoto, &msg)) { TranslateMessage(&msg);
DispatchMessage(&msg);
}
}

Цикл проверяет достоверность ручки окна на наличие диалога боксировать и только вызывает функцию IsDialogMessage если ручка в силе. IsDialogMessage ТОЛЬКО обрабатывает сообщение если это принадлежит диалоговому блоку. В противном случае, это возвращает ЛОЖЬ и цикл посылает сообщение в подходящее окно.
Следующие утверждения определяют диалогового блока процедуры:

int iLine; // номер строки приемников BOOL fRelative; // приемники проверяют блока статуса

.
.
.

BOOL CALLBACK GoToProc(hwndDlg, сообщение, wParam, lParam) HWND hwndDlg;
СООБЩЕНИЕ UINT;
WPARAM wParam;
LPARAM lParam;
{
fError BOOL;

ключ (сообщение) { случай WM_INITDIALOG:
CheckDlgButton(hwndDlg, ID_ABSREL, fRelative);
возвращайтесь ВЕРНО;

случай WM_COMMAND: ключ (LOWORD(wParam)) {

случай IDOK:
fRelative = IsDlgButtonChecked(hwndDlg, ID_ABSREL);
iLine = GetDlgItemInt(hwndDlg, ID_LINE, &fError, fRelative);
если (fError) { MessageBox(hwndDlg, SZINVALIDNUMBER, SZGOTOERR, MB_OK);
SendDlgItemMessage(hwndDlg, ID_LINE, EM_SETSEL, 0, -1L);

} еще

.
. // Уведомите окно владельца, чтобы нести . // команда.
.

возвращайтесь ВЕРНО;

случай IDCANCEL: DestroyWindow(hwndDlg);
hwndGoto = НЕДЕЙСТВИТЕЛЬНЫЙ;
возвращайтесь ВЕРНО;
}
}
обратная ЛОЖЬ;
}

В предыдущих утверждениях, процедура обрабатывает WM_INITDIALOG и сообщения WM_COMMAND. В течение обработки WM_INITDIALOG, процедура инициализирует контрольного блока передавая текущую величину глобальной переменной fRelative на CheckDlgButton. Процедура затем возвращает ИСТИНУ, чтобы направлять Windows, чтобы устанавливать по умолчанию входной фокус.
В течение WM_COMMAND, обрабатывающий, процедура закрывает диалогового блока только если пользователь выбирает кнопку Отмены U то есть, кнопка, имеющая идентификатор IDCANCEL. Процедура должна вызвать DestroyWindow, чтобы закрывать независимого диалогового блока. Обратите внимание как процедура также устанавливала переменную hwndGoto на НЕДЕЙСТВИТЕЛЬНЫЙ, чтобы гарантировать, что другие утверждения, которые зависят от этой переменной действовать правильно.

Если пользователь выбирает кнопку OK, процедура извлекает текущее состояние контрольного блока и назначает это в переменную fRelative. Это затем использует переменную, чтобы извлекать линию номера с управления редактирования. GetDlgItemInt ПЕРЕВОДИТСЯ текст на управление редактирования в целое. Величина fRelative определяет интерпретирует функция число как подписанную или без знака величину. Если управляющий текст редактирования не является правильным числом, GetDlgItemInt устанавливает величину переменной fError на ненулевой. Процедура проверяет эту величину, чтобы определять отображать сообщение ошибки или выполнять команду. В случае ошибки, диалоговый блок процедуры посылает сообщение на управление редактирование, прямое это, чтобы выбираться текст на управлении чтобы пользователь может легко заменить это. Если GetDlgItemInt не возвращает ошибку, процедура может или выполнять саму запрошенную команду или посылать сообщение на окно владелец, прямое это, чтобы выполнять команду.

Используются технологии uCoz