SSortOrder
Aplica-se a: Outlook 2013 | Outlook 2016
Define como classificar as linhas de uma tabela, qual coluna usar como a chave de classificação e a direção do tipo.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
typedef struct _SSortOrder
{
ULONG ulPropTag;
ULONG ulOrder;
} SSortOrder, FAR *LPSSortOrder;
Members
Ulproptag
Marca de propriedade que identifica a chave de classificação ou, para uma classificação categorizada, a coluna de categoria.
ulOrder
A ordem na qual os dados devem ser classificados. Os valores possíveis são os seguintes:
TABLE_SORT_ASCEND: a tabela deve ser classificada em ordem crescente.
TABLE_SORT_COMBINE: a operação de classificação deve criar uma categoria que combine a propriedade identificada como a coluna de chave de classificação no membro ulPropTag com a coluna de chave de classificação especificada na estrutura SSortOrder anterior.
TABLE_SORT_COMBINE só pode ser usado quando a estrutura SSortOrder está sendo usada como uma entrada em uma estrutura SSortOrderSet para especificar vários pedidos de classificação para uma classificação categorizada. TABLE_SORT_COMBINE não pode ser usado na primeira estrutura SSortOrder em uma estrutura SSortOrderSet .
TABLE_SORT_DESCEND: a tabela deve ser classificada em ordem decrescente.
TABLE_SORT_CATEG_MAX: a tabela deve ser classificada no valor máximo do membro ulPropTag para as linhas de dados nas categorias especificadas pela ordem de classificação anterior na estrutura SSortOrderSet .
TABLE_SORT_CATEG_MIN: a tabela deve ser classificada no valor mínimo do membro ulPropTag para as linhas de dados nas categorias especificadas pela ordem de classificação anterior na estrutura no SSortOrderSet .
Comentários
Uma estrutura SSortOrder é usada para descrever como executar uma operação de classificação padrão ou uma operação de classificação categorizada. As estruturas SSortOrder normalmente são combinadas em uma estrutura SSortOrderSet para descrever várias chaves de classificação e direções. As estruturas SSortOrderSet são usadas nas seguintes funções e métodos de interface:
O intervalo de colunas permitidas em uma tabela que pode ser usada como uma chave de classificação depende do provedor. Colunas que fazem parte do conjunto de colunas atual sempre podem ser usadas como chaves de classificação. No entanto, cada provedor determina se as chaves de classificação podem ser definidas usando colunas disponíveis que não estão no conjunto de colunas atual. Uma coluna disponível é uma coluna que é retornada de IMAPITable::QueryColumns quando o sinalizador TBL_ALL_COLUMNS é definido.
O membro ulOrder indica informações de ordem direcional e categorização, por exemplo, por conversa (PidTagConversationTopic), ou seja, thread de conversa, que é uma série de mensagens e respostas. As linhas podem ser classificadas em uma sequência crescente ou descendente com todas as entradas NULL posicionadas por último.
O valor TABLE_SORT_COMBINE indica que a coluna especificada em ulPropTag deve ser combinada com a coluna de categoria anterior para formar uma categoria composta. Ou seja, em vez de categorizar em valores exclusivos de colunas individuais, TABLE_SORT_COMBINE permite categorização em valores exclusivos de uma combinação de colunas. Por exemplo, uma única categoria poderia ser definida para agrupar mensagens recebidas de um remetente específico em um determinado assunto. Definir o valor como TABLE_SORT_COMBINE reduz o número de linhas de categoria exibidas.
A classificação em colunas com vários valores não tem suporte universal para todas as implementações de tabela. Se houver suporte, aplique o MV_FLAG usando a macro MVI_PROP à marca de propriedade no membro ulPropTag para identificar a chave de classificação como uma coluna de vários valores. A classificação em uma coluna com vários valores baseia-se no uso dos valores individuais.
Importante
Os valores de membro ulOrder TABLE_SORT_CATEG_MAX e TABLE_SORT_CATEG_MIN podem não ser definidos no arquivo de cabeçalho para download que você tem atualmente, nesse caso, você pode adicioná-lo ao código usando os seguintes 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 obter mais informações sobre classificação padrão e categorizada, consulte Classificação e Categorização.