Compartilhar via


CMFCRibbonBar::AddContextCategory

Cria e inicializa uma nova categoria de contexto para a barra de fita.

CMFCRibbonCategory* AddContextCategory(
   LPCTSTR lpszName,
   LPCTSTR lpszContextName,
   UINT uiContextID,
   AFX_RibbonCategoryColor clrContext,
   UINT uiSmallImagesResID,
   UINT uiLargeImagesResID,
   CSize sizeSmallImage = CSize(16, 16),
   CSize sizeLargeImage = CSize(32, 32),
   CRuntimeClass* pRTI = NULL 
);

Parâmetros

  • [in] lpszName
    Nome de categoria.

  • [in] lpszContextName
    Nome da legenda de categoria de contexto.

  • [in] uiContextID
    Identificação de contexto

  • [in] clrContext
    Cor da legenda de categoria de contexto.

  • [in] uiSmallImagesResID
    Identificação do recurso de imagem pequena de uma categoria de contexto.

  • [in] uiLargeImagesResID
    Identificação do recurso de imagem grande de uma categoria de contexto.

  • [in] sizeSmallImage
    Tamanho de uma imagem pequena.

  • [in] sizeLargeImage
    Tamanho de uma imagem grande.

  • [in] pRTI
    Ponteiro para uma classe de tempo de execução.

Valor de retorno

Um ponteiro para a categoria recém-criado, ou NULL se o método de CreateObject de pRTI não pode criar a categoria especificada.

Comentários

Use esta função para adicionar uma categoria de contexto.As categorias de contexto são um tipo especial de categoria que pode ser exibido ou oculto no tempo de execução, dependendo do contexto atual do aplicativo.Por exemplo, quando o usuário seleciona um objeto, você pode exibir guias especiais com categorias de contexto que você usa para alterar o objeto selecionado específico.

A cor de uma categoria de contexto pode ser um dos seguintes valores:

  • AFX_CategoryColor_None

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

Requisitos

Cabeçalho: afxribbonbar.h

Consulte também

Referência

Classe de CMFCRibbonBar

Gráfico de hierarquia