Использование сообщений и очередей сообщений
В следующих примерах кода показано, как выполнять следующие задачи, связанные с сообщениями и очередями сообщений Windows.
Создание цикла сообщений
Система не создает автоматически очередь сообщений для каждого потока. Вместо этого система создает очередь сообщений только для потоков, выполняющих операции, для которых требуется очередь сообщений. Если поток создает одно или несколько окон, необходимо предоставить цикл сообщений; Этот цикл сообщений извлекает сообщения из очереди сообщений потока и отправляет их в соответствующие процедуры окна.
Так как система направляет сообщения в отдельные окна в приложении, поток должен создать по крайней мере одно окно перед запуском цикла сообщений. Большинство приложений содержат один поток, который создает окна. Типичное приложение регистрирует класс окна для main окна, создает и отображает окно main, а затем запускает цикл сообщений — все это в функции WinMain.
Цикл сообщений создается с помощью функций GetMessage и DispatchMessage . Если приложение должно получать символьные данные от пользователя, включите функцию TranslateMessage в цикл. TranslateMessage преобразует сообщения с виртуальным ключом в символьные сообщения. В следующем примере показан цикл сообщений в функции WinMain простого приложения windows.
HINSTANCE hinst;
HWND hwndMain;
int PASCAL WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpszCmdLine, int nCmdShow)
{
MSG msg;
BOOL bRet;
WNDCLASS wc;
UNREFERENCED_PARAMETER(lpszCmdLine);
// Register the window class for the main window.
if (!hPrevInstance)
{
wc.style = 0;
wc.lpfnWndProc = (WNDPROC) WndProc;
wc.cbClsExtra = 0;
wc.cbWndExtra = 0;
wc.hInstance = hInstance;
wc.hIcon = LoadIcon((HINSTANCE) NULL,
IDI_APPLICATION);
wc.hCursor = LoadCursor((HINSTANCE) NULL,
IDC_ARROW);
wc.hbrBackground = GetStockObject(WHITE_BRUSH);
wc.lpszMenuName = "MainMenu";
wc.lpszClassName = "MainWndClass";
if (!RegisterClass(&wc))
return FALSE;
}
hinst = hInstance; // save instance handle
// Create the main window.
hwndMain = CreateWindow("MainWndClass", "Sample",
WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT,
CW_USEDEFAULT, CW_USEDEFAULT, (HWND) NULL,
(HMENU) NULL, hinst, (LPVOID) NULL);
// If the main window cannot be created, terminate
// the application.
if (!hwndMain)
return FALSE;
// Show the window and paint its contents.
ShowWindow(hwndMain, nCmdShow);
UpdateWindow(hwndMain);
// Start the message loop.
while( (bRet = GetMessage( &msg, NULL, 0, 0 )) != 0)
{
if (bRet == -1)
{
// handle the error and possibly exit
}
else
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
// Return the exit code to the system.
return msg.wParam;
}
В следующем примере показан цикл сообщений для потока, который использует ускорители и отображает немодерное диалоговое окно. Когда TranslateAccelerator или IsDialogMessage возвращает значение TRUE (указывающее, что сообщение было обработано), TranslateMessage и DispatchMessage не вызываются. Это связано с тем, что TranslateAccelerator и IsDialogMessage выполняют все необходимые операции перевода и отправки сообщений.
HWND hwndMain;
HWND hwndDlgModeless = NULL;
MSG msg;
BOOL bRet;
HACCEL haccel;
//
// Perform initialization and create a main window.
//
while( (bRet = GetMessage( &msg, NULL, 0, 0 )) != 0)
{
if (bRet == -1)
{
// handle the error and possibly exit
}
else
{
if (hwndDlgModeless == (HWND) NULL ||
!IsDialogMessage(hwndDlgModeless, &msg) &&
!TranslateAccelerator(hwndMain, haccel,
&msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
}
Проверка очереди сообщений
Иногда приложению требуется проверять содержимое очереди сообщений потока из-за пределов цикла сообщений потока. Например, если оконная процедура приложения выполняет длительную операцию рисования, может потребоваться, чтобы пользователь мог прервать операцию. Если приложение не будет периодически проверять очередь сообщений во время операции на наличие сообщений мыши и клавиатуры, оно не будет отвечать на ввод данных пользователем до завершения операции. Это связано с тем, что функция DispatchMessage в цикле сообщений потока не возвращается, пока оконная процедура не завершит обработку сообщения.
Функцию PeekMessage можно использовать для проверки очереди сообщений во время длительной операции. PeekMessage похож на функцию GetMessage; оба проверка очередь сообщений для сообщения, соответствующего критериям фильтра, а затем скопируйте сообщение в структуру MSG. Разница между двумя функциями main заключается в том, что GetMessage не возвращается до тех пор, пока в очередь не будет помещено сообщение, соответствующее условиям фильтра, в то время как PeekMessage возвращает немедленно независимо от того, находится ли сообщение в очереди.
В следующем примере показано, как использовать PeekMessage для проверки очереди сообщений на наличие щелчков мышью и ввода с клавиатуры во время длительной операции.
HWND hwnd;
BOOL fDone;
MSG msg;
// Begin the operation and continue until it is complete
// or until the user clicks the mouse or presses a key.
fDone = FALSE;
while (!fDone)
{
fDone = DoLengthyOperation(); // application-defined function
// Remove any messages that may be in the queue. If the
// queue contains any mouse or keyboard
// messages, end the operation.
while (PeekMessage(&msg, hwnd, 0, 0, PM_REMOVE))
{
switch(msg.message)
{
case WM_LBUTTONDOWN:
case WM_RBUTTONDOWN:
case WM_KEYDOWN:
//
// Perform any required cleanup.
//
fDone = TRUE;
}
}
}
Другие функции, включая GetQueueStatus и GetInputState, также позволяют проверять содержимое очереди сообщений потока. GetQueueStatus возвращает массив флагов, указывающих типы сообщений в очереди; это самый быстрый способ определить, содержит ли очередь какие-либо сообщения. GetInputState возвращает значение TRUE , если очередь содержит сообщения мыши или клавиатуры. Обе эти функции можно использовать для определения того, содержит ли очередь сообщения, которые необходимо обработать.
Публикация сообщения
Вы можете отправить сообщение в очередь сообщений с помощью функции PostMessage . PostMessage помещает сообщение в конец очереди сообщений потока и возвращает его немедленно, не дожидаясь обработки сообщения потоком. Параметры функции включают дескриптор окна, идентификатор сообщения и два параметра сообщения. Система копирует эти параметры в структуру MSG , заполняет элементы времени и pt структуры и помещает структуру в очередь сообщений.
Система использует дескриптор окна, переданный с функцией PostMessage , чтобы определить, какая очередь сообщений потока должна получить сообщение. Если дескриптор HWND_TOPMOST, система отправляет сообщение в очереди сообщений потока всех окон верхнего уровня.
Функцию PostThreadMessage можно использовать для публикации сообщения в определенной очереди сообщений потока. PostThreadMessage похож на PostMessage, за исключением того, что первый параметр является идентификатором потока, а не дескриптором окна. Идентификатор потока можно получить, вызвав функцию GetCurrentThreadId .
Используйте функцию PostQuitMessage для выхода из цикла сообщений. PostQuitMessage отправляет сообщение WM_QUIT в текущий выполняющийся поток. Цикл сообщений потока завершается и возвращает управление системе при обнаружении WM_QUIT сообщения. Приложение обычно вызывает PostQuitMessage в ответ на сообщение WM_DESTROY , как показано в следующем примере.
case WM_DESTROY:
// Perform cleanup tasks.
PostQuitMessage(0);
break;
Отправка сообщения
Функция SendMessage используется для отправки сообщения непосредственно в процедуру окна. SendMessage вызывает процедуру окна и ожидает, пока она обработает сообщение и возвратит результат.
Сообщение может быть отправлено в любое окно в системе; Все, что требуется, — это дескриптор окна. Система использует дескриптор для определения того, какая процедура окна должна получить сообщение.
Перед обработкой сообщения, которое могло быть отправлено из другого потока, процедура окна должна сначала вызвать функцию InSendMessage . Если эта функция возвращает значение TRUE, оконная процедура должна вызвать ReplyMessage перед любой функцией, которая вызывает поток для получения элемента управления, как показано в следующем примере.
case WM_USER + 5:
if (InSendMessage())
ReplyMessage(TRUE);
DialogBox(hInst, "MyDialogBox", hwndMain, (DLGPROC) MyDlgProc);
break;
В диалоговом окне элементы управления можно отправить несколько сообщений. Эти сообщения задают внешний вид, поведение и содержимое элементов управления или извлекают сведения об элементах управления. Например, CB_ADDSTRING сообщение может добавить строку в поле со списком, а BM_SETCHECK сообщение может задать состояние проверка проверка поля или переключателя.
Используйте функцию SendDlgItemMessage для отправки сообщения элементу управления, указав идентификатор элемента управления и дескриптор диалогового окна, содержащего элемент управления. Следующий пример, взятый из процедуры диалогового окна, копирует строку из элемента управления редактирования поля со списком в его поле списка. В этом примере sendDlgItemMessage отправляет CB_ADDSTRING сообщение в поле со списком.
HWND hwndCombo;
int cTxtLen;
PSTR pszMem;
switch (uMsg)
{
case WM_COMMAND:
switch (LOWORD(wParam))
{
case IDD_ADDCBITEM:
// Get the handle of the combo box and the
// length of the string in the edit control
// of the combo box.
hwndCombo = GetDlgItem(hwndDlg, IDD_COMBO);
cTxtLen = GetWindowTextLength(hwndCombo);
// Allocate memory for the string and copy
// the string into the memory.
pszMem = (PSTR) VirtualAlloc((LPVOID) NULL,
(DWORD) (cTxtLen + 1), MEM_COMMIT,
PAGE_READWRITE);
GetWindowText(hwndCombo, pszMem,
cTxtLen + 1);
// Add the string to the list box of the
// combo box and remove the string from the
// edit control of the combo box.
if (pszMem != NULL)
{
SendDlgItemMessage(hwndDlg, IDD_COMBO,
CB_ADDSTRING, 0,
(DWORD) ((LPSTR) pszMem));
SetWindowText(hwndCombo, (LPSTR) NULL);
}
// Free the memory and return.
VirtualFree(pszMem, 0, MEM_RELEASE);
return TRUE;
//
// Process other dialog box commands.
//
}
//
// Process other dialog box messages.
//
}