SSortOrder
Hace referencia a: Outlook 2013 | Outlook 2016
Define cómo ordenar las filas de una tabla, qué columna usar como clave de ordenación y la dirección de la ordenación.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
typedef struct _SSortOrder
{
ULONG ulPropTag;
ULONG ulOrder;
} SSortOrder, FAR *LPSSortOrder;
Members
ulPropTag
Etiqueta de propiedad que identifica la clave de ordenación o, para una ordenación categorizada, la columna de categoría.
ulOrder
Orden en el que se van a ordenar los datos. Los valores posibles son los siguientes:
TABLE_SORT_ASCEND: la tabla debe ordenarse en orden ascendente.
TABLE_SORT_COMBINE: La operación de ordenación debe crear una categoría que combine la propiedad identificada como columna de clave de ordenación en el miembro ulPropTag con la columna de clave de ordenación especificada en la estructura SSortOrder anterior.
TABLE_SORT_COMBINE solo se puede usar cuando la estructura SSortOrder se usa como entrada en una estructura SSortOrderSet para especificar varios pedidos de ordenación para una ordenación por categorías. TABLE_SORT_COMBINE no se puede usar en la primera estructura SSortOrder de una estructura SSortOrderSet .
TABLE_SORT_DESCEND: la tabla debe ordenarse en orden descendente.
TABLE_SORT_CATEG_MAX: La tabla debe ordenarse según el valor máximo del miembro ulPropTag para las filas de datos de las categorías especificadas por el criterio de ordenación anterior en la estructura SSortOrderSet .
TABLE_SORT_CATEG_MIN: La tabla debe ordenarse según el valor mínimo del miembro ulPropTag para las filas de datos de las categorías especificadas por el criterio de ordenación anterior en la estructura de SSortOrderSet .
Comentarios
Se usa una estructura SSortOrder para describir cómo realizar una operación de ordenación estándar o una operación de ordenación por categorías. Las estructuras SSortOrder se combinan normalmente en una estructura SSortOrderSet para describir varias claves de ordenación e instrucciones. Las estructuras SSortOrderSet se usan en las siguientes funciones y métodos de interfaz:
El intervalo de columnas permitidas en una tabla que se puede usar como clave de ordenación depende del proveedor. Las columnas que forman parte del conjunto de columnas actual siempre se pueden usar como claves de ordenación. Sin embargo, cada proveedor determina si las claves de ordenación se pueden definir mediante columnas disponibles que no están en el conjunto de columnas actual. Una columna disponible es una columna que se devuelve de IMAPITable::QueryColumns cuando se establece la marca de TBL_ALL_COLUMNS.
El miembro ulOrder indica tanto el orden direccional como la información de categorización, por ejemplo, por conversación (PidTagConversationTopic), es decir, subproceso conversacional, que es una serie de mensajes y respuestas. Las filas se pueden ordenar en una secuencia ascendente o descendente con todas las entradas NULL colocadas en último lugar.
El valor TABLE_SORT_COMBINE indica que la columna especificada en ulPropTag debe combinarse con la columna de categoría anterior para formar una categoría compuesta. Es decir, en lugar de clasificar en valores únicos de columnas individuales, TABLE_SORT_COMBINE permite la categorización en valores únicos de una combinación de columnas. Por ejemplo, se podría definir una sola categoría para agrupar los mensajes recibidos de un remitente determinado en un asunto determinado. Al establecer el valor en TABLE_SORT_COMBINE se reduce el número de filas de categorías que se muestran.
La ordenación en columnas con varios valores no es compatible universalmente con todas las implementaciones de tabla. Si se admite, aplique el MV_FLAG mediante la macro MVI_PROP a la etiqueta de propiedad del miembro ulPropTag para identificar la clave de ordenación como una columna con varios valores. La ordenación en una columna de varios valores se basa en el uso de los valores individuales.
Importante
Es posible que los valores de miembro ulOrder TABLE_SORT_CATEG_MAX y TABLE_SORT_CATEG_MIN no se definan en el archivo de encabezado descargable que tiene actualmente, en cuyo caso puede agregarlo al código mediante los siguientes valores:
#ifndef TABLE_SORT_CATEG_MAX
#define TABLE_SORT_CATEG_MAX ((ULONG) 0x00000004)
#endif
#ifndef TABLE_SORT_CATEG_MIN
#define TABLE_SORT_CATEG_MIN ((ULONG) 0x00000008)
#endif
Para obtener más información sobre la ordenación estándar y por categorías, vea Ordenar y categorizar.