WinAPI на русском

Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".

Сайт рассылки: http://www.winnt.rsm.org.ru. Материалы по Win32 API, C++Builder.

Раздел "WinAPI": http://www.winnt.rsm.org.ru/winapi/winapi.htm
Раздел "C++Builder": http://www.winnt.rsm.org.ru/cbuilder/cbuilder.htm
Раздел "Советы & примеры": http://www.winnt.rsm.org.ru/tipstricks/tipstricks.htm

Обновления на сайте

В раздел "C++Builder" добавилась статья "Сравнение ООП языков: Java, C++, Object
Pascal".

Перевод

Сегодня вашему вниманию представлен перевод функции SetTimer.

SetTimer

Функция SetTimer создает таймер с указанным интервалом срабатывания.

UINT SetTimer(

    HWND hWnd,  // дескриптор окна для сообщений таймера
    UINT nIDEvent,      // идентификатор таймера
    UINT uElapse,       // интервал срабатывания таймера
    TIMERPROC lpTimerFunc       // адрес процедуры таймера
   );

Параметры

hWnd – идентифицирует окно, связанное с таймером. Окном должен владеть вызывающий
поток. Если значение этого параметра равно NULL, с таймером не связывается никакого
окна и параметр nIDEvent игнорируется.
nIDEvent – определяет ненулевой идентификатор таймера. Если значение параметра
hWnd равно NULL, этот параметр игнорируется.
uElapse – определяет интервал срабатывания в миллисекундах.
lpTimerFunc – указывает на функцию, уведомляемую об истечении заданного интервала.
Для дополнительной информации смотрите описание функции TimerProc.
Если значение lpTimerFunc равно NULL, система отправляет сообщение WM_TIMER в
очередь собщений приложения. Значение члена hwnd структуры сообщения типа MSG
содержит значение параметра hWnd.

Возвращаемые значения

В случае успеха возвращается целочисленный идентификатор нового таймера. Приложение
может передавать этот идентификатор в функцию KillTimer для разрушения таймера.
Если не удалось создать новый таймер, возвращается нуль.

Комментарии

Приложение может обрабатывать сообщение WM_TIMER в оконной процедуре приложения,
с соответствующим включением в ее исходный код оператора case, либо указывая
при создании таймера функцию обратного вызова TimerProc. Когда вы указываете
функцию обратного вызова, функция DispatchMessage просто вызывает ее вместо оконной
процедуры.
Значение параметра wParam сообщения WM_TIMER содержит значение параметра nIDEvent.

См. также

DispatchMessage, KillTimer, MSG, TimerProc, WM_TIMER.

хелп по WinAPI: http://www.winnt.rsm.org.ru/winapi/winapirefresh.htm

С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru