3.6. Генерация сообщений таймера

Последним сообщением, которое мы обсудим в этой главе, будет WM_TIMER. В Windows-программах можно устанавливать таймер, который с заданной периодич­ностью будет посылать программе сообщение WM_TIMER. Использование таймера является хорошим способом время от времени «будить» Вашу программу. Это может быть полезным в том случае, если Ваша программа выполняется как фоновое приложение.

Основные функции. Для установки таймера нужно использовать функцию API SetTimer():

UINT SetTimer(HWND hwnd, UINT nID, UINT wLength,

TIMEPROC lpTFunc);

Параметр hwnd является дескриптором окна, которое собирается использовать таймер. Параметр nID – идентификатор устанавливаемого таймера (одновременно могут использоваться несколько таймеров). Параметр wLength задает временной интервал для таймера в миллисекундах. Функция, указатель на которую задается параметром lpTFunc, является процедурой, определенной в программе и вызываемой при об­работке прерываний таймера. Эта функция должна быть определена как VOID CALLBACK и имеет такие же параметры, как и оконная функция. Однако, если значение lpTFunc равно NULL, как это чаще всего и бывает, для обработки сообще­ний таймера будет вызываться оконная функция. В этом случае каждый раз по истечении заданного временного интервала в очередь сообщений программы будет помещаться сообщение WM_TIMER, а оконная функция программы должна будет обрабатывать его так же, как и остальные сообщения. Такой подход используется в следующем примере. Функция SetTimer() в случае успешного завершения возвращает значение nID, в противном случае возвращается 0.

Будучи установлен, таймер будет посылать сообщения до тех пор, пока программа не завершится или не вызовет функцию API KillTimer():

BOOL KillTimer(HWND hwnd, UINT nID);

Здесь hwnd является дескриптором окна, использующего таймер, а nID – идентификатором этого таймера.

Каждый раз при поступлении сообщения WM_TIMER параметр wParam содер­жит идентификатор таймера, a lParam – адрес функции таймера (если он был задан при установке таймера). В следующем примере значение IParam будет NULL.

Дополнительные функции. Для программирования с использованием таймера нам потребуется специальная структура типа tm, предоставляемая операционной системой

struct tm *newtime,

адрес которой помещается в указатель newtime.

Кроме того, нужна переменная t типа time_t:

time_t t.

Функция time(NULL)позволяет получить новое время, которое имеет тип time_t:

t = time(NULL).

Новое время можно поместить в структуру типа tm (в соответствующее её поле), адрес которой помещен в указатель newtime, с помощью функции localtime :

newtime=localtime(&t).

Единственным аргументом функции localtime является адрес переменной t типа time_t.

Из структуры типа tm время можно поместить в буфер вывода, используя функции strcpy и asctime:

strcpy(str,asctime(newtime)).

Следует учесть, что в конце этой информации Windows поместит символы «возврат каретки» \r и «новая строка» \n . Эти символы желательно удалить, поставив в конце информации обычный символ «конец строки»:

str[strlen(str)-1] = '\0' .

Пример 3-5. Приведенная ниже программа использует таймер для создания часов. Для полу­чения текущей даты и времени она вызывает стандартные функции «C» или «C++». Каждый раз при получении сообщения таймера – примерно раз в секунду – изображение, отображающее время, обновляется. Таким образом, время указывается с точностью до одной секунды.

// Программа-часы

#include <Windows.h>

#include <String.h>

#include <Stdio.h>

#include <Time.h>

LRESULT CALLBACK WindowFunc(HWND, UINT,

WPARAM, LPARAM);

char szWinName[]="МоеОкно"; // Имя класса окна

char str[80]=""; // Буфер для строки вывода

int X=1, Y=1; // Координаты строки на экране

int WINAPI WinMain(HINSTANCE hThisInst,

HINSTANCE hPrevInst,

LPSTR lpszArgs,

int nWinMode)

{

HWND hwnd;

MSG msg;

WNDCLASS wcl; // Определить класс окна

wcl.hInstance=hThisInst; // Дескриптор приложения

wcl.lpszClassName=szWinName; // Имя класса окна

wcl.lpfnWndProc=WindowFunc; // Функция окна

wcl.style=0; // Стиль по умолчанию

wcl.hIcon=LoadIcon(NULL,IDI_APPLICATION);// Иконка

wcl.hCursor=LoadCursor(NULL,IDC_ARROW); // Курсор

wcl.lpszMenuName=NULL; // Без меню

wcl.cbClsExtra=0; // Без дополнительной информации

wcl.cbWndExtra=0;

wcl.hbrBackground=

(HBRUSH)GetStockObject(WHITE_BRUSH); //Белый фон

if(!RegisterClass(&wcl)) // Регистрируем класс окна

return 0;

hwnd=CreateWindow(szWinName, // Создать окно

"Программа-часы",

WS_OVERLAPPEDWINDOW, // Стиль окна

CW_USEDEFAULT, // x-координата

CW_USEDEFAULT, // y-координата

CW_USEDEFAULT, // Ширина

CW_USEDEFAULT, // Высота

HWND_DESKTOP, // Нет родител. окна

NULL, // Нет меню

hThisInst,// Дескриптор приложения

NULL); // Нет дополнит. аргументов

ShowWindow (hwnd, nWinMode); // Показать окно

SetTimer(hwnd,1,1000,NULL); // Устан. таймер 1 сек.

UpdateWindow(hwnd); // Перерисовать содержимое

while(GetMessage(&msg,NULL,0,0)) // Запустить цикл

{ // обработки сообщений

TranslateMessage(&msg); //Разреш. исп-е клавиатуры

DispatchMessage (&msg); // Вернуть управл. Windows

}

KillTimer(hwnd,1); // Освободить таймер

return msg.wParam;

}

// Следующая функция вызывается операционной

// системой Windows и получает в качестве

// параметров сообщения из очереди сообщений

// данного приложения

LRESULT CALLBACK WindowFunc(HWND hwnd,

UINT message,

WPARAM wParam,

LPARAM lParam)

{

HDC hdc;

PAINTSTRUCT paintstruct;

struct tm *newtime;

time_t t;

switch(message)

{

case WM_PAINT: // Перерисовка рабочей области

hdc=BeginPaint(hwnd,&paintstruct);// Получить DC

TextOut(hdc,X,Y,str,strlen(str));//Вывести буфер

EndPaint(hwnd, &paintstruct); // Освободить DC

break;

case WM_TIMER: // Очередной временной интервал

t = time(NULL); // Получить новое время

newtime=localtime(&t); // Новое время - в буфер

strcpy(str,asctime(newtime));

str[strlen(str)-1] = '\0'; // Удалить \r\n

InvalidateRect(hwnd,NULL,1); // Перерисов. экран

break;

case WM_DESTROY: // Завершение программы

PostQuitMessage(0);

break;

default:

// Все сообщения, не обрабатываемые в

// данной функции, направляются на обработку

// по умолчанию

return DefWindowProc(hwnd,message,

wParam,lParam);

}

return 0;

}

Пример вывода этой программы показан на рис. 3.3.