CTaskDialog::SetOptions
Configurare le opzioni per CTaskDialog.
void SetOptions(
int nOptionFlag
);
Parametri
- [in] nOptionFlag
Il set di flag da utilizzare per CTaskDialog.
Note
Questo metodo cancella tutte le opzioni correnti per CTaskDialog. Per mantenere le opzioni correnti, consentendo è necessario innanzitutto con CTaskDialog::GetOptions e combinarli con le opzioni che si desidera impostare.
Nella seguente tabella sono elencate tutte le opzioni valide.
TDF_ENABLE_HYPERLINKS
Collegamenti ipertestuali in CTaskDialog.TDF_USE_HICON_MAIN
Configura CTaskDialog utilizzare HICON per l'icona principale. In alternativa è possibile utilizzare LPCWSTR.TDF_USE_HICON_FOOTER
Configura CTaskDialog utilizzare HICON per l'icona del piè di pagina. In alternativa è possibile utilizzare LPCWSTR.TDF_ALLOW_DIALOG_CANCELLATION
Consente all'utente di chiudere CTaskDialog utilizzando la tastiera oppure utilizzando l'icona nell'angolo superiore destro della finestra di dialogo, anche se il pulsante Annulla non è abilitato. Se questo flag non è impostato e il pulsante Annulla non è abilitato, non sarà possibile chiudere la finestra di dialogo mediante ALT+F4, il tasto escape, o il pulsante nella barra del titolo.TDF_USE_COMMAND_LINKS
Configura CTaskDialog utilizzare i pulsanti di comando.TDF_USE_COMMAND_LINKS_NO_ICON
Configura CTaskDialog utilizzare i pulsanti di comando senza visualizzare un'icona accanto al controllo. TDF_USE_COMMAND_LINKS esegue l'override di TDF_USE_COMMAND_LINKS_NO_ICON.TDF_EXPAND_FOOTER_AREA
Indica che l'area di espansione attualmente viene espansa.TDF_EXPANDED_BY_DEFAULT
Determina se l'area di espansione viene espansa per impostazione predefinita.TDF_VERIFICATION_FLAG_CHECKED
Indica che la casella di controllo di verifica è correntemente selezionata.TDF_SHOW_PROGRESS_BAR
Configura CTaskDialog per visualizzare un indicatore di stato.TDF_SHOW_MARQUEE_PROGRESS_BAR
Configura l'indicatore di stato essere un indicatore di stato di marquee. Se si abilita questa opzione, è necessario impostare TDF_SHOW_PROGRESS_BAR per disporre il comportamento previsto.TDF_CALLBACK_TIMER
Indica che l'intervallo di callback CTaskDialog viene impostato su su 200 millisecondi.TDF_POSITION_RELATIVE_TO_WINDOW
Configura CTaskDialog per essere centrato rispetto alla finestra padre. Se questo flag non è attivato, CTaskDialog viene centrato rispetto al monitor.TDF_RTL_LAYOUT
Configura CTaskDialog per un layout da destra a sinistra di lettura.TDF_NO_DEFAULT_RADIO_BUTTON
Indica che nessun pulsante di opzione selezionato quando CTaskDialog visualizzato.TDF_CAN_BE_MINIMIZED
Consente all'utente per ridurre CTaskDialog. Per supportare questa opzione, CTaskDialog non può essere modale. MFC non supporta questa opzione poiché MFC non supporta CTaskDialognon modale.
Esempio
// 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();
Requisiti
intestazione: afxtaskdialog.h