Condividi tramite

Struttura TASKDIALOGCONFIG (commctrl.h)

  • Articolo

La struttura TASKDIALOGCONFIG contiene informazioni utilizzate per visualizzare una finestra di dialogo attività. La funzione TaskDialogIndirect usa questa struttura.

Sintassi

typedef struct _TASKDIALOGCONFIG {
  UINT                           cbSize;
  HWND                           hwndParent;
  HINSTANCE                      hInstance;
  TASKDIALOG_FLAGS               dwFlags;
  TASKDIALOG_COMMON_BUTTON_FLAGS dwCommonButtons;
  PCWSTR                         pszWindowTitle;
  union {
    HICON  hMainIcon;
    PCWSTR pszMainIcon;
  } DUMMYUNIONNAME;
  PCWSTR                         pszMainInstruction;
  PCWSTR                         pszContent;
  UINT                           cButtons;
  const TASKDIALOG_BUTTON        *pButtons;
  int                            nDefaultButton;
  UINT                           cRadioButtons;
  const TASKDIALOG_BUTTON        *pRadioButtons;
  int                            nDefaultRadioButton;
  PCWSTR                         pszVerificationText;
  PCWSTR                         pszExpandedInformation;
  PCWSTR                         pszExpandedControlText;
  PCWSTR                         pszCollapsedControlText;
  union {
    HICON  hFooterIcon;
    PCWSTR pszFooterIcon;
  } DUMMYUNIONNAME2;
  PCWSTR                         pszFooter;
  PFTASKDIALOGCALLBACK           pfCallback;
  LONG_PTR                       lpCallbackData;
  UINT                           cxWidth;
} TASKDIALOGCONFIG;

Members

cbSize

Tipo: UINT

Specifica le dimensioni della struttura, in byte.

hwndParent

Tipo: HWND

Handle per la finestra padre. Questo membro può essere NULL.

hInstance

Tipo: HINSTANCE

Gestire il modulo che contiene la risorsa icona identificata dai membri pszMainIcon o pszFooterIcon e le risorse stringa identificate dai membri pszWindowTitle, pszMainInstruction, pszContent, pszVerificationText, pszExpandedInformation, pszExpandedControlText, pszCollapsedControlText o pszFooter .

dwFlags

Tipo: TASKDIALOG_FLAGS

Specifica il comportamento della finestra di dialogo attività. Questo parametro può essere una combinazione di flag del gruppo seguente:

Valore Significato
TDF_ENABLE_HYPERLINKS
 Abilita l'elaborazione di collegamenti ipertestuali per le stringhe specificate nei membri pszContent, pszExpandedInformation e pszFooter . Se abilitata, questi membri possono puntare a stringhe che contengono collegamenti ipertestuali nel formato seguente:
<A HREF="executablestring">Hyperlink Text</A>

Avviso: l'abilitazione dei collegamenti ipertestuali quando si usa contenuto da un'origine non sicura può causare vulnerabilità di sicurezza.

Nota Le finestre di dialogo attività non eseguiranno effettivamente alcun collegamento ipertestuale. L'esecuzione di collegamenti ipertestuali deve essere gestita nella funzione di callback specificata da pfCallback. Per altri dettagli, vedere TaskDialogCallbackProc.
 
TDF_USE_HICON_MAIN
 Indica che la finestra di dialogo deve usare l'icona a cui fa riferimento l'handle nel membro hMainIcon come icona primaria nella finestra di dialogo attività. Se questo flag viene specificato, il membro pszMainIcon viene ignorato.
TDF_USE_HICON_FOOTER
 Indica che la finestra di dialogo deve usare l'icona a cui fa riferimento l'handle nel membro hFooterIcon come icona del piè di pagina nella finestra di dialogo dell'attività. Se questo flag viene specificato, il membro pszFooterIcon viene ignorato.
TDF_ALLOW_DIALOG_CANCELLATION
 Indica che la finestra di dialogo deve essere chiusa usando ALT-F4, Escape e il pulsante di chiusura della barra del titolo anche se non viene specificato alcun pulsante annulla nei membri dwCommonButtons o pButtons .
