SetTimer
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função cria um timer com o valor de tempo limite especificado.
Syntax
UINT SetTimer(
HWND hWnd,
UINT nIDEvent,
UINT uElapse,
TIMERPROC lpTimerFunc
);
Parameters
- hWnd
[no] Identificador para a janela seja associado com o timer. Esta janela deve pertencer o segmento chamado. Se este parâmetro é NULL, nenhuma janela está associado com o timer e nIDEvent parâmetro será ignorado.
- nIDEvent
[no] Especifica um diferente de zero identificador timer. Se a pasta hWnd parâmetro é NULL, este parâmetro é ignorado.
- uElapse
[no] Especifica o valor de tempo limite, em milissegundos.
lpTimerFunc
[no] Ponteiro longo para a função para ser notificado quando expirar o valor de tempo limite. Para obter mais informações sobre a função, consulte TimerProc.Se lpTimerFunc é NULL, as postagens sistema um WM_TIMER mensagem para a fila aplicativo. O hwnd membro da mensagem MSG estrutura contém o valor da hWnd parâmetro.
Return Value
Um inteiro que identifica o timer novo indica sucesso. Um aplicativo pode transmitir este valor, ou o identificador seqüência de caracteres, se ele existir, para o KillTimer função para destruir o timer. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Se a pasta uElapse parâmetro for definido como infinito, KillTimer Falha ao destruir o timer.
Um aplicativo pode processo WM_TIMER mensagens por incluindo uma maiúsculas e minúsculas WM_TIMER declaração no procedimento de janela ou especificando um TimerProc função callback quando criar o timer. Quando você especificar um TimerProc função callback, o procedimento janela usar como padrão chama o função callback quando ele processa WM_TIMER. Portanto, você precisa para distribuir mensagens de segmento chamado, mesmo quando você usa TimerProc INSTEAD OF processamento WM_TIMER.
O wParam Contém o valor do parâmetro da mensagem WM_TIMER a nIDEvent parâmetro.
Se SetTimer é chamado com hWnd Definir como NULL e lpTimerFunc Definir como NULL, mensagem WM_TIMER não serão entregues.
Requirements
| Header | winuser.h |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |