CTaskDialog::SetOptions
Configurar as opções para CTaskDialog.
void SetOptions(
int nOptionFlag
);
Parâmetros
- [in] nOptionFlag
O conjunto de sinalizadores para usar o para CTaskDialog.
Comentários
Este método limpa todas as opções para CTaskDialogatual.Para preservar as opções atual, você deve recuperar-las primeiro com CTaskDialog::GetOptions e combiná-las com as opções que você deseja definir.
A tabela a seguir lista as opções válidos.
TDF_ENABLE_HYPERLINKS
Permite hiperlinks em CTaskDialog.TDF_USE_HICON_MAIN
Configurar CTaskDialog para usar HICON para o ícone de chave.Uma alternativa é usar LPCWSTR.TDF_USE_HICON_FOOTER
Configurar CTaskDialog para usar HICON para o ícone de rodapé.Uma alternativa é usar LPCWSTR.TDF_ALLOW_DIALOG_CANCELLATION
Permite que o usuário para fechar CTaskDialog usando o teclado ou usando o ícone no canto superior direito da caixa de diálogo, mesmo se o botão de Cancelar não está ativado.Se este sinalizador não está definido e o botão de Cancelar não está ativado, o usuário não pode fechar a caixa de diálogo usando Alt+F4, a tecla escape, ou botão da barra de título o próximo.TDF_USE_COMMAND_LINKS
Configurar CTaskDialog para usar controles de botão de comando.TDF_USE_COMMAND_LINKS_NO_ICON
Configurar CTaskDialog para usar controles de botão de comando sem exibir um ícone próximo ao controle.Substitui TDF_USE_COMMAND_LINKS_NO_ICONdeTDF_USE_COMMAND_LINKS .TDF_EXPAND_FOOTER_AREA
Indica que a área de expansão é expandida no momento.TDF_EXPANDED_BY_DEFAULT
Determina se a área de expansão é expandida por padrão.TDF_VERIFICATION_FLAG_CHECKED
Indica que a caixa de seleção de seleção está selecionada no momento.TDF_SHOW_PROGRESS_BAR
Configurar CTaskDialog para exibir uma barra de progresso.TDF_SHOW_MARQUEE_PROGRESS_BAR
Configurar a barra de progresso para ser uma barra de progresso de famoso.Se você ativar essa opção, você deve definir TDF_SHOW_PROGRESS_BAR para o comportamento esperado.TDF_CALLBACK_TIMER
Indica que o intervalo de retorno de chamada de CTaskDialog é definido como aproximadamente 200 milissegundos.TDF_POSITION_RELATIVE_TO_WINDOW
Configurar CTaskDialog a ser centralizado em relação à janela pai.Se este sinalizador não estiver ativado, CTaskDialog é centralizado em relação ao monitor.TDF_RTL_LAYOUT
Configurar CTaskDialog para um layout da direita para esquerda.TDF_NO_DEFAULT_RADIO_BUTTON
Indica que nenhuma botão de opção está selecionado quando CTaskDialog aparecer.TDF_CAN_BE_MINIMIZED
Permite que o usuário para minimizar CTaskDialog.Para suportar essa opção, CTaskDialog não pode ser restrito.O MFC não suporta esta opção porque o MFC não oferece suporte CTaskDialogsem janela restrita.
Exemplo
// TODO: Replace the strings below with the appropriate message,
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");
CTaskDialog taskDialog(message, mainInstruction, title,
TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );
// Setting new information to be able to reuse the dialog resource
taskDialog.SetWindowTitle(L"New title for the task dialog");
taskDialog.SetContent(L"New message to show the user.");
taskDialog.SetMainInstruction(L"Even more important!");
taskDialog.SetMainIcon(TD_ERROR_ICON);
taskDialog.SetDialogWidth(300);
// Add a footer
taskDialog.SetFooterText(L"Footer information for the dialog.");
taskDialog.SetFooterIcon(TD_INFORMATION_ICON);
// Add expansion information
taskDialog.SetExpansionArea(L"Additional information\non two lines.",
L"Click here for more information.",
L"Click here to hide the extra information.");
// Change the options to show the expanded information by default.
// It is necessary to retrieve the current options first.
int options = taskDialog.GetOptions();
options |= TDF_EXPANDED_BY_DEFAULT;
taskDialog.SetOptions(options);
taskDialog.DoModal();
Requisitos
Cabeçalho: afxtaskdialog.h