DTBLLBX
Hace referencia a: Outlook 2013 | Outlook 2016
Describe una lista que se usará en un cuadro de diálogo que se compila a partir de una tabla para mostrar.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
typedef struct _DTBLLBX
{
ULONG ulFlags;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX
Members
ulFlags
Máscara de bits de marcas usadas para eliminar una barra de desplazamiento horizontal o vertical de la lista. Se pueden establecer las siguientes marcas:
MAPI_NO_HBAR
No se debe mostrar ninguna barra de desplazamiento horizontal con la lista.
MAPI_NO_VBAR
No se debe mostrar ninguna barra de desplazamiento vertical con la lista.
ulPRSetProperty
Etiqueta de propiedad para una propiedad de cualquier tipo. Esta propiedad es una de las columnas de la tabla identificadas por el miembro ulPRTableTable .
ulPRTableName
Etiqueta de propiedad para una propiedad de tabla de tipo PT_OBJECT que se puede abrir mediante una llamada a OpenProperty . El número de columnas que debe tener la tabla depende de si la lista es una lista de selección única o múltiple. Si el miembro ulPRSetProperty está establecido en PR_NULL (PidTagNull), la lista permite varias selecciones.
Comentarios
Una estructura DTBLLBX describe una lista de un control que se usa para mostrar varios elementos y permitir que un usuario seleccione uno o varios de los elementos.
El miembro ulPRSetProperty y el miembro ulPRTableName funcionan juntos; cuando se elige un valor de la tabla, se vuelve a escribir en ulPRSetProperty cuando se descarta el cuadro de diálogo.
El valor flags indica si se debe mostrar una barra de desplazamiento horizontal o vertical con la lista. El valor predeterminado es que aparezcan tipos de barras de desplazamiento si es necesario. Los proveedores de servicios pueden establecer MAPI_NO_HBAR para suprimir una barra de desplazamiento horizontal y MAPI_NO_VBAR para suprimir una barra de desplazamiento vertical.
Los dos miembros de etiqueta de propiedad trabajan juntos para mostrar los valores de la lista y establecer las propiedades correspondientes cuando se selecciona un elemento de la lista. Cuando MAPI muestra por primera vez la lista, llama al método OpenProperty de la implementación IMAPIProp para recuperar la tabla identificada en el miembro ulPRTableName. El número de columnas de la tabla depende del valor del miembro ulPRSetProperty . Si ulPRSetProperty se establece en PR_NULL, la lista es una lista de selección múltiple basada en un objeto que contiene destinatarios, como un contenedor de libreta de direcciones, una tabla de destinatarios para un mensaje o una tabla de contenido de lista de distribución.
Una tabla para una lista de selección múltiple debe incluir las columnas siguientes:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ENTRYID (PidTagEntryId)
PR_INSTANCE_KEY (PidTagInstanceKey)
PR_DISPLAY_TYPE (PidTagDisplayType) y un máximo de cinco propiedades de cadena multivalor también se pueden mostrar con las tres columnas necesarias.
Si el miembro ulPRSetProperty no está establecido en PR_NULL, la lista es una lista de selección única. El valor inicial de ulPRSetProperty determina la primera fila seleccionada. Cuando un usuario selecciona una de las filas, el miembro ulPRSetProperty se establece en el valor seleccionado y este valor se vuelve a escribir en la implementación de la interfaz de propiedad con una llamada a IMAPIProp::SetProps.
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.