CMFCRibbonBar::AddContextCategory

Adicione uma categoria de contexto.

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

Parâmetros

  • [in] lpszName
    Especifica o nome da categoria.

  • [in] lpszContextName
    Especifica o nome do contexto de uma categoria.

  • [in] uiContextID
    ID de contexto.

  • [in] clrContext
    Cor da categoria de contexto.

  • [in] uiSmallImagesResID
    ID de recurso da imagem pequena de uma categoria de contexto.

  • [in] uiLargeImagesResID
    ID de recurso da imagem grande de uma categoria de contexto.

  • [in] sizeSmallImage
    dimensionar de uma imagem pequena.

  • [in] sizeLargeImage
    dimensionar de uma imagem grande.

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

Valor de retorno

Um ponteiro para a categoria recém-criada, ou NULL Se a CreateObject método de pRTI não é possível criar a categoria especificada.

Comentários

Use esta função para adicionar uma categoria de contexto.Categorias de contexto são um tipo especial de categorias que podem ser mostradas ou ocultadas no tempo de execução, dependendo do contexto do aplicativo corrente.Por exemplo, quando o usuário seleciona um objeto, você pode exibir guias especiais com categorias de contexto que você usar para alterar o nome do objeto selecionado.

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

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCRibbonBar