DTBLCOMBOBOX

Hace referencia a: Outlook 2013 | Outlook 2016

Describe un control de cuadro combinado 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: SizedDtblComboBox

typedef struct _DTBLCOMBOBOX
{
  ULONG ulbLpszCharsAllowed;
  ULONG ulFlags;
  ULONG ulNumCharsAllowed;
  ULONG ulPRPropertyName;
  ULONG ulPRTableName;
} DTBLCOMBOBOX, FAR *LPDTBLCOMBOBOX;

Members

ulbLpszCharsAllowed

Desplazamiento desde el inicio de la estructura DTBLCOMBOBOX hasta un filtro de cadena de caracteres que describe las restricciones, si las hubiera, a los caracteres que se pueden escribir en el control de edición del cuadro combinado. El filtro no se interpreta como una expresión regular y el mismo filtro se aplica a todos los caracteres especificados. El formato del filtro es el siguiente:

Carácter	Descripción
*	Se permite cualquier carácter (por ejemplo, "*").
[ ]	Define un conjunto de caracteres (por ejemplo, "[0123456789]").
-	Indica un intervalo de caracteres (por ejemplo, "[a-z]").
~	Indica que no se permiten estos caracteres. (por ejemplo, "[~0-9]").
\	Se usa para citar cualquiera de los símbolos anteriores (por ejemplo, "[\-\\\[\]]" significa que se permiten caracteres -, , [y ]).

ulFlags

Máscara de bits de marcas usadas para designar el formato del filtro de cadena de caracteres. Se puede establecer la marca siguiente:

MAPI_UNICODE

El filtro está en formato Unicode. Si no se establece la marca de MAPI_UNICODE, el filtro está en formato ANSI.

ulNumCharsAllowed

Número máximo de caracteres que se pueden escribir en el cuadro de texto del cuadro combinado.

ulPRPropertyName

Etiqueta de propiedad para una propiedad de tipo PT_TSTRING.

ulPRTableName

Etiqueta de propiedad de una propiedad de tipo PT_OBJECT en la que se puede abrir una interfaz IMAPITable mediante una llamada a OpenProperty . La tabla debe tener una columna con una propiedad que sea del mismo tipo que la propiedad identificada por el miembro ulPRPropertyName . Las filas de la tabla se usan para rellenar la lista.

Comentarios

Una estructura DTBLCOMBOBOX describe un cuadro combinado un control que consta de una lista y un campo de selección. La lista presenta la información desde la que un usuario puede seleccionar y el campo de selección muestra la selección actual. El campo de selección es un control de edición que también se puede usar para escribir texto que aún no está en la lista.

Los dos miembros de etiqueta de propiedad trabajan juntos para coordinar la visualización de la lista con el control de edición. Cuando MAPI muestra por primera vez el cuadro combinado, llama al método OpenProperty de la implementación IMAPIProp asociada a la tabla para mostrar para recuperar la tabla representada por el miembro ulPRTableName . Esta tabla tiene una columna una columna que contiene valores para la propiedad representada por el miembro ulPRPropertyName . Por lo tanto, esta columna debe ser del mismo tipo que la propiedad ulPRPropertyName y ambas columnas deben ser cadenas de caracteres.

Los valores de la columna se muestran en la sección de lista del cuadro combinado. Por lo tanto, PR_NULL (PidTagNull) no es una etiqueta de propiedad válida para ulPRPropertyName. Cuando un usuario selecciona una de las filas o escribe nuevos datos en el cuadro de texto, la propiedad ulPRPropertyName se establece en el valor seleccionado o especificado.

Para mostrar un valor inicial para el control de edición, MAPI llama a IMAPIProp::GetProps para recuperar los valores de propiedad de la tabla para mostrar. Si una de las propiedades recuperadas coincide con la propiedad representada por el miembro ulPRPropertyName , su valor se convierte en el valor inicial.

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.

Vea también

DTCTL
Estructuras MAPI de propiedad canónica PidTagControlType