TDM_NAVIGATE_PAGE mensagem
Recria uma caixa de diálogo de tarefa com novos conteúdos, simulando a funcionalidade de um assistente de várias páginas.
Parâmetros
-
wParam [in]
-
Não usado. Deve ser zero.
-
lParam [in]
-
Um ponteiro para uma estrutura TASKDIALOGCONFIG que descreve a caixa de diálogo de tarefa a ser criada. O aplicativo de chamada deve alocar essa estrutura e definir seus membros. Os valores dos membros variam dependendo do tipo de página para a qual o usuário navega.
Valor retornado
O valor retornado é ignorado.
Comentários
Para iniciar uma caixa de diálogo de tarefa do assistente, use a função TaskDialogIndirect . À medida que o usuário navega usando o assistente, envie essa mensagem para a caixa de diálogo de tarefa para exibir a próxima página. Uma nova caixa de diálogo de tarefa (parece uma nova página) é criada com os elementos especificados na estrutura apontada por lParam. Na criação, todo o conteúdo do quadro de diálogo é destruído e reconstruído. Como resultado, todas as informações de estado mantidas por controles (por exemplo, uma barra de progresso, botão expando ou caixa de seleção de verificação) na caixa de diálogo são perdidas.
O layout da caixa de diálogo da tarefa pode falhar e isso pode não ser refletido no valor retornado. Um valor retornado de S_OK reflete apenas que a caixa de diálogo da tarefa recebeu a mensagem e tentou processá-la. Se o layout da caixa de diálogo da tarefa falhar (a caixa de diálogo de tarefa não pode ser exibida), a caixa de diálogo será fechada e um código HRESULT será retornado na função de retorno de chamada registrada. Para obter mais informações sobre a sintaxe da função de retorno de chamada, consulte TaskDialogCallbackProc.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
Cabeçalho |
|