SSortOrderSet
Aplica-se a: Outlook 2013 | Outlook 2016
Define uma coleção de chaves de classificação para uma tabela usada para classificação padrão ou categorizada.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
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
Contagem de estruturas SSortOrder incluídas no membro do aSort .
Ccategories
Contagem de colunas designadas como colunas de categoria. Os valores possíveis variam de zero, o que indica uma classificação não categorizada ou padrão, até o número indicado pelo membro cSorts .
cExpanded
Contagem de categorias que começam em um estado expandido, em que todas as linhas aplicadas à categoria estão visíveis no modo de exibição da tabela. Os valores possíveis variam de 0 até o número indicado por cCategories.
aSort
Matriz de estruturas SSortOrder , cada uma definindo uma ordem de classificação.
Comentários
Uma estrutura SSortOrderSet é usada para definir vários pedidos de classificação para classificação padrão e categorizada.
Cada estrutura SSortOrderSet contém pelo menos uma estrutura SSortOrder definindo a direção do tipo e a coluna que será usada como a chave de classificação. Para classificação categorizada, esta coluna é usada como a categoria. Quando o valor do membro cSorts excede o valor do membro cCategories , há mais chaves de classificação do que categorias e as categorias são criadas a partir das colunas que aparecem primeiro na matriz SSortOrder .
Por exemplo, se cSorts for definido como 3 e cCategories for definido como 2, as colunas descritas pelo membro ulPropTag das duas primeiras entradas na matriz SSortOrder serão usadas como colunas de categoria. A primeira entrada serve como o agrupamento de categorias de nível superior; a segunda entrada como o agrupamento secundário. Todas as linhas que correspondem às duas colunas de categoria são classificadas usando a chave de classificação definida na terceira entrada.
O membro cExpanded especifica o número de categorias expandidas inicialmente. Quando há várias categorias, a implementação da tabela começa com a primeira coluna a ser designada como uma categoria e continua em ordem sequencial com as colunas de categoria subsequentes até que o número de cCategories seja excedido. Se houver mais colunas de categoria do que colunas expandidas, as colunas de categoria serão recolhidas. Se cExpanded for igual a zero, somente a linha de título de nível superior estará disponível para o usuário da tabela para exibição. Se cExpanded for igual a um menor que o número de categorias, todas as linhas de título e nenhuma das linhas de folhas estarão disponíveis. Se cExpanded for igual ao número de categorias, a tabela será totalmente expandida.
Para obter mais informações sobre classificação padrão e categorizada, consulte Classificação e Categorização.