Método IVsTaskList.RegisterCustomCategory (Guid, UInt32, VSTASKCATEGORY )

Artigo
06/13/2016

Registra uma categoria personalizada com a lista de tarefas.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int RegisterCustomCategory(
    ref Guid guidCat,
    uint dwSortOrder,
    VSTASKCATEGORY[] pCat
)

int RegisterCustomCategory(
    Guid% guidCat,
    unsigned int dwSortOrder,
    array<VSTASKCATEGORY>^ pCat
)

abstract RegisterCustomCategory : 
        guidCat:Guid byref *
        dwSortOrder:uint32 *
        pCat:VSTASKCATEGORY[] -> int

Function RegisterCustomCategory (
    ByRef guidCat As Guid,
    dwSortOrder As UInteger,
    pCat As VSTASKCATEGORY()
) As Integer

Parâmetros

guidCat
[in] GUID da categoria personalizada que você deseja registrar.

dwSortOrder
[in] O posicionamento de classificação solicitada dentro de VSTASKCATEGORY para a categoria personalizada.

pCat
[out] Ponteiro para a colocação de classificação real da categoria personalizada dentro de VSTASKCATEGORY.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsTaskList::RegisterCustomCategory(
   REFGUID guidCat,
   [in] DWORD dwSortOrder,
   [out] VSTASKCATEGORY *pCat
);

Cada categoria personalizada deve ter seu próprio GUID.O dwSortOrder parâmetro está no local a VSTASKCATEGORY enumeração onde a categoria personalizada deve classificar.Por exemplo, se desejar que sua categoria personalizada para ser colocada após erros de detecção de código (CAT_CODESENSE = 30), mas antes de atalhos (CAT_SHORTCUTS = 40) durante uma classificação, você pode passar um valor de 31 para dwSortOrder.Se 31 já está sendo usado por outra categoria personalizada, a lista de tarefas verifica até que ele encontra uma posição de classificação não sendo usada.A posição real em VSTASKCATEGORY que a lista de tarefas atribui a sua categoria personalizada é o que é transmitido de volta como o *pCat parâmetro.

Grande parte o efeito de uma categoria personalizada pode ser conseguido sem realmente implementar uma categoria personalizada.Cada item de tarefa pode ser dada a sua própria imagem de bitmap e tarefas podem ser classificadas juntos, concedendo a eles a mesma subcategoria.Alguns motivos por que você desejaria implementar categorias personalizadas incluem:

É importante que sua categoria classificada em um local específico na lista de tarefas.
Você não quiser usar o CAT_MISC enumeração na VSTASKCATEGORY porque outras tarefas também podem usá-la.Nesse caso, todas as tarefas CAT_MISC seriam classificadas juntos, tornando impossível garantir que suas tarefas será colocado juntos durante uma classificação.
Você deseja uma exibição personalizada, onde somente suas tarefas são mostradas na lista de tarefas.

Observação
A criação de uma categoria personalizada não cria automaticamente um modo de exibição personalizado associado a ele.Exibições personalizadas são baseadas no registro e são descritas as AutoFilter2.

Consulte também

Interface IVsTaskList
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via