Propiedad canónica PidTagControlFlags
Hace referencia a: Outlook 2013 | Outlook 2016
Contiene una máscara de bits de marcas que rigen el comportamiento de un control usado en un cuadro de diálogo creado a partir de una tabla para mostrar.
| Propiedad | Valor |
|---|---|
| Propiedades asociadas: |
PR_CONTROL_FLAGS |
| Identificador: |
0x3F00 |
| Tipo de datos: |
PT_LONG |
| Área: |
Tabla de presentación MAPI |
Comentarios
Se pueden establecer una o varias de las siguientes marcas para esta propiedad:
DT_ACCEPT_DBCS
El control puede tener Double-Byte caracteres de conjunto de caracteres (DBCS). Esta marca se usa con controles de edición. Permite conjuntos de caracteres de varios bytes.
DT_EDITABLE
El control se puede editar; el valor asociado al control se puede cambiar. Cuando no se establece esta marca, el control es de solo lectura. Este valor se omite en los controles label, group box, standard push button, multivalued drop down list box y list box.
DT_MULTILINE
El control de edición puede contener varias líneas. Esto significa que se puede escribir un carácter devuelto dentro del control. Esta marca solo es válida para los controles de edición.
DT_PASSWORD_EDIT
Se aplica a los controles de edición. El control de edición se trata como una contraseña. El valor se muestra con asteriscos en lugar de hacer eco de los caracteres reales especificados.
DT_REQUIRED
Si el control permite cambios (DT_EDITABLE), debe tener un valor antes de llamar a IMAPIProp::SaveChanges .
DT_SET_IMMEDIATE
Habilita la configuración inmediata de un valor; en cuanto cambia un valor del control, MAPI llama al método SetProps para la propiedad asociada a ese control. Cuando no se establece esta marca, los valores se establecen cuando se descarta el cuadro de diálogo.
DT_SET_SELECTION
Cuando se realiza una selección dentro del cuadro de lista, la columna de índice de ese cuadro de lista se establece como una propiedad. Siempre se usa con DT_SET_IMMEDIATE.
Esta propiedad se almacena en el miembro ulCtlFlags de la estructura DTCTL de un control. La mayoría de las marcas de control se aplican a todos los controles que permiten la entrada del usuario; algunos solo se aplican al control de edición. Los controles que no permiten la entrada del usuario, como un botón o una etiqueta, establecen 0 para sus marcas de control.
Muchos de los valores de marca se explican por sí mismos. Por ejemplo, cuando se establece DT_REQUIRED para un control, debe contener un valor antes de que se permita descartar el cuadro de diálogo. El proveedor de servicios puede proporcionar un valor a través de su implementación IMAPIProp o el usuario puede escribir uno. DT_EDITABLE indica que se puede modificar el valor del control. DT_MULTILINE permite que el valor de un control de edición abarque varias líneas.
Algunas marcas de control no son tan obvias en su significado. Cuando un control establece la marca de DT_SET_IMMEDIATE, los cambios en su valor se verán afectados en cuanto el usuario se mueva a un nuevo control. MAPI realiza una única llamada al método IMAPIProp::SetProps de la interfaz de propiedad para la propiedad del control. Esto es diferente del comportamiento predeterminado, que consiste en posponer que los cambios en los valores de control surtan efecto hasta que el usuario selecciona el botón Aceptar o descarta el cuadro de diálogo. La marca de DT_SET_IMMEDIATE se usa a menudo en combinación con las notificaciones de tabla para mostrar.
En la tabla siguiente se enumeran los tipos de controles y todos los valores de marca que se pueden establecer para cada tipo.
| Control | Valores válidos para esta propiedad |
|---|---|
| Botón |
Debe ser cero |
| Casilla |
DT_EDITABLE, DT_SET_IMMEDIATE |
| Cuadro combinado |
DT_EDITABLE, DT_REQUIRED, DT_SET_IMMEDIATE |
| Cuadro de lista desplegable |
DT_EDITABLE, DT_SET_IMMEDIATE |
| Editar |
DT_ACCEPT_DBCS, DT_MULTILINE, DT_EDITABLE, DT_PASSWORD_EDIT, DT_REQUIRED, DT_SET_IMMEDIATE |
| Cuadro de grupo |
Debe ser cero |
| Etiqueta |
Debe ser cero |
| Cuadro de lista |
Debe ser cero |
| Cuadro de lista desplegable multivalor |
Debe ser cero |
| Cuadro de lista multivalor |
Debe ser cero |
| Página con pestañas |
Debe ser cero |
| Botón de radio |
Debe ser cero |
Recursos relacionados
Archivos de encabezado
Mapidefs.h
Proporciona definiciones de tipo de datos.
Mapitags.h
Contiene definiciones de propiedades enumeradas como nombres alternativos.