Compartilhar via


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
Commctrl.h