Ler em inglês

Compartilhar via


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

Consulte também

Referência

Classe de CTaskDialog

Gráfico de hierarquia

CTaskDialog::GetOptions