Функции Win32 API [ K ]

Delphi , Синтаксис , Справочник по API-функциям

Функция KillTimer

Описание:
function KillTimer(Wnd: HWnd, IDEvent: Integer): Bool;

Уничтожает событие таймеpа, удаляя из очеpеди сообщений любые связанные с ним сообщения wm_Timer.

Паpаметpы:
Wnd: Идентификатоp окна.
IDEvent: Идентификатоp события таймеpа.

Возвpащаемое значение:
Не нуль в случае успешного завеpшения; 0 - если невеpный IDEvent.

См. также: SetTimer


функция находится в файле user32.dll

Here is the translation of the text into Russian:

Функция: KillTimer

Описание: Функция KillTimer уничтожает событие таймера, удаляя любые связанные сообщения типа WM_TIMER.

Параметры:

• Wnd: Обратный handle к окну, владеющему таймером.
• IDEvent: Идентификатор события таймера для уничтожения.

Возвращаемое значение: Если функция успешна, она возвращает ненулевое значение. Если IDEvent недействителен, функция возвращает 0.

См. также: SetTimer

Библиотека: Функция KillTimer находится в библиотеке user32.dll.

Эта функция полезна, когда вам нужно остановить событие таймера от повторного вызова. Вы можете вызвать эту функцию с handle окна, владеющего таймером, и идентификатором события таймера для уничтожения.

Пример:

procedure TForm1.ButtonClick(Sender: TObject);
begin
  KillTimer(Self.Handle, MyTimerEventId);
end;

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

Замечание: эта функция не останавливает таймер в тот момент, когда она вызывается. Если вы уже запланировали таймер на событие, он все еще будет вызван один раз перед уничтожением.

Функция KillTimer Win32 API уничтожает событие таймера, удаляя из очереди сообщений любые связанные с ним сообщения wm_Timer, если указанный идентификатор окна и события корректны.

Комментарии и вопросы

:: Главная :: Справочник по API-функциям ::