DTBLCHECKBOX
Hace referencia a: Outlook 2013 | Outlook 2016
Contiene información sobre una casilla que se usará en un cuadro de diálogo creado a partir de una tabla para mostrar.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Macro relacionada: |
SizedDtblCheckBox |
typedef struct _DTBLCHECKBOX
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;
Members
ulbLpszLabel
Posición en memoria de la cadena de caracteres que se muestra con la casilla de verificación.
ulFlags
Máscara de bits de marcas usadas para designar el formato de la etiqueta de casilla. Se puede establecer la marca siguiente:
MAPI_UNICODE
La etiqueta está en formato Unicode. Si no se establece la marca de MAPI_UNICODE, la etiqueta está en formato ANSI.
ulPRPropertyName
Etiqueta de propiedad para una propiedad de tipo PT_BOOLEAN. El valor de esta propiedad se ve afectado por el estado de la casilla.
Comentarios
Una estructura DTBLCHECKBOX describe una casilla de verificación un control que refleja uno de los dos estados: habilitado (una casilla activada) o deshabilitado (una casilla vacía).
El miembro ulPRPropertyName describe una propiedad booleana cuyo valor se manipula cambiando el estado de la casilla. Cuando se muestra la casilla por primera vez, MAPI llama al método GetProps de la implementación IMAPIProp asociada a la tabla para mostrar para recuperar un conjunto de propiedades predeterminadas. Si una de las propiedades se asigna a la etiqueta de propiedad en la estructura DTBLCHECKBOX , el valor de esa propiedad se muestra como el valor inicial de la casilla.
Los controles de casilla pueden ser modificables. Esto permite a un usuario cambiar sus estados. Las casillas modificables establecen la marca de DT_EDITABLE en el miembro ulCtlFlags de su estructura DTCTL y en su propiedad PR_CONTROL_FLAGS (PidTagControlFlags). Cuando una casilla cambia su estado, MAPI llama a IMAPIProp::SetProps para establecer la propiedad identificada en el miembro de etiqueta de propiedad de la estructura DTBLCHECKBOX en el nuevo estado.
Por ejemplo, un proveedor de libreta de direcciones podría incluir un control de casilla modificable en su cuadro de diálogo de configuración para ajustar la configuración de la propiedad PR_SEND_RICH_INFO de un destinatario (PidTagSendRichInfo). Cuando el usuario activa la casilla, MAPI establece esta propiedad en TRUE. Cuando la casilla no está seleccionada, la propiedad se establece en FALSE.
Para obtener información general sobre las tablas para mostrar, vea Mostrar tablas. Para obtener información sobre cómo implementar una tabla para mostrar, consulte Implementación de una tabla para mostrar. Para obtener información sobre los tipos de propiedad, vea Información general sobre el tipo de propiedad MAPI.