SSortOrderSet
Hace referencia a: Outlook 2013 | Outlook 2016
Define una colección de claves de ordenación para una tabla que se usa para la ordenación estándar o por categorías.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Macros relacionadas: |
CbNewSSortOrderSet, CbSSortOrderSet, SizedSSortOrderSet |
typedef struct _SSortOrderSet
{
ULONG cSorts;
ULONG cCategories;
ULONG cExpanded;
SSortOrder aSort[MAPI_DIM];
} SSortOrderSet, FAR *LPSSortOrderSet;
Members
cSorts
Recuento de estructuras SSortOrder que se incluyen en el miembro de aSort .
cCategories
Recuento de columnas que se designan como columnas de categoría. Los valores posibles van desde cero, que indica una ordenación estándar o no categorizada, hasta el número indicado por el miembro cSorts .
cExpanded
Recuento de categorías que comienzan en un estado expandido, donde todas las filas que se aplican a la categoría están visibles en la vista de tabla. Los valores posibles oscilan entre 0 y el número indicado por cCategories.
aSort
Matriz de estructuras SSortOrder , cada una de las cuales define un criterio de ordenación.
Comentarios
Se usa una estructura SSortOrderSet para definir varios pedidos de ordenación para la ordenación estándar y por categorías.
Cada estructura SSortOrderSet contiene al menos una estructura SSortOrder que define la dirección de la ordenación y la columna que se usará como clave de ordenación. Para la ordenación por categorías, esta columna se usa como categoría. Cuando el valor del miembro cSorts supera el valor del miembro cCategories , hay más claves de ordenación que categorías y las categorías se crean a partir de las columnas que aparecen primero en la matriz SSortOrder .
Por ejemplo, si cSorts se establece en 3 y cCategories se establece en 2, las columnas descritas por el miembro ulPropTag de las dos primeras entradas de la matriz SSortOrder se usan como columnas de categoría. La primera entrada actúa como agrupación de categorías de nivel superior; la segunda entrada como agrupación secundaria. Todas las filas que coinciden con las dos columnas de categoría se ordenan mediante la clave de ordenación definida en la tercera entrada.
El miembro cExpanded especifica el número de categorías que se expanden al principio. Cuando hay varias categorías, la implementación de la tabla comienza con la primera columna que se va a designar como categoría y continúa en orden secuencial con las columnas de categoría posteriores hasta que se supera el número de cCategories . Si hay más columnas de categoría que columnas expandidas, las columnas de categoría se contraen. Si cExpanded es igual a cero, solo la fila de encabezado de nivel superior está disponible para que se muestre el usuario de la tabla. Si cExpanded es igual a uno menor que el número de categorías, todas las filas de encabezado y ninguna de las filas hoja están disponibles. Si cExpanded es igual al número de categorías, la tabla se expande completamente.
Para obtener más información sobre la ordenación estándar y por categorías, vea Ordenar y categorizar.