Funzione TaskDialogIndirect (commctrl.h)

Articolo
2024-02-24

La funzione TaskDialogIndirect crea, visualizza e gestisce una finestra di dialogo attività. La finestra di dialogo attività contiene icone definite dall'applicazione, messaggi, titolo, casella di controllo di verifica, collegamenti di comando, pulsanti di scelta e pulsanti di opzione. Questa funzione può registrare una funzione di callback per ricevere messaggi di notifica.

Sintassi

HRESULT TaskDialogIndirect(
  [in]            const TASKDIALOGCONFIG *pTaskConfig,
  [out, optional] int                    *pnButton,
  [out, optional] int                    *pnRadioButton,
  [out, optional] BOOL                   *pfVerificationFlagChecked
);

Parametri

[in] pTaskConfig

Tipo: const TASKDIALOGCONFIG*

Puntatore a una struttura TASKDIALOGCONFIG contenente informazioni utilizzate per visualizzare la finestra di dialogo attività.

[out, optional] pnButton

Tipo: int*

Indirizzo di una variabile che riceve:

uno degli ID pulsante specificati nel membro pButtons del parametro pTaskConfig
uno dei valori seguenti:

Valore	Descrizione
0	Chiamata di funzione non riuscita. Per altre informazioni, fare riferimento al valore restituito.
IDCANCEL	Il pulsante Annulla è stato selezionato, è stato premuto ALT-F4, Escape è stato premuto o l'utente ha fatto clic sul pulsante della finestra di chiusura .
IDNO	Nessun pulsante selezionato.
IDOK	È stato selezionato il pulsante OK.
IDRETRY	È stato selezionato il pulsante Riprova.
IDYES	È stato selezionato il pulsante Sì.

Se questo parametro è NULL, non viene restituito alcun valore.

[out, optional] pnRadioButton

Tipo: int*

Indirizzo di una variabile che riceve uno degli ID pulsante specificati nel membro pRadioButtons del parametro pTaskConfig . Se questo parametro è NULL, non viene restituito alcun valore.

[out, optional] pfVerificationFlagChecked

Tipo: BOOL*

Indirizzo di una variabile che riceve uno dei valori seguenti.

Valore	Descrizione
TRUE	La casella di controllo verifica è stata selezionata quando la finestra di dialogo è stata chiusa.
FALSE	La casella di controllo verifica non è stata selezionata quando la finestra di dialogo è stata chiusa.

Se questo parametro è NULL, la casella di controllo di verifica è disabilitata.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione riuscita.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_INVALIDARG	Uno o più argomenti non sono validi.
E_FAIL	Operazione non riuscita.

Commenti

Quando si utilizza una finestra di dialogo attività per indicare che la memoria del sistema è insufficiente, le stringhe a cui puntano i vari membri stringa e icona nella struttura TASKDIALOGCONFIG non devono essere ricavate da un file di risorse perché un tentativo di caricamento della risorsa potrebbe non riuscire.

Se si crea una finestra di dialogo attività mentre è presente una finestra di dialogo, usare un handle per la finestra di dialogo come parametro hWndParent . Il parametro hWndParent non deve identificare una finestra figlio, ad esempio un controllo in una finestra di dialogo.

La finestra padre non deve essere nascosta o disabilitata quando questa funzione viene chiamata.


int nButtonPressed                  = 0;
TASKDIALOGCONFIG config             = {0};
const TASKDIALOG_BUTTON buttons[]   = { 
                                        { IDOK, L"Change password" }
                                      };
config.cbSize                       = sizeof(config);
config.hInstance                    = hInst;
config.dwCommonButtons              = TDCBF_CANCEL_BUTTON;
config.pszMainIcon                  = TD_WARNING_ICON;
config.pszMainInstruction           = L"Change Password";
config.pszContent                   = L"Remember your changed password.";
config.pButtons                     = buttons;
config.cButtons                     = ARRAYSIZE(buttons);

TaskDialogIndirect(&config, &nButtonPressed, NULL, NULL);
switch (nButtonPressed)
{
    case IDOK:
        break; // the user pressed button 0 (change password).
    case IDCANCEL:
        break; // user canceled the dialog
    default:
        break; // should never happen
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h (include Commctrl.h)
Libreria	Comctl32.lib
DLL	Comctl32.dll (versione 6)

Vedi anche

Finestre di dialogo

Condividi tramite