TDF_USE_COMMAND_LINKS
 Indica che i pulsanti specificati nel membro pButtons devono essere visualizzati come collegamenti di comando (usando un glifo della finestra di dialogo attività standard) anziché i pulsanti di scelta rapida. Quando si usano i collegamenti ai comandi, tutti i caratteri fino al primo carattere di riga nel membro pszButtonText verranno considerati come testo principale del collegamento di comando e il resto verrà considerato come nota del collegamento di comando. Questo flag viene ignorato se il membro cButtons è zero.
TDF_USE_COMMAND_LINKS_NO_ICON
 Indica che i pulsanti specificati nel membro pButtons devono essere visualizzati come collegamenti di comando (senza un glifo) anziché pulsanti di scelta rapida. Quando si usano i collegamenti ai comandi, tutti i caratteri fino al primo carattere di riga nel membro pszButtonText verranno considerati come testo principale del collegamento di comando e il resto verrà considerato come nota del collegamento di comando. Questo flag viene ignorato se il membro cButtons è zero.
TDF_EXPAND_FOOTER_AREA
 Indica che la stringa specificata dal membro pszExpandedInformation viene visualizzata nella parte inferiore dell'area del piè di pagina della finestra di dialogo anziché immediatamente dopo il contenuto della finestra di dialogo. Questo flag viene ignorato se il membro pszExpandedInformation è NULL.
TDF_EXPANDED_BY_DEFAULT
 Indica che la stringa specificata dal membro pszExpandedInformation viene visualizzata quando la finestra di dialogo viene visualizzata inizialmente. Questo flag viene ignorato se il membro pszExpandedInformation è NULL.
TDF_VERIFICATION_FLAG_CHECKED
 Indica che la casella di controllo di verifica nella finestra di dialogo viene selezionata quando la finestra di dialogo viene visualizzata inizialmente. Questo flag viene ignorato se il parametro pszVerificationText è NULL.
TDF_SHOW_PROGRESS_BAR
 Indica che deve essere visualizzato un indicatore di stato.
TDF_SHOW_MARQUEE_PROGRESS_BAR
 Indica che deve essere visualizzato un indicatore di stato del riquadro di selezione.
TDF_CALLBACK_TIMER
 Indica che il callback del dialogo attività deve essere chiamato approssimativamente ogni 200 millisecondi.
TDF_POSITION_RELATIVE_TO_WINDOW
 Indica che la finestra di dialogo attività è posizionata (al centro) rispetto alla finestra specificata da hwndParent. Se il flag non viene fornito (o non viene specificato alcun membro hwndParent ), la finestra di dialogo dell'attività viene posizionata (al centro) rispetto al monitoraggio.
TDF_RTL_LAYOUT
 Indica che il testo viene visualizzato in lettura da destra a sinistra.
TDF_NO_DEFAULT_RADIO_BUTTON
 Indica che non verrà selezionato alcun elemento predefinito.
TDF_CAN_BE_MINIMIZED
 Indica che la finestra di dialogo attività può essere ridotta a icona.
TDIF_SIZE_TO_CONTENT
 Questo flag è deprecato. Usare invece TDF_SIZE_TO_CONTENT .
TDF_SIZE_TO_CONTENT
 Indica che la larghezza della finestra di dialogo attività è determinata dalla larghezza dell'area di contenuto. Questo flag viene ignorato se cxWidth non è impostato su 0.

dwCommonButtons

Tipo: TASKDIALOG_COMMON_BUTTON_FLAGS

Specifica i pulsanti di scelta rapida visualizzati nella finestra di dialogo attività. Se non vengono specificati pulsanti comuni e non vengono specificati pulsanti personalizzati utilizzando i membri cButtons e pButtons , la finestra di dialogo attività conterrà il pulsante OK per impostazione predefinita. Questo parametro può essere una combinazione di flag del gruppo seguente:

Valore Significato
TDCBF_OK_BUTTON
 La finestra di dialogo attività contiene il pulsante di selezione: OK.
TDCBF_YES_BUTTON
 La finestra di dialogo attività contiene il pulsante di selezione: Sì.
TDCBF_NO_BUTTON
 La finestra di dialogo attività contiene il pulsante di selezione : No.
TDCBF_CANCEL_BUTTON
 La finestra di dialogo attività contiene il pulsante di selezione : Annulla. Se questo pulsante viene specificato, la finestra di dialogo dell'attività risponderà alle azioni di annullamento tipiche (ALT-F4 e Escape).
TDCBF_RETRY_BUTTON
 La finestra di dialogo attività contiene il pulsante di selezione: Riprova.
TDCBF_CLOSE_BUTTON
 La finestra di dialogo attività contiene il pulsante di selezione: Chiudi.

pszWindowTitle

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da usare per il titolo della finestra di dialogo attività. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Se questo parametro è NULL, viene usato il nome file del programma eseguibile.

DUMMYUNIONNAME

DUMMYUNIONNAME.hMainIcon

Tipo: HICON

Handle di un'icona da visualizzare nella finestra di dialogo dell'attività. Questo membro viene ignorato a meno che non venga specificato il flag di TDF_USE_HICON_MAIN. Se questo membro è NULL e viene specificato il TDF_USE_HICON_MAIN, non verrà visualizzata alcuna icona.

DUMMYUNIONNAME.pszMainIcon

Tipo: PCWSTR

Puntatore che fa riferimento all'icona da visualizzare nella finestra di dialogo attività. Questo parametro viene ignorato se viene specificato il flag USE_HICON_MAIN. In caso contrario, se questo parametro è NULL o il parametro hInstance è NULL, non verrà visualizzata alcuna icona. Questo parametro deve essere un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE o uno dei valori predefiniti seguenti:

Valore Significato
TD_ERROR_ICON
 Nella finestra di dialogo dell'attività viene visualizzata un'icona di segno di arresto.
TD_WARNING_ICON
 Nella finestra di dialogo dell'attività viene visualizzata un'icona punto esclamativo.
TD_INFORMATION_ICON
 Nella finestra di dialogo dell'attività viene visualizzata un'icona costituita da una lettera minuscola i in un cerchio.
TD_SHIELD_ICON
 Nella finestra di dialogo dell'attività viene visualizzata un'icona di scudo.

pszMainInstruction

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da usare per l'istruzione principale. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE .

pszContent

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da usare per il contenuto primario del dialogo. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Se il flag ENABLE_HYPERLINKS viene specificato per il membro dwFlags , questa stringa può contenere collegamenti ipertestuali nel formato: <A HREF="executablestring">Hyperlink Text</A>. AVVISO: l'abilitazione dei collegamenti ipertestuali quando si usa contenuto da un'origine non sicura può causare vulnerabilità di sicurezza.

cButtons

Tipo: UINT

Numero di voci nella matrice pButtons utilizzata per creare pulsanti o collegamenti di comando nella finestra di dialogo attività. Se questo membro è zero e non sono stati specificati pulsanti comuni utilizzando il membro dwCommonButtons , nella finestra di dialogo attività verrà visualizzato un singolo pulsante OK .

pButtons

Tipo: const TASKDIALOG_BUTTON*

Puntatore a una matrice di strutture TASKDIALOG_BUTTON contenenti la definizione dei pulsanti personalizzati da visualizzare nella finestra di dialogo attività. Questa matrice deve contenere almeno il numero di voci specificate dal membro cButtons .

nDefaultButton

Tipo: int

Pulsante predefinito per la finestra di dialogo attività. Può trattarsi di uno dei valori specificati nei membri nButtonID di una delle strutture TASKDIALOG_BUTTON nella matrice pButtons oppure uno degli ID corrispondenti ai pulsanti specificati nel membro dwCommonButtons :

IDCANCEL Impostare il pulsante Annulla come predefinito.
IDNO Impostare il pulsante No come predefinito.
IDOK Impostare il pulsante OK come predefinito.
IDRETRY Impostare il pulsante Riprova come predefinito.
IDYES Impostare il pulsante Sì come predefinito.
IDCLOSE Impostare il pulsante Chiudi come predefinito.
 

Se questo membro è zero o il relativo valore non corrisponde ad alcun ID pulsante nella finestra di dialogo, il primo pulsante nella finestra di dialogo sarà il valore predefinito.

cRadioButtons

Tipo: UINT

Numero di voci nella matrice pRadioButtons utilizzata per creare pulsanti di opzione nella finestra di dialogo attività.

pRadioButtons

Tipo: const TASKDIALOG_BUTTON*

Puntatore a una matrice di strutture TASKDIALOG_BUTTON contenenti la definizione dei pulsanti di opzione da visualizzare nella finestra di dialogo attività. Questa matrice deve contenere almeno il numero di voci specificate dal membro cRadioButtons . Questo parametro può essere NULL.

nDefaultRadioButton

Tipo: int

ID pulsante del pulsante di opzione selezionato per impostazione predefinita. Se questo valore non corrisponde a un ID pulsante, il primo pulsante nella matrice viene selezionato per impostazione predefinita.

pszVerificationText

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da usare per etichettare la casella di controllo di verifica. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Se questo parametro è NULL, la casella di controllo di verifica non viene visualizzata nella finestra di dialogo dell'attività. Se il parametro pfVerificationFlagChecked di TaskDialogIndirect è NULL, la casella di controllo non è abilitata.

pszExpandedInformation

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da utilizzare per visualizzare informazioni aggiuntive. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Le informazioni aggiuntive vengono visualizzate immediatamente sotto il contenuto o sotto il testo del piè di pagina a seconda che sia specificato il flag TDF_EXPAND_FOOTER_AREA. Se il flag TDF_ENABLE_HYPERLINKS viene specificato per il membro dwFlags , questa stringa può contenere collegamenti ipertestuali nel formato: <A HREF="executablestring">Hyperlink Text</A>. AVVISO: l'abilitazione dei collegamenti ipertestuali quando si usa contenuto da un'origine non sicura può causare vulnerabilità di sicurezza.

pszExpandedControlText

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da usare per etichettare il pulsante per comprimere le informazioni espandibili. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Questo membro viene ignorato quando il membro pszExpandedInformation è NULL. Se questo membro è NULL e viene specificato pszCollapsedControlText , verrà usato anche il valore pszCollapsedControlText per questo membro.

pszCollapsedControlText

Tipo: PCWSTR

Puntatore che fa riferimento alla stringa da usare per etichettare il pulsante per espandere le informazioni espandibili. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Questo membro viene ignorato quando il membro pszExpandedInformation è NULL. Se questo membro è NULL e viene specificato pszCollapsedControlText , verrà usato anche il valore pszCollapsedControlText per questo membro.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.hFooterIcon

Tipo: HICON

Handle di un'icona da visualizzare nel piè di pagina della finestra di dialogo dell'attività. Questo membro viene ignorato a meno che non venga specificato il flag di TDF_USE_HICON_FOOTER e pszFooterIcon non lo sia. Se questo membro è NULL e viene specificato il TDF_USE_HICON_FOOTER, non viene visualizzata alcuna icona.

DUMMYUNIONNAME2.pszFooterIcon

Tipo: PCWSTR

Puntatore che fa riferimento all'icona da visualizzare nell'area piè di pagina della finestra di dialogo attività. Questo parametro viene ignorato se viene specificato il flag TDF_USE_HICON_FOOTER o se pszFooter è NULL. In caso contrario, se questo parametro è NULL o il parametro hInstance è NULL, non viene visualizzata alcuna icona. Questo parametro deve essere un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE o uno dei valori predefiniti elencati per pszMainIcon.

pszFooter

Tipo: PCWSTR

Puntatore alla stringa da usare nell'area piè di pagina della finestra di dialogo attività. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE . Se il flag TDF_ENABLE_HYPERLINKS viene specificato per il membro dwFlags , questa stringa può contenere collegamenti ipertestuali in questo formato.

<A HREF="executablestring">Hyperlink Text</A>
Avviso L'abilitazione dei collegamenti ipertestuali quando si usa contenuto da un'origine non sicura può causare vulnerabilità di sicurezza.
 

pfCallback

Tipo: PFTASKDIALOGCALLBACK

Puntatore a una funzione di callback definita dall'applicazione. Per altre informazioni, vedere TaskDialogCallbackProc.

lpCallbackData

Tipo: LONG_PTR

Puntatore ai dati di riferimento definiti dall'applicazione. Questo valore è definito dal chiamante.

cxWidth

Tipo: UINT

Larghezza dell'area client del dialogo attività, in unità di dialogo. Se 0, gestione finestre di dialogo attività calcolerà la larghezza ideale.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione commctrl.h