DTBLDDLBX
Hace referencia a: Outlook 2013 | Outlook 2016
Describe un control de lista desplegable que se usará en un cuadro de diálogo creado a partir de una tabla para mostrar.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
typedef struct _DTBLDDLBX
{
ULONG ulFlags;
ULONG ulPRDisplayProperty;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;
Members
ulFlags
Reservado, debe ser cero.
ulPRDisplayProperty
Etiqueta de propiedad para una propiedad de tipo PT_TSTRING. Esta propiedad es una de las columnas de la tabla identificada por el miembro ulPRTableName . Los valores de esta propiedad se muestran en la lista.
ulPRSetProperty
Etiqueta de propiedad para una propiedad de cualquier tipo. Esta propiedad es una de las columnas de la tabla identificada por el miembro ulPRTableName . Cuando el usuario de la lista selecciona un valor de propiedad para el miembro ulPRDisplayProperty de las filas de la tabla identificadas por el miembro ulPRTableName , se establece el miembro ulPRSetProperty correspondiente.
ulPRTableName
Etiqueta de propiedad para una propiedad de tabla de tipo PT_OBJECT que se puede abrir mediante una llamada a OpenProperty . La tabla debe tener dos columnas: ulPRDisplayProperty y ulPRSetProperty. Las filas de la tabla deben corresponder a los elementos de la lista.
Comentarios
Una estructura DTBLDDLBX describe un control de lista desplegable que se muestra como un solo elemento hasta que el usuario decide expandirlo.
Las tres propiedades identificadas por las etiquetas de propiedad funcionan juntas para mostrar la información de la lista y establecer una propiedad relacionada. El miembro ulPRTableName es un objeto de tabla al que se accede a través de una llamada a IMAPIProp::OpenProperty. La tabla tiene dos columnas: una columna para la propiedad identificada por el miembro ulPRDisplayProperty y la otra para la propiedad identificada por el miembro ulPRSetProperty .
La propiedad ulPRDisplayProperty controla la visualización de la lista. Cuando un usuario selecciona uno de los valores de la pantalla, MAPI llama a IMAPIProp::SetProps para establecer la propiedad correspondiente tal y como identifica el miembro ulPRSetProperty . Esto significa que la propiedad de la misma fila que la propiedad de presentación seleccionada. El miembro ulPRSetProperty no se puede establecer en PR_NULL (PidTagNull).
Se muestra un valor inicial en la lista si MAPI ha recuperado la propiedad representada por el miembro ulPRSetProperty mediante una llamada a IMAPIProp::GetProps y ha ubicado una fila en la tabla con el valor del miembro ulPRSetProperty . El valor inicial mostrado es el contenido de la columna ulPRDisplayProperty de esa fila que coincide con la propiedad en el miembro ulPRDisplayProperty de la estructura. El valor devuelto por GetProps para la propiedad identificada por el miembro ulPRDisplayProperty se convierte en el valor inicial que se muestra cuando se muestra la lista por primera vez.
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.