Estructura TASKDIALOGCONFIG (commctrl.h)
La estructura TASKDIALOGCONFIG contiene información utilizada para mostrar un cuadro de diálogo de tareas. La función TaskDialogIndirect usa esta estructura.
Sintaxis
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;
Miembros
cbSize
Tipo: UINT
Especifica el tamaño de la estructura, en bytes.
hwndParent
Tipo: HWND
Identificador de la ventana primaria. Este miembro puede ser NULL.
hInstance
Tipo: HINSTANCE
Identificador del módulo que contiene el recurso de icono identificado por los miembros pszMainIcon o pszFooterIcon , y los recursos de cadena identificados por los miembros pszWindowTitle, pszMainInstruction, pszContent, pszVerificationText, pszExpandedInformation, pszExpandedControlText, pszCollapsedControlText o pszFooter .
dwFlags
Tipo: TASKDIALOG_FLAGS
Especifica el comportamiento del cuadro de diálogo de tarea. Este parámetro puede ser una combinación de marcas del siguiente grupo:
| Valor | Significado |
|---|---|
|
Habilita el procesamiento de hipervínculos para las cadenas especificadas en los miembros pszContent, pszExpandedInformation y pszFooter . Cuando se habilita, estos miembros pueden apuntar a cadenas que contienen hipervínculos de la forma siguiente:Advertencia: La habilitación de hipervínculos al usar contenido de un origen no seguro puede provocar vulnerabilidades de seguridad. Nota Los diálogos de tareas no ejecutarán realmente ningún hipervínculo. La ejecución del hipervínculo debe controlarse en la función de devolución de llamada especificada por pfCallback. Para obtener más información, consulte TaskDialogCallbackProc.
|
|
Indica que el cuadro de diálogo debe usar el icono al que hace referencia el identificador en el miembro hMainIcon como icono principal del cuadro de diálogo de tarea. Si se especifica esta marca, se omite el miembro pszMainIcon . |
|
Indica que el cuadro de diálogo debe usar el icono al que hace referencia el identificador en el miembro hFooterIcon como icono de pie de página en el cuadro de diálogo de tarea. Si se especifica esta marca, se omite el miembro pszFooterIcon . |
|
Indica que el cuadro de diálogo debe poder cerrarse mediante Alt-F4, Escape y el botón cerrar de la barra de título, incluso si no se especifica ningún botón de cancelación en los miembros dwCommonButtons o pButtons . |
|
Indica que los botones especificados en el miembro pButtons se mostrarán como vínculos de comandos (mediante un glifo de diálogo de tareas estándar) en lugar de botones de inserción. Al usar vínculos de comandos, todos los caracteres hasta el primer carácter de línea nuevo del miembro pszButtonText se tratarán como el texto principal del vínculo de comando y el resto se tratará como nota del vínculo de comando. Esta marca se omite si el miembro cButtons es cero. |
|
Indica que los botones especificados en el miembro pButtons se mostrarán como vínculos de comandos (sin glifo) en lugar de botones de inserción. Al usar vínculos de comandos, todos los caracteres hasta el primer carácter de línea nuevo del miembro pszButtonText se tratarán como el texto principal del vínculo de comando y el resto se tratará como nota del vínculo de comando. Esta marca se omite si el miembro cButtons es cero. |
|
Indica que la cadena especificada por el miembro pszExpandedInformation se muestra en la parte inferior del área del pie de página del diálogo en lugar de inmediatamente después del contenido del diálogo. Esta marca se omite si el miembro pszExpandedInformation es NULL. |
|
Indica que la cadena especificada por el miembro pszExpandedInformation se muestra cuando se muestra inicialmente el cuadro de diálogo. Esta marca se omite si el miembro pszExpandedInformation es NULL. |
|
Indica que la casilla de verificación del cuadro de diálogo está activada cuando se muestra inicialmente el cuadro de diálogo. Esta marca se omite si el parámetro pszVerificationText es NULL. |
|
Indica que se va a mostrar una barra de progreso. |
|
Indica que se va a mostrar una barra de progreso de Marquee. |
|
Indica que se llamará a la devolución de llamada del cuadro de diálogo de tarea aproximadamente cada 200 milisegundos. |
|
Indica que el cuadro de diálogo de tarea está colocado (centrado) en relación con la ventana especificada por hwndParent. Si no se proporciona la marca (o no se especifica ningún miembro hwndParent ), el cuadro de diálogo de tarea se coloca (centrado) en relación con el monitor. |
|
Indica que el texto se muestra leyendo de derecha a izquierda. |
|
Indica que no se seleccionará ningún elemento predeterminado. |
|
Indica que se puede minimizar el cuadro de diálogo de tareas. |
|
Esta marca está en desuso. Use TDF_SIZE_TO_CONTENT en su lugar. |
|
Indica que el ancho del cuadro de diálogo de tarea viene determinado por el ancho de su área de contenido. Esta marca se omite si cxWidth no está establecida en 0. |
dwCommonButtons
Tipo: TASKDIALOG_COMMON_BUTTON_FLAGS
Especifica los botones de inserción que se muestran en el cuadro de diálogo de tarea. Si no se especifican botones comunes y no se especifica ningún botón personalizado mediante los miembros cButtons y pButtons , el cuadro de diálogo de tarea contendrá el botón Aceptar de forma predeterminada. Este parámetro puede ser una combinación de marcas del siguiente grupo:
pszWindowTitle
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para el título del cuadro de diálogo de tarea. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . Si este parámetro es NULL, se usa el nombre de archivo del programa ejecutable.
DUMMYUNIONNAME
DUMMYUNIONNAME.hMainIcon
Tipo: HICON
Identificador de un icono que se va a mostrar en el cuadro de diálogo de tareas. Este miembro se omite a menos que se especifique la marca TDF_USE_HICON_MAIN. Si este miembro es NULL y se especifica el TDF_USE_HICON_MAIN, no se mostrará ningún icono.
DUMMYUNIONNAME.pszMainIcon
Tipo: PCWSTR
Puntero que hace referencia al icono que se va a mostrar en el cuadro de diálogo de tareas. Este parámetro se omite si se especifica la marca USE_HICON_MAIN. De lo contrario, si este parámetro es NULL o el parámetro hInstance es NULL, no se mostrará ningún icono. Este parámetro debe ser un identificador de recurso entero pasado a la macro MAKEINTRESOURCE o uno de los siguientes valores predefinidos:
pszMainInstruction
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para la instrucción principal. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE .
pszContent
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para el contenido principal del cuadro de diálogo. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . Si se especifica la marca ENABLE_HYPERLINKS para el miembro dwFlags , esta cadena puede contener hipervínculos con el formato: <A HREF="executablestring">Hyperlink Text</A>. ADVERTENCIA: Habilitar hipervínculos al usar contenido de un origen no seguro puede provocar vulnerabilidades de seguridad.
cButtons
Tipo: UINT
Número de entradas de la matriz pButtons que se usa para crear botones o vínculos de comandos en el cuadro de diálogo de tareas. Si este miembro es cero y no se han especificado botones comunes mediante el miembro dwCommonButtons , el cuadro de diálogo de tarea tendrá un solo botón Aceptar mostrado.
pButtons
Tipo: const TASKDIALOG_BUTTON*
Puntero a una matriz de estructuras de TASKDIALOG_BUTTON que contienen la definición de los botones personalizados que se van a mostrar en el cuadro de diálogo de tarea. Esta matriz debe contener al menos el número de entradas especificadas por el miembro cButtons .
nDefaultButton
Tipo: int
Botón predeterminado para el cuadro de diálogo de tarea. Puede ser cualquiera de los valores especificados en los miembros nButtonID de una de las estructuras de TASKDIALOG_BUTTON de la matriz pButtons o uno de los identificadores correspondientes a los botones especificados en el miembro dwCommonButtons :
| IDCANCEL | Haga que el botón Cancelar sea el valor predeterminado. |
| IDNO | Haga que el botón No sea el valor predeterminado. |
| IDOK | Haga que el botón Aceptar sea el valor predeterminado. |
| IDRETRY | Haga que el botón Reintentar sea el valor predeterminado. |
| IDYES | Haga que el botón Sí sea el valor predeterminado. |
| IDCLOSE | Haga que el botón Cerrar sea el valor predeterminado. |
Si este miembro es cero o su valor no corresponde a ningún identificador de botón en el cuadro de diálogo, el primer botón del cuadro de diálogo será el valor predeterminado.
cRadioButtons
Tipo: UINT
Número de entradas de la matriz pRadioButtons que se usa para crear botones de radio en el cuadro de diálogo de tareas.
pRadioButtons
Tipo: const TASKDIALOG_BUTTON*
Puntero a una matriz de estructuras de TASKDIALOG_BUTTON que contienen la definición de los botones de radio que se van a mostrar en el cuadro de diálogo de tarea. Esta matriz debe contener al menos el número de entradas especificadas por el miembro cRadioButtons . Este parámetro puede ser NULL.
nDefaultRadioButton
Tipo: int
El identificador de botón del botón de radio seleccionado de forma predeterminada. Si este valor no corresponde a un identificador de botón, el primer botón de la matriz se selecciona de forma predeterminada.
pszVerificationText
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para etiquetar la casilla de verificación. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . Si este parámetro es NULL, la casilla de verificación no se muestra en el cuadro de diálogo de tarea. Si el parámetro pfVerificationFlagChecked de TaskDialogIndirect es NULL, la casilla no está habilitada.
pszExpandedInformation
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para mostrar información adicional. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . La información adicional se muestra inmediatamente debajo del contenido o debajo del texto del pie de página en función de si se especifica la marca TDF_EXPAND_FOOTER_AREA. Si se especifica la marca TDF_ENABLE_HYPERLINKS para el miembro dwFlags , esta cadena puede contener hipervínculos con el formato: <A HREF="executablestring">Hyperlink Text</A>. ADVERTENCIA: Habilitar hipervínculos al usar contenido de un origen no seguro puede provocar vulnerabilidades de seguridad.
pszExpandedControlText
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para etiquetar el botón para contraer la información expandible. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . Este miembro se omite cuando el miembro pszExpandedInformation es NULL. Si este miembro es NULL y se especifica pszCollapsedControlText , también se usará el valor pszCollapsedControlText para este miembro.
pszCollapsedControlText
Tipo: PCWSTR
Puntero que hace referencia a la cadena que se va a usar para etiquetar el botón para expandir la información expandible. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . Este miembro se omite cuando el miembro pszExpandedInformation es NULL. Si este miembro es NULL y se especifica pszCollapsedControlText , también se usará el valor pszCollapsedControlText para este miembro.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.hFooterIcon
Tipo: HICON
Identificador de un icono que se va a mostrar en el pie de página del cuadro de diálogo de tarea. Este miembro se omite a menos que se especifique la marca de TDF_USE_HICON_FOOTER y pszFooterIcon no lo sea. Si este miembro es NULL y se especifica el TDF_USE_HICON_FOOTER, no se muestra ningún icono.
DUMMYUNIONNAME2.pszFooterIcon
Tipo: PCWSTR
Puntero que hace referencia al icono que se va a mostrar en el área de pie de página del cuadro de diálogo de tarea. Este parámetro se omite si se especifica la marca TDF_USE_HICON_FOOTER o si pszFooter es NULL. De lo contrario, si este parámetro es NULL o el parámetro hInstance es NULL, no se muestra ningún icono. Este parámetro debe ser un identificador de recurso entero pasado a la macro MAKEINTRESOURCE o uno de los valores predefinidos enumerados para pszMainIcon.
pszFooter
Tipo: PCWSTR
Puntero a la cadena que se va a usar en el área de pie de página del cuadro de diálogo de tarea. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE . Si se especifica la marca TDF_ENABLE_HYPERLINKS para el miembro dwFlags , esta cadena puede contener hipervínculos en este formato.
<A HREF="executablestring">Hyperlink Text</A>
pfCallback
Tipo: PFTASKDIALOGCALLBACK
Puntero a una función de devolución de llamada definida por la aplicación. Para obtener más información, vea TaskDialogCallbackProc.
lpCallbackData
Tipo: LONG_PTR
Puntero a los datos de referencia definidos por la aplicación. El autor de la llamada define este valor.
cxWidth
Tipo: UINT
Ancho del área cliente del cuadro de diálogo de tareas, en unidades de diálogo. Si es 0, el administrador de diálogos de tareas calculará el ancho ideal.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | commctrl.h |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de