Classe CMFCVisualManager

Dá suporte para alterar a aparência do aplicativo em um nível global. A classe CMFCVisualManager funciona em conjunto com uma classe que fornece instruções para desenhar os controles de GUI do aplicativo usando um estilo consistente. Essas outras classes são conhecidas como gerenciadores visuais e herdam de CMFCBaseVisualManager.

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCVisualManager : public CMFCBaseVisualManager

Membros

Construtores públicos

Nome	Descrição
CMFCVisualManager::CMFCVisualManager	Construtor padrão.

Métodos públicos

Nome	Descrição
CMFCVisualManager::AdjustFrames
CMFCVisualManager::AdjustToolbars
CMFCVisualManager::AlwaysHighlight3DTabs	Chamado pela estrutura para determinar se as guias 3D sempre deverão ser desenhadas usando uma cor de realce.
CMFCVisualManager::DestroyInstance
CMFCVisualManager::DoDrawHeaderSortArrow
CMFCVisualManager::DrawComboDropButtonWinXP
CMFCVisualManager::DrawPushButtonWinXP
CMFCVisualManager::DrawTextOnGlass
CMFCVisualManager::GetAutoHideButtonTextColor	Chamado pela estrutura para recuperar a cor do texto de um botão de ocultamento automático.
CMFCVisualManager::GetButtonExtraBorder	Chamado pela estrutura para recuperar o tamanho aumentado do botão que o gerenciador visual atual exige para desenhar um botão.
CMFCVisualManager::GetCaptionBarTextColor	Chamado pela estrutura para recuperar a cor do texto de uma barra de legenda.
CMFCVisualManager::GetDockingTabsBordersSize	Chamado pela estrutura para recuperar o tamanho da borda de uma barra de encaixe com guia.
CMFCVisualManager::GetHighlightedMenuItemTextColor
CMFCVisualManager::GetInstance	Retorna um ponteiro para o objeto CMFCVisualManager.
CMFCVisualManager::GetMDITabsBordersSize	Chamado pela estrutura para recuperar o tamanho da borda da janela MDITabs.
CMFCVisualManager::GetMenuItemTextColor
CMFCVisualManager::GetMenuShadowDepth	Retorna um valor que determina a largura e a altura de uma sombra de menu.
CMFCVisualManager::GetNcBtnSize	Chamado pela estrutura para determinar o tamanho dos botões do sistema com base no gerenciador visual atual. Os botões do sistema são os botões na legenda do quadro principal que mapeiam para os comandos Fechar, Minimizar, Maximizar e Restaurar.
CMFCVisualManager::GetPopupMenuBorderSize	Chamado pela estrutura para recuperar o tamanho da borda de um menu pop-up.
CMFCVisualManager::GetPropertyGridGroupColor	Chamado pela estrutura para recuperar a cor da tela de fundo de uma lista de propriedades.
CMFCVisualManager::GetPropertyGridGroupTextColor	Chamado pela estrutura para recuperar a cor do texto de uma lista de propriedades.
CMFCVisualManager::GetRibbonHyperlinkTextColor
CMFCVisualManager::GetRibbonPopupBorderSize
CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor
CMFCVisualManager::GetRibbonSliderColors
CMFCVisualManager::GetShowAllMenuItemsHeight
CMFCVisualManager::GetSmartDockingBaseGuideColors
CMFCVisualManager::GetSmartDockingHighlightToneColor
CMFCVisualManager::GetSmartDockingTheme	Retorna um tema usado para exibir os marcadores de encaixe inteligentes.
CMFCVisualManager::GetStatusBarPaneTextColor
CMFCVisualManager::GetTabFrameColors	Chamado pela estrutura para recuperar o conjunto de cores a ser usado ao desenhar um quadro da guia.
CMFCVisualManager::GetTabTextColor
CMFCVisualManager::GetToolbarButtonTextColor	Chamado pela estrutura para recuperar a cor atual do texto no botão da barra de ferramentas. Essa cor varia com base no gerenciador visual atual e no estado do botão.
CMFCVisualManager::GetToolbarDisabledTextColor	Chamado pela estrutura para determinar a cor do texto exibido nos elementos da barra de ferramentas desabilitados.
CMFCVisualManager::GetToolbarHighlightColor
CMFCVisualManager::GetToolTipInfo
CMFCVisualManager::HasOverlappedAutoHideButtons	Especifica se os botão de ocultamento automático se sobrepõem.
CMFCVisualManager::IsDockingTabHasBorder	Especifica se o gerenciador visual atual desenha uma borda ao redor das barras de encaixe com guias.
CMFCVisualManager::IsEmbossDisabledImage	Especifica se as imagens desabilitadas devem ser colocadas em alto-relevo.
CMFCVisualManager::IsFadeInactiveImage	Chamado pela estrutura para determinar se as imagens inativas em uma barra de ferramentas ou em um menu aparecerão esmaecidas.
CMFCVisualManager::IsMenuFlatLook	Especifica se os botões de menu têm uma aparência plana.
CMFCVisualManager::IsOfficeXPStyleMenus	Especifica se o gerenciador visual implementa menus do estilo do Office XP.
CMFCVisualManager::IsOwnerDrawCaption	Especifica se o gerenciador visual atual implementa legendas desenhadas do proprietário de uma janela do quadro.
CMFCVisualManager::IsShadowHighlightedImage	Especifica se uma imagem realçada tem uma sombra.
CMFCVisualManager::OnDrawAutoHideButtonBorder	Chamado pela estrutura quando desenha a borda de um botão de ocultamento automático.
CMFCVisualManager::OnDrawBarGripper	Chamado pela estrutura quando desenha a garra de uma barra de controle. O usuário deve clicar na garra para mover a barra de controle.
CMFCVisualManager::OnDrawBrowseButton	Chamado pela estrutura quando desenha um botão Procurar que pertence a um controle de edição ( classe CMFCEditBrowseCtrl).
CMFCVisualManager::OnDrawButtonBorder	Chamado pela estrutura quando desenha a borda de um botão da barra de ferramentas.
CMFCVisualManager::OnDrawButtonSeparator
CMFCVisualManager::OnDrawCaptionBarBorder	Chamado pela estrutura quando desenha a borda da barra de legenda.
CMFCVisualManager::OnDrawCaptionBarButtonBorder
CMFCVisualManager::OnDrawCaptionBarInfoArea
CMFCVisualManager::OnDrawCaptionButton	Chamado pela estrutura quando desenha um botão de título.
CMFCVisualManager::OnDrawCheckBox
CMFCVisualManager::OnDrawCheckBoxEx
CMFCVisualManager::OnDrawComboBorder	Chamado pela estrutura quando desenha a borda de um botão de caixa de combinação.
CMFCVisualManager::OnDrawComboDropButton	Chamado pela estrutura quando desenha um botão soltar da caixa de combinação.
CMFCVisualManager::OnDrawControlBorder
CMFCVisualManager::OnDrawDefaultRibbonImage	Chamado pela estrutura quando desenha a imagem da faixa de opções padrão.
CMFCVisualManager::OnDrawEditBorder	Chamado pela estrutura quando desenha uma borda ao redor de um objeto CMFCToolBarEditBoxButton.
CMFCVisualManager::OnDrawExpandingBox
CMFCVisualManager::OnDrawFloatingToolbarBorder	Chamado pela estrutura quando desenha as bordas de uma barra de ferramentas flutuante. A barra de ferramentas flutuante é uma barra de ferramentas que aparece como uma janela com minimoldura.
CMFCVisualManager::OnDrawHeaderCtrlBorder	Chamado pela estrutura quando desenha a borda que contém o controle de cabeçalho.
CMFCVisualManager::OnDrawHeaderCtrlSortArrow	Chamado pela estrutura quando desenha a seta de classificação de controle de cabeçalho.
CMFCVisualManager::OnDrawMenuArrowOnCustomizeList
CMFCVisualManager::OnDrawMenuBorder	Chamado pela estrutura quando desenha uma borda de menu.
CMFCVisualManager::OnDrawMenuCheck
CMFCVisualManager::OnDrawMenuItemButton
CMFCVisualManager::OnDrawMenuLabel
CMFCVisualManager::OnDrawMenuResizeBar
CMFCVisualManager::OnDrawMenuScrollButton	Chamado pela estrutura quando desenha um botão de rolagem de menu.
CMFCVisualManager::OnDrawMenuShadow
CMFCVisualManager::OnDrawMenuSystemButton	Chamado pela estrutura quando desenha os botões do sistema de menus Fechar, Minimizar, Maximizar e Restaurar.
CMFCVisualManager::OnDrawMiniFrameBorder
CMFCVisualManager::OnDrawOutlookBarSplitter	Chamado pela estrutura quando desenha o divisor para uma barra do Outlook. O divisor é uma barra horizontal usada para agrupar controles.
CMFCVisualManager::OnDrawOutlookPageButtonBorder	Chamado pela estrutura quando desenha a borda de um botão de página do Outlook. Os botões de página do Outlook aparecerão se o painel de barra do Outlook contiver mais botões do que pode exibir.
CMFCVisualManager::OnDrawPaneBorder	Chamado pela estrutura quando desenha a borda de uma Classe CPane.
CMFCVisualManager::OnDrawPaneCaption	Chamado pela estrutura quando desenha a legenda de um CPane.
CMFCVisualManager::OnDrawPaneDivider
CMFCVisualManager::OnDrawPopupWindowBorder
CMFCVisualManager::OnDrawPopupWindowButtonBorder
CMFCVisualManager::OnDrawPopupWindowCaption
CMFCVisualManager::OnDrawRibbonApplicationButton	Chamado pela estrutura quando desenha o Botão Principal na faixa de opções.
CMFCVisualManager::OnDrawRibbonButtonBorder	Chamado pela estrutura quando desenha a borda de um botão da faixa de opções.
CMFCVisualManager::OnDrawRibbonButtonsGroup	Chamado pela estrutura quando desenha um grupo de botões na faixa de opções.
CMFCVisualManager::OnDrawRibbonCaption	Chamado pela estrutura quando desenha a legenda do quadro principal, mas somente se a barra da faixa de opções estiver integrada ao quadro.
CMFCVisualManager::OnDrawRibbonCaptionButton	Chamado pela estrutura quando desenha um botão de título localizado na barra da faixa de opções.
CMFCVisualManager::OnDrawRibbonCategory	Chamado pela estrutura quando desenha uma categoria da faixa de opções.
CMFCVisualManager::OnDrawRibbonCategoryCaption	Chamado pela estrutura quando desenha a legenda para uma categoria da faixa de opções.
CMFCVisualManager::OnDrawRibbonCategoryScroll
CMFCVisualManager::OnDrawRibbonCategoryTab	Chamado pela estrutura quando desenha a guia para uma categoria da faixa de opções.
CMFCVisualManager::OnDrawRibbonCheckBoxOnList
CMFCVisualManager::OnDrawRibbonColorPaletteBox
CMFCVisualManager::OnDrawRibbonDefaultPaneButtonContext
CMFCVisualManager::OnDrawRibbonDefaultPaneButton	Chamado pela estrutura quando desenha o botão padrão da faixa de opções. O botão padrão aparece quando o usuário reduz um painel da faixa de opções para que fique demasiado pequeno para exibir os elementos da faixa de opções. O botão padrão é desenhado e os elementos da faixa de opções são adicionados como itens em um menu suspenso.
CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator
CMFCVisualManager::OnDrawRibbonGalleryBorder
CMFCVisualManager::OnDrawRibbonGalleryButton
CMFCVisualManager::OnDrawRibbonKeyTip
CMFCVisualManager::OnDrawRibbonLabel	Chamado pela estrutura quando desenha o rótulo da faixa de opções.
CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder	Chamado pela estrutura quando desenha a borda de um botão da faixa de opções que está posicionado no painel Principal. O painel Principal é o painel que aparece quando um usuário clica no Botão Principal.
CMFCVisualManager::OnDrawRibbonMainPanelFrame	Chamado pela estrutura quando desenha o quadro ao redor do painel Principal .
CMFCVisualManager::OnDrawRibbonMenuCheckFrame
CMFCVisualManager::OnDrawRibbonPanel	Chamado pela estrutura quando desenha um painel da faixa de opções.
CMFCVisualManager::OnDrawRibbonPanelCaption	Chamado pela estrutura quando desenha a legenda de um painel da faixa de opções.
CMFCVisualManager::OnDrawRibbonProgressBar	Chamado pela estrutura quando desenha um objeto CMFCRibbonProgressBar.
CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator	Chamado pela estrutura quando desenha um separador na Barra de Ferramentas de Acesso Rápido de uma faixa de opções.
CMFCVisualManager::OnDrawRibbonRecentFilesFrame	Chamado pela estrutura quando desenha um quadro ao redor de uma lista de arquivos recentes.
CMFCVisualManager::OnDrawRibbonSliderChannel	Chamado pela estrutura quando desenha o canal de um objeto CMFCRibbonSlider.
CMFCVisualManager::OnDrawRibbonSliderThumb	Chamado pela estrutura quando desenha a miniatura de um objeto CMFCRibbonSlider.
CMFCVisualManager::OnDrawRibbonSliderZoomButton	Chamado pela estrutura quando desenha os botões de zoom de um objeto CMFCRibbonSlider.
CMFCVisualManager::OnDrawRibbonStatusBarPane	Chamado pela estrutura quando desenha o painel da barra de status de uma faixa de opções.
CMFCVisualManager::OnDrawRibbonTabsFrame	Chamado pela estrutura quando desenha uma moldura ao redor de um conjunto de guias de faixa de opções.
CMFCVisualManager::OnDrawScrollButtons
CMFCVisualManager::OnDrawSeparator	Chamado pela estrutura quando desenha um separador. O separador é normalmente usado em uma barra de controle para separar os grupos de ícones.
CMFCVisualManager::OnDrawShowAllMenuItems
CMFCVisualManager::OnDrawSpinButtons	Chamado pela estrutura quando desenha botões de rotação.
CMFCVisualManager::OnDrawSplitterBorder	Chamado pelo framework quando desenha a borda de uma janela dividida.
CMFCVisualManager::OnDrawSplitterBox	Chamado pela estrutura quando desenha a caixa de arrastar do divisor para uma janela dividida.
CMFCVisualManager::OnDrawStatusBarPaneBorder	Chamado pela estrutura quando desenha a borda de um painel da barra de status.
CMFCVisualManager::OnDrawStatusBarProgress	Chamado pela estrutura quando desenha o indicador de progresso da barra de status.
CMFCVisualManager::OnDrawStatusBarSizeBox	Chamado pela estrutura quando desenha a caixa de tamanho da barra de status.
CMFCVisualManager::OnDrawTab	Chamado pela estrutura quando desenha um objeto CMFCTabCtrl.
CMFCVisualManager::OnDrawTabCloseButton	Chamado pela estrutura quando desenha o botão Fechar na guia ativa.
CMFCVisualManager::OnDrawTabContent	Chamado pela estrutura quando desenha o interior da guia (imagens, textos).
CMFCVisualManager::OnDrawTabsButtonBorder	Chamado pela estrutura quando desenha a borda de um botão da guia.
CMFCVisualManager::OnDrawTask	Chamado pela estrutura quando desenha uma tarefa no painel de tarefas.
CMFCVisualManager::OnDrawTasksGroupAreaBorder	Chamado pela estrutura quando desenha uma borda ao redor de uma área de grupo no painel de tarefas.
CMFCVisualManager::OnDrawTasksGroupCaption	Chamado pela estrutura quando desenha a legenda de um grupo de tarefas no painel de tarefas.
CMFCVisualManager::OnDrawTasksGroupIcon
CMFCVisualManager::OnDrawTearOffCaption	Chamado pela estrutura quando desenha a legenda destacável para uma barra destacável.
CMFCVisualManager::OnDrawToolBoxFrame
CMFCVisualManager::OnEraseMDIClientArea	Chamado pelo framework quando ele apaga a área do cliente MDI.
CMFCVisualManager::OnErasePopupWindowButton
CMFCVisualManager::OnEraseTabsArea	Chamado pela estrutura quando apaga a área da guia em uma janela com guias.
CMFCVisualManager::OnEraseTabsButton	Chamado pela estrutura quando apaga o ícone e o texto de um botão da guia.
CMFCVisualManager::OnEraseTabsFrame	Chamado pela estrutura quando apaga um quadro da guia.
CMFCVisualManager::OnFillAutoHideButtonBackground	Chamado pela estrutura quando preenche a tela de fundo de um botão de ocultamento automático.
CMFCVisualManager::OnFillBarBackground	Chamado pela estrutura quando preenche a tela de fundo de uma barra de controle.
CMFCVisualManager::OnFillButtonInterior	Chamado pela estrutura quando preenche a tela de fundo de um botão da barra de ferramentas.
CMFCVisualManager::OnFillCaptionBarButton
CMFCVisualManager::OnFillCommandsListBackground	Chamado pela estrutura quando preenche a tela de fundo de um botão da barra de ferramentas que pertence a uma lista de comandos que, por sua vez, faz parte de uma caixa de diálogo de personalização.
CMFCVisualManager::OnFillHeaderCtrlBackground	Chamado pela estrutura quando preenche a tela de fundo de um controle de cabeçalho.
CMFCVisualManager::OnFillMiniFrameCaption	Chamado pela estrutura quando preenche a legenda de uma janela com minimoldura.
CMFCVisualManager::OnFillOutlookBarCaption	Chamado pela estrutura quando preenche a tela de fundo de uma legenda da barra do Outlook.
CMFCVisualManager::OnFillOutlookPageButton	Chamado pela estrutura quando preenche o interior de um botão de página do Outlook.
CMFCVisualManager::OnFillPopupWindowBackground	Chamado pela estrutura quando preenche a tela de fundo de uma janela pop-up.
CMFCVisualManager::OnFillRibbonButton	Chamado pela estrutura quando preenche o interior de um botão da faixa de opções.
CMFCVisualManager::OnFillRibbonEdit	Chamado pela estrutura quando preenche o interior de um controle de edição da faixa de opções.
CMFCVisualManager::OnFillRibbonMainPanelButton	Chamado pela estrutura quando preenche o interior de um botão da faixa de opções localizado no painel Principal.
CMFCVisualManager::OnFillRibbonMenuFrame	Chamado pela estrutura quando preenche o quadro de menu principal do painel da faixa de opções.
CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup
CMFCVisualManager::OnFillSplitterBackground	Chamado pela estrutura quando preenche a tela de fundo de uma janela dividida.
CMFCVisualManager::OnFillTab	Chamado pela estrutura quando preenche a tela de fundo de uma guia.
CMFCVisualManager::OnFillTasksGroupInterior	Chamado pela estrutura quando preenche o interior de um objeto CMFCTasksPaneTaskGroup no CMFCTasksPane.
CMFCVisualManager::OnFillTasksPaneBackground	Chamado pela estrutura quando preenche a tela de fundo de um controle CMFCTasksPane.
CMFCVisualManager::OnHighlightMenuItem	Chamado pela estrutura quando desenha um item de menu realçado.
CMFCVisualManager::OnHighlightRarelyUsedMenuItems	Chamado pela estrutura quando desenha um item de menu realçado e raramente usado.
CMFCVisualManager::OnNcPaint	Chamado pela estrutura quando desenha a área de não cliente.
CMFCVisualManager::OnSetWindowRegion	Chamado pela estrutura quando define uma região que contém quadros e menus pop-up.
CMFCVisualManager::OnUpdateSystemColors	Chamado pela estrutura quando altera a configuração de cor do sistema.
CMFCVisualManager::RedrawAll	Redesenha todas as barras de controle no aplicativo.
CMFCVisualManager::RibbonCategoryColorToRGB
CMFCVisualManager::SetDefaultManager	Define o gerenciador visual padrão.
CMFCVisualManager::SetEmbossDisabledImage	Habilita ou desabilita o modo colocado em alto-relevo para imagens da barra de ferramentas desabilitadas.
CMFCVisualManager::SetFadeInactiveImage	Habilita ou desabilita o efeito de iluminação para imagens inativas em um menu ou uma barra de ferramentas.
CMFCVisualManager::SetMenuFlatLook	Define um sinalizador indicando se os botões de menu do aplicativo têm uma aparência plana.
CMFCVisualManager::SetMenuShadowDepth	Define a largura e a altura da sombra do menu.
CMFCVisualManager::SetShadowHighlightedImage	Define um sinalizador que indica se a sombra deverá ser exibida ao renderizar as imagens realçadas.

Comentários

Como a classe CMFCVisualManager controla a GUI do aplicativo, cada aplicativo poderá ter uma instância de CMFCVisualManager ou uma instância de uma classe derivada de CMFCVisualManager. O aplicativo também poderá funcionar sem um CMFCVisualManager. Use o método estático GetInstance para obter um ponteiro para o objeto derivado do CMFCVisualManager atual.

Para alterar a aparência do aplicativo, será necessário usar outras classes que forneçam métodos para desenhar todos os elementos visuais do aplicativo. Alguns exemplos dessas classes são a classe CMFCVisualManagerOfficeXP, a classe CMFCVisualManagerOffice2003 e a classe CMFCVisualManagerOffice2007. Quando você quiser alterar a aparência do aplicativo, passe um desses gerenciadores visuais para o método SetDefaultManager. Para obter um exemplo que demonstra como o aplicativo poderá simular a aparência do Microsoft Office 2003, consulte classe CMFCVisualManagerOffice2003.

Todos os métodos de desenho são virtuais. Isso permite criar um estilo visual personalizado para a GUI do aplicativo. Se você quiser criar seu próprio estilo visual, derive uma classe de uma das classes do gerenciador visual e substitua os métodos de desenho que deseja alterar.

Exemplos

Este exemplo demonstra como instanciar os objetos CMFCVisualManager padrão e personalizados.

void CMFCSkinsApp::SetSkin (int iIndex)
{   // destroy the current visual manager
    if (CMFCVisualManager::GetInstance () != NULL)
    {
        delete CMFCVisualManager::GetInstance ();
    }
    switch (iIndex)
    {
    case 0:
        CMFCVisualManager::GetInstance ();
        // create the standard visual manager
        break;
    case 1:
        new CMyVisualManager ();
        // create the first custom visual manager
        break;
    case 2:
        new CMacStyle ();
        // create the second custom visual manager
        break;
    }
    // access the manager and set it properly
    CMFCVisualManager::GetInstance ()->SetLook2000 ();
    CMFCVisualManager::GetInstance ()->RedrawAll ();
}

O exemplo a seguir demonstra como recuperar os valores padrão de um objeto CMFCVisualManager. Este snippet de código faz parte do exemplo do Painel de Tarefas.

int m_nVMargin;
int m_nHMargin;
int m_nGroupSpacing;
int m_nTaskSpacing;
int m_nCaptionHeight;
int m_nTaskOffset;
int m_nIconOffset;

Hierarquia de herança

CObject

CMFCBaseVisualManager

CMFCVisualManager

Requisitos

Cabeçalho: afxvisualmanager.h

CMFCVisualManager::AdjustFrames

static void __stdcall AdjustFrames();

Comentários

CMFCVisualManager::AdjustToolbars

static void __stdcall AdjustToolbars();

Comentários

CMFCVisualManager::AlwaysHighlight3DTabs

A estrutura chama esse método para determinar se as guias 3D sempre devem ser realçadas no aplicativo.

virtual BOOL AlwaysHighlight3DTabs() const;

Valor de retorno

TRUE se as guias 3D deverão ser realçadas.

Comentários

Substitua essa função em um gerenciador visual derivado e retorne TRUE se as guias 3D sempre deverão ser realçadas. A implementação padrão desse método retorna FALSE.

CMFCVisualManager::CMFCVisualManager

CMFCVisualManager(BOOL bTemporary = FALSE);

Parâmetros

[in] bTemporary

Comentários

CMFCVisualManager::DestroyInstance

static void __stdcall DestroyInstance(BOOL bAutoDestroyOnly = FALSE);

Parâmetros

[in] bAutoDestroyOnly

Comentários

CMFCVisualManager::DoDrawHeaderSortArrow

void DoDrawHeaderSortArrow(
    CDC* pDC,
    CRect rect,
    BOOL bIsUp,
    BOOL bDlgCtrl);

Parâmetros

[in] pDC
[in] rect
[in] bIsUp
[in] bDlgCtrl

Comentários

CMFCVisualManager::DrawComboBorderWinXP

virtual BOOL DrawComboBorderWinXP(CDC*,
    CRect,
    BOOL,
    BOOL,
    BOOL);

Parâmetros

[in] CDC*
[in] CRect
[in] BOOL

Valor de retorno

Comentários

CMFCVisualManager::DrawComboDropButtonWinXP

virtual BOOL DrawComboDropButtonWinXP(CDC*,
    CRect,
    BOOL,
    BOOL,
    BOOL);

Parâmetros

[in] CDC*
[in] CRect
[in] BOOL

Valor de retorno

Comentários

CMFCVisualManager::DrawPushButtonWinXP

virtual BOOL DrawPushButtonWinXP(CDC*,
    CRect,
    CMFCButton*,
    UINT);

Parâmetros

[in] CDC*
[in] CRect
[in] CMFCButton*
[in] UINT

Valor de retorno

Comentários

CMFCVisualManager::DrawTextOnGlass

virtual BOOL DrawTextOnGlass(
    CDC* pDC,
    CString strText,
    CRect rect,
    DWORD dwFlags,
    int nGlowSize = 0,
    COLORREF clrText = (COLORREF)-1);

Parâmetros

[in] pDC
[in] strText
[in] rect
[in] dwFlags
[in] nGlowSize
[in] clrText

Valor de retorno

Comentários

CMFCVisualManager::EnableToolbarButtonFill

void EnableToolbarButtonFill(BOOL bEnable = TRUE);

Parâmetros

[in] bEnable

Comentários

CMFCVisualManager::GetAutoHideButtonTextColor

A estrutura chama esse método para recuperar a cor do texto de um botão de ocultamento automático.

virtual COLORREF GetAutoHideButtonTextColor(CMFCAutoHideButton* pButton);

Parâmetros

pButton
[in] Um ponteiro para um botão de ocultamento automático.

Valor de retorno

Um parâmetro COLORREF que especifica a cor do texto de pButton.

Comentários

Substitua esse método em uma classe derivada para personalizar a cor do texto de um botão de ocultamento automático no aplicativo. Para fazer isso, retorne a cor que você quer que o aplicativo use como a cor do texto.

CMFCVisualManager::GetButtonExtraBorder

A estrutura chama esse método quando desenha um botão da barra de ferramentas.

virtual CSize GetButtonExtraBorder() const;

Valor de retorno

Um objeto CSize que contém o tamanho adicional da borda dos botões da barra de ferramentas.

Comentários

Algumas capas precisam estender as bordas dos botões da barra de ferramentas. Substitua esse método em um gerenciador visual personalizado para estender as bordas dos botões da barra de ferramentas no aplicativo. A implementação padrão desse método retorna um tamanho vazio.

CMFCVisualManager::GetCaptionBarTextColor

A estrutura chama esse método para recuperar a cor do texto na barra de legenda.

virtual COLORREF GetCaptionBarTextColor(CMFCCaptionBar* pBar);

Parâmetros

pBar
[in] Um ponteiro para uma barra de legenda.

Valor de retorno

Um parâmetro COLORREF que indica a cor do texto em pBar.

Comentários

Substitua esse método na classe derivada para personalizar a cor do texto de uma barra de legenda. No método substituído, retorne a cor desejada.

CMFCVisualManager::GetCaptionButtonExtraBorder

virtual CSize GetCaptionButtonExtraBorder() const;

Valor de retorno

Comentários

CMFCVisualManager::GetDockingPaneCaptionExtraHeight

virtual int GetDockingPaneCaptionExtraHeight() const;

Valor de retorno

Comentários

CMFCVisualManager::GetDockingTabsBordersSize

A estrutura chama esse método quando desenha um painel encaixado e com guias.

virtual int GetDockingTabsBordersSize();

Valor de retorno

Um inteiro que indica o tamanho da borda de um painel encaixado e com guias.

Comentários

Um painel encaixado se torna com guias quando o usuário encaixa vários painéis no mesmo local no aplicativo.

Substitua esse método em um gerenciador visual personalizado para alterar o tamanho da borda das barras de controle com guias encaixadas. A implementação padrão retorna -1.

CMFCVisualManager::GetHighlightedMenuItemTextColor

virtual COLORREF GetHighlightedMenuItemTextColor(CMFCToolBarMenuButton* pButton);

Parâmetros

[in] pButton

Valor de retorno

Comentários

CMFCVisualManager::GetInstance

Retorna um ponteiro para o objeto classe CMFCVisualManager atual para o aplicativo.

static CMFCVisualManager* GetInstance();

Valor de retorno

Um ponteiro para um objeto CMFCVisualManager.

Comentários

Um aplicativo poderá ter apenas um objeto CMFCVisualManager associado a ele. Isso inclui os objetos derivados da classe CMFCVisualManager. Esse método retorna um ponteiro para o objeto associado CMFCVisualManager. Se o aplicativo não tiver um objeto CMFCVisualManager associado, esse método criará um e o associará ao aplicativo.

CMFCVisualManager::GetMDITabsBordersSize

A estrutura chama esse método para determinar o tamanho da borda de uma janela MDITabs antes de desenhar a janela.

virtual int GetMDITabsBordersSize();

Valor de retorno

O tamanho da borda da janela MDITabs.

Comentários

Substitua essa função em uma classe derivada para personalizar o tamanho da borda da janela MDITabs.

CMFCVisualManager::GetMenuImageMargin

virtual int GetMenuImageMargin() const;

Valor de retorno

Comentários

CMFCVisualManager::GetMenuItemTextColor

virtual COLORREF GetMenuItemTextColor(
    CMFCToolBarMenuButton* pButton,
    BOOL bHighlighted,
    BOOL bDisabled);

Parâmetros

[in] pButton
[in] bHighlighted
[in] bDisabled

Valor de retorno

Comentários

CMFCVisualManager::GetMenuShadowDepth

Recupera a largura e a altura da sombra do menu.

int GetMenuShadowDepth() const;

Valor de retorno

A largura e a altura da sombra do menu em pixels.

Comentários

A largura e a altura da sombra do menu são equivalentes. O valor padrão é 7 pixels.

CMFCVisualManager::GetNcBtnSize

Chamado pela estrutura quando é necessário recuperar o tamanho dos botões do sistema.

virtual CSize GetNcBtnSize(BOOL bSmall) const;

Parâmetros

bSmall
[in] Um parâmetro booliano que indicará se GetNcBtnSize deverá recuperar o tamanho de um botão de sistema pequeno ou grande. Se bSmall for TRUE, GetNcBtnSize retornará o tamanho de um pequeno botão do sistema. Caso contrário, retornará o tamanho de um botão de sistema grande.

Valor de retorno

Um parâmetro CSize que indica o tamanho dos botões do sistema.

Comentários

Os botões do sistema são os botões na legenda da janela do quadro que mapeiam para os comandos Fechar, Minimizar, Maximizar e Restaurar. O tamanho desses botões depende do gerenciador visual atual. Substitua esse método se quiser personalizar o tamanho dos botões do sistema no aplicativo.

CMFCVisualManager::GetPopupMenuBorderSize

A estrutura chama esse método para obter o tamanho da borda dos menus pop-up.

virtual int GetPopupMenuBorderSize() const;

Valor de retorno

Um inteiro que especifica o tamanho da borda dos menus pop-up.

Comentários

Substitua esse método para personalizar o tamanho da borda dos menus pop-up no aplicativo.

CMFCVisualManager::GetPopupMenuGap

virtual int GetPopupMenuGap() const;

Valor de retorno

Comentários

CMFCVisualManager::GetPropertyGridGroupColor

A estrutura chama esse método para obter a cor da tela de fundo de uma lista de propriedades.

virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);

Parâmetros

pPropList
[in] Um ponteiro para a lista de propriedades que a estrutura está desenhando.

Valor de retorno

Um parâmetro COLORREF que indica a cor da tela de fundo de pPropList.

Comentários

Substitua essa função para personalizar a cor da tela de fundo de uma lista de propriedades no aplicativo.

CMFCVisualManager::GetPropertyGridGroupTextColor

A estrutura chama esse método para recuperar a cor do texto de uma lista de propriedades.

virtual COLORREF GetPropertyGridGroupTextColor(CMFCPropertyGridCtrl* pPropList);

Parâmetros

pPropList
[in] Um ponteiro para a lista de propriedades.

Valor de retorno

Um parâmetro COLORREF que indica a cor do texto da lista de propriedades.

Comentários

Substitua essa função para personalizar a cor do texto de uma lista de propriedades no aplicativo.

CMFCVisualManager::GetRibbonHyperlinkTextColor

virtual COLORREF GetRibbonHyperlinkTextColor(CMFCRibbonLinkCtrl* pHyperLink);

Parâmetros

[in] pHyperLink

Valor de retorno

Comentários

CMFCVisualManager::GetRibbonPopupBorderSize

virtual int GetRibbonPopupBorderSize(const CMFCRibbonPanelMenu*) const;

Parâmetros

[in] CMFCRibbonPanelMenu*

Valor de retorno

Comentários

CMFCVisualManager::GetRibbonQuickAccessToolBarChevronOffset

virtual int GetRibbonQuickAccessToolBarChevronOffset();

Valor de retorno

Comentários

CMFCVisualManager::GetRibbonQuickAccessToolBarRightMargin

virtual int GetRibbonQuickAccessToolBarRightMargin();

Valor de retorno

Comentários

CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor

virtual COLORREF GetRibbonQuickAccessToolBarTextColor(BOOL bDisabled = FALSE);

Parâmetros

[in] bDisabled

Valor de retorno

Comentários

CMFCVisualManager::GetRibbonSliderColors

virtual void GetRibbonSliderColors(
    CMFCRibbonSlider* pSlider,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled,
    COLORREF& clrLine,
    COLORREF& clrFill);

Parâmetros

[in] pSlider
[in] bIsHighlighted
[in] bIsPressed
[in] bIsDisabled
[in] clrLine
[in] clrFill

Comentários

CMFCVisualManager::GetRibbonStatusBarTextColor

virtual COLORREF GetRibbonStatusBarTextColor(CMFCRibbonStatusBar* pStatusBar);

Parâmetros

[in] pStatusBar

Valor de retorno

Comentários

CMFCVisualManager::GetShowAllMenuItemsHeight

virtual int GetShowAllMenuItemsHeight(
    CDC* pDC,
    const CSize& sizeDefault);

Parâmetros

[in] pDC
[in] sizeDefault

Valor de retorno

Comentários

CMFCVisualManager::GetSmartDockingBaseGuideColors

virtual void GetSmartDockingBaseGuideColors(
    COLORREF& clrBaseGroupBackground,
    COLORREF& clrBaseGroupBorder);

Parâmetros

[in] clrBaseGroupBackground
[in] clrBaseGroupBorder

Comentários

CMFCVisualManager::GetSmartDockingHighlightToneColor

virtual COLORREF GetSmartDockingHighlightToneColor();

Valor de retorno

Comentários

CMFCVisualManager::GetSmartDockingTheme

Retorna um tema usado para exibir os marcadores de encaixe inteligentes.

virtual AFX_SMARTDOCK_THEME GetSmartDockingTheme();

Valor de retorno

Retorna um dos seguintes valores enumerados: AFX_SDT_DEFAULT, AFX_SDT_VS2005 AFX_SDT_VS2008.

Comentários

CMFCVisualManager::GetStatusBarPaneTextColor

virtual COLORREF GetStatusBarPaneTextColor(
    CMFCStatusBar* pStatusBar,
    CMFCStatusBarPaneInfo* pPane);

Parâmetros

[in] pStatusBar
[in] pPane

Valor de retorno

Comentários

CMFCVisualManager::GetTabFrameColors

A estrutura chama essa função quando precisa recuperar o conjunto de cores para desenhar uma janela de guia.

virtual void GetTabFrameColors(
    const CMFCBaseTabCtrl* pTabWnd,
    COLORREF& clrDark,
    COLORREF& clrBlack,
    COLORREF& clrHighlight,
    COLORREF& clrFace,
    COLORREF& clrDarkShadow,
    COLORREF& clrLight,
    CBrush*& pbrFace,
    CBrush*& pbrBlack);

Parâmetros

pTabWnd
[in] Um ponteiro para a janela com guias em que o quadro está desenhando uma guia.

clrDark
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da borda escura de uma guia.

clrBlack
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da borda da janela com guias. A cor padrão da borda é preta.

clrHighlight
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor para o estado de realce da janela com guias.

clrFace
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da face da janela com guias.

clrDarkShadow
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da sombra da janela com guias.

clrLight
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor para a borda clara da janela com guias.

pbrFace
[out] Um ponteiro para uma referência para um pincel. Esse método armazena o pincel que utiliza para preencher a face da janela com guias nesse parâmetro.

pbrBlack
[out] Um ponteiro para uma referência para um pincel. Esse método armazena o pincel usado para preencher a borda preta da janela com guias nesse parâmetro.

Comentários

Substitua essa função em uma classe derivada se quiser personalizar o conjunto de cores que a estrutura usa ao desenhar uma janela com guias.

CMFCVisualManager::GetTabHorzMargin

virtual int GetTabHorzMargin(const CMFCBaseTabCtrl*);

Parâmetros

[in] CMFCBaseTabCtrl*

Valor de retorno

Comentários

CMFCVisualManager::GetTabTextColor

virtual COLORREF GetTabTextColor(
    const CMFCBaseTabCtrl*,
    int,
    BOOL);

Parâmetros

[in] CMFCBaseTabCtrl*
[in] int
[in] BOOL

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneGroupCaptionHeight

int GetTasksPaneGroupCaptionHeight() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneGroupCaptionHorzOffset

int GetTasksPaneGroupCaptionHorzOffset() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneGroupCaptionVertOffset

int GetTasksPaneGroupCaptionVertOffset() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneGroupVertOffset

int GetTasksPaneGroupVertOffset() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneHorzMargin

int GetTasksPaneHorzMargin() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneIconHorzOffset

int GetTasksPaneIconHorzOffset() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneIconVertOffset

int GetTasksPaneIconVertOffset() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneTaskHorzOffset

int GetTasksPaneTaskHorzOffset() const;

Valor de retorno

Comentários

CMFCVisualManager::GetTasksPaneVertMargin

int GetTasksPaneVertMargin() const;

Valor de retorno

Comentários

CMFCVisualManager::GetToolbarButtonTextColor

A estrutura chama esse método para determinar a cor do texto de um botão da barra de ferramentas.

virtual COLORREF GetToolbarButtonTextColor(
    CMFCToolBarButton* pButton,
    CMFCVisualManager::AFX_BUTTON_STATE state);

Parâmetros

pButton
[in] Um ponteiro para o botão da barra de ferramentas.

state
[in] O estado do botão da barra de ferramentas.

Valor de retorno

A cor do texto de pButton quando tem o estado indicado por estado.

Comentários

A cor do texto de um objeto classe CMFCToolBarButton depende do estado do botão. Os estados possíveis de um botão de barra de ferramentas são ButtonsIsRegular, ButtonsIsPressed ou ButtonsIsHighlighted.

Substitua essa função para personalizar a cor do texto de um botão da barra de ferramentas no aplicativo.

CMFCVisualManager::GetToolBarCustomizeButtonMargin

virtual int GetToolBarCustomizeButtonMargin() const;

Valor de retorno

Comentários

CMFCVisualManager::GetToolbarDisabledColor

virtual COLORREF GetToolbarDisabledColor() const;

Valor de retorno

Comentários

CMFCVisualManager::GetToolbarDisabledTextColor

A estrutura chama essa função para determinar a cor do texto dos botões da barra de ferramentas que não estão disponíveis.

virtual COLORREF GetToolbarDisabledTextColor();

Valor de retorno

A cor que a estrutura usa para a cor do texto dos botões da barra de ferramentas que não estão disponíveis.

Comentários

Substitua esse método em um gerenciador visual personalizado para definir a cor do texto dos botões da barra de ferramentas que não estão disponíveis.

CMFCVisualManager::GetToolbarHighlightColor

virtual COLORREF GetToolbarHighlightColor();

Valor de retorno

Comentários

CMFCVisualManager::GetToolTipInfo

virtual BOOL GetToolTipInfo(
    CMFCToolTipInfo& params,
    UINT nType = (UINT)(-1));

Parâmetros

[in] params
[in] nType

Valor de retorno

Comentários

CMFCVisualManager::HasOverlappedAutoHideButtons

Retornará se os botões de ocultamento automático se sobrepõem no gerenciador visual atual.

virtual BOOL HasOverlappedAutoHideButtons() const;

Valor de retorno

TRUE se os botões de ocultação automática se sobrepõem, caso contrário, FALSE.

CMFCVisualManager::IsAutoDestroy

BOOL IsAutoDestroy() const;

Valor de retorno

Comentários

CMFCVisualManager::IsDefaultWinXPPopupButton

virtual BOOL IsDefaultWinXPPopupButton(CMFCDesktopAlertWndButton*) const;

Parâmetros

[in] CMFCDesktopAlertWndButton*

Valor de retorno

Comentários

CMFCVisualManager::IsDockingTabHasBorder

Retorna se o gerenciador visual atual desenha bordas em torno de painéis encaixados e com guias.

virtual BOOL IsDockingTabHasBorder();

Valor de retorno

TRUE se o gerenciador visual desenhar bordas ao redor de painéis encaixados e com guias, caso contrário, será FALSE.

Comentários

Os painéis encaixados se tornam com guias quando vários painéis são encaixados no mesmo local.

CMFCVisualManager::IsEmbossDisabledImage

Especifica se a estrutura incorpora imagens que não estão disponíveis.

BOOL IsEmbossDisabledImage() const;

Valor de retorno

Diferente de zero se a estrutura gravar imagens que não estão disponíveis, caso contrário, 0.

Comentários

Este método é chamado por CMFCToolBarImages::Draw quando desenha uma imagem na barra de ferramentas que não está disponível.

CMFCVisualManager::IsFadeInactiveImage

A estrutura chama esse método quando desenha imagens inativas na barra de ferramentas ou em um menu.

BOOL IsFadeInactiveImage() const;

Valor de retorno

Diferente de zero se a estrutura usar o efeito de iluminação quando desenhar imagens inativas na barra de ferramentas ou em um menu, caso contrário, 0.

Comentários

É possível ativar ou desativar o efeito de iluminação chamando CMFCVisualManager::SetFadeInactiveImage. O efeito de iluminação é o que faz as imagens indisponíveis aparecerem esmaecidas.

CMFCVisualManager::IsFrameMenuCheckedItems

BOOL IsFrameMenuCheckedItems() const;

Valor de retorno

Comentários

CMFCVisualManager::IsHighlightOneNoteTabs

virtual BOOL IsHighlightOneNoteTabs() const;

Valor de retorno

Comentários

CMFCVisualManager::IsHighlightWholeMenuItem

virtual BOOL IsHighlightWholeMenuItem();

Valor de retorno

Comentários

CMFCVisualManager::IsLayeredRibbonKeyTip

virtual BOOL IsLayeredRibbonKeyTip() const;

Valor de retorno

Comentários

CMFCVisualManager::IsMenuFlatLook

Indica se os botões do menu aparecem planos.

BOOL IsMenuFlatLook() const;

Valor de retorno

Diferente de zero se os botões do menu aparecerem planos, caso contrário, 0.

Comentários

Por padrão, os botões de menu não aparecem planos. Use o método CMFCVisualManager::SetMenuFlatLook para alterar esse comportamento. Quando os botões de menu aparecem simples, eles não alteram a aparência quando o usuário clica neles.

CMFCVisualManager::IsOfficeXPStyleMenus

Indica se o gerenciador visual implementa menus no estilo do Office XP.

virtual BOOL IsOfficeXPStyleMenus() const;

Valor de retorno

Diferente de zero se o gerenciador visual exibir menus no estilo do Office XP, caso contrário, 0.

Comentários

A classe CMFCPopupMenu chama esse método quando precisa desenhar o menu e a sombra. Por padrão, esse método retorna FALSE. Se quiser usar menus pop-up semelhantes aos menus pop-up do Office XP, substitua esse método em um gerenciador visual personalizado e retorne TRUE.

CMFCVisualManager::IsOffsetPressedButton

virtual BOOL IsOffsetPressedButton() const;

Valor de retorno

Comentários

CMFCVisualManager::IsOwnerDrawCaption

Indica se o gerenciador visual atual implementa legendas desenhadas pelo proprietário.

virtual BOOL IsOwnerDrawCaption();

Valor de retorno

TRUE se todas as janelas do quadro no aplicativo tiverem legendas desenhadas pelo proprietário, caso contrário, será FALSE.

CMFCVisualManager::IsOwnerDrawMenuCheck

virtual BOOL IsOwnerDrawMenuCheck();

Valor de retorno

Comentários

CMFCVisualManager::IsShadowHighlightedImage

Indica se o gerenciador visual exibe sombras ao renderizar as imagens realçadas.

BOOL IsShadowHighlightedImage() const;

Valor de retorno

Diferente de zero quando o gerenciador visual exibe sombras em imagens destacadas, caso contrário, 0.

CMFCVisualManager::IsToolbarButtonFillEnabled

BOOL IsToolbarButtonFillEnabled() const;

Valor de retorno

Comentários

CMFCVisualManager::IsToolbarRoundShape

virtual BOOL IsToolbarRoundShape(CMFCToolBar*);

Parâmetros

[in] CMFCToolBar*

Valor de retorno

Comentários

CMFCVisualManager::IsWindowsThemingSupported

virtual BOOL IsWindowsThemingSupported() const;

Valor de retorno

Comentários

CMFCVisualManager::OnActivateApp

virtual void OnActivateApp(
    CWnd* pWnd,
    BOOL bActive);

Parâmetros

[in] pWnd
[in] bActive

Comentários

CMFCVisualManager::OnDrawAutoHideButtonBorder

A estrutura chama esse método quando desenha a borda de um botão de ocultamento automático.

virtual void OnDrawAutoHideButtonBorder(
    CDC* pDC,
    CRect rectBounds,
    CRect rectBorderSize,
    CMFCAutoHideButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectBounds
[in] O tamanho e o local do botão de ocultamento automático.

rectBorderSize
[in] Um parâmetro CRect que contém os tamanhos das bordas.

pButton
[in] Um ponteiro para o botão de ocultamento automático. A estrutura está desenhando a borda para este botão.

Comentários

Substitua esse método em uma classe derivada se você quiser personalizar a aparência da borda de um botão de ocultamento automático. Por padrão, esse método preenche uma borda plana com a cor de sombra padrão para seu aplicativo.

O parâmetro rectBorderSize não contém as coordenadas da borda. Ele contém o tamanho da borda nos membros de dados top, bottom, left e right. Um valor menor ou igual a 0 não indica nenhuma borda nesse lado do botão de ocultamento automático.

CMFCVisualManager::OnDrawBarGripper

Chamado pela estrutura quando desenha a garra de uma barra de controle.

virtual void OnDrawBarGripper(
    CDC* pDC,
    CRect rectGripper,
    BOOL bHorz,
    CBasePane* pBar);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo para uma barra de controle.

rectGripper
[in] O retângulo delimitador da barra de controle.

bHorz
[in] Um parâmetro booliano que especifica se a barra de controle está encaixada horizontal ou verticalmente.

pBar
[in] Um ponteiro para uma barra de controle. O gerenciador visual desenha a garra dessa barra de controle.

Comentários

A implementação padrão desse método exibe a garra padrão. Para personalizar a aparência da garra, substitua esse método em uma classe personalizada derivada da classe CMFCVisualManager.

CMFCVisualManager::OnDrawBrowseButton

A estrutura chama esse método quando desenha o botão procurar para um controle de edição.

virtual BOOL OnDrawBrowseButton(
    CDC* pDC,
    CRect rect,
    CMFCEditBrowseCtrl* pEdit,
    CMFCVisualManager::AFX_BUTTON_STATE state,
    COLORREF& clrText);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica o limite do botão Procurar.

pEdit
[in] Um ponteiro para um controle de edição. O gerenciador visual desenha o botão Procurar para esse controle de edição.

state
[in] Um valor enumerado que especifica o estado do botão.

clrTexto
[out] Uma referência a um parâmetro COLORREF. Esse é um valor reservado e não é atualmente.

Valor de retorno

TRUE se tiver êxito; caso contrário, FALSE.

Comentários

Substitua essa função em uma classe derivada se quiser personalizar a aparência dos botões Procurar em instâncias da classe CMFCEditBrowseCtrl. Os valores possíveis para o estado do botão são ButtonsIsRegular, ButtonsIsPressed e ButtonsIsHighlighted.

CMFCVisualManager::OnDrawButtonBorder

A estrutura chama esse método quando desenha a borda de um botão de barra de ferramentas.

virtual void OnDrawButtonBorder(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo de um botão de barra de ferramentas.

pButton
[in] Um ponteiro para um botão de barra de ferramentas. A estrutura desenha a borda desse botão.

rect
[in] Um retângulo que especifica os limites do botão de barra de ferramentas.

state
[in] Um tipo de dados enumerado que especifica o estado atual do botão de barra de ferramentas.

Comentários

A implementação padrão desse método exibe a borda padrão. Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de um botão de barra de ferramentas.

Os estados possíveis de um botão de barra de ferramentas são ButtonsIsRegular, ButtonsIsPressed ou ButtonsIsHighlighted.

CMFCVisualManager::OnDrawButtonSeparator

virtual void OnDrawButtonSeparator(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state,
    BOOL bHorz);

Parâmetros

[in] pDC
[in] pButton
[in] rect
[in] state
[in] bHorz

Comentários

CMFCVisualManager::OnDrawCaptionBarBorder

A estrutura chama esse método quando desenha a borda de um objeto classe CMFCCaptionBar.

virtual void OnDrawCaptionBarBorder(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect,
    COLORREF clrBarBorder,
    BOOL bFlatBorder);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pBar
[in] Um ponteiro para um objeto CMFCCaptionBar. A estrutura desenha essa barra de legenda.

rect
[in] Um retângulo que especifica os limites da barra de legenda.

clrBarBorder
[in] A cor da borda.

bFlatBorder
[in] Um parâmetro booliano que especifica se a borda tem uma aparência 2D plana.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência da borda de uma barra de legenda.

CMFCVisualManager::OnDrawCaptionBarButtonBorder

virtual void OnDrawCaptionBarButtonBorder(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted,
    BOOL bIsDisabled,
    BOOL bHasDropDownArrow,
    BOOL bIsSysButton);

Parâmetros

[in] pDC
[in] pBar
[in] rect
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton

Comentários

CMFCVisualManager::OnDrawCaptionBarInfoArea

virtual void OnDrawCaptionBarInfoArea(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect);

Parâmetros

[in] pDC
[in] pBar
[in] rect

Comentários

CMFCVisualManager::OnDrawCaptionButton

A estrutura chama esse método quando desenha um objeto CMFCCaptionButton.

virtual void OnDrawCaptionButton (
    CDC* pDC,
    CMFCCaptionButton* pButton,
    BOOL bActive,
    BOOL bHorz,
    BOOL bMaximized,
    BOOL bDisabled,
    int nImageID = -1);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para um objeto CMFCCaptionButton. A estrutura desenha esse botão de legenda.

bActive
[in] Um parâmetro booliano que especifica se o botão está ativo.

bHorz
[in] Um parâmetro booliano que especifica se a legenda é horizontal.

bMaximized
[in] Um parâmetro booliano que especifica se o painel pai é maximizado.

bDisabled
[in] Um parâmetro booliano que especifica se o botão de legenda está desabilitado.

nImageID
[in] O índice de imagem do ícone a ser usado para o botão. Se nImageID for -1, esse método usará o índice de imagem registrado em pButton.

Comentários

A implementação padrão desse método exibe um pequeno botão da instância global da classe CMenuImages. Os botões são listados no arquivo de cabeçalho para CMenuImages. Alguns exemplos incluem CMenuImages::IdClose, CMenuImages::IdArowLeft, CMenuImages::IdArowRight, CMenuImages::IdArowDown, CMenuImages::IdArowUp e CMenuImages::IdPinHorz.

Substitua esse método em uma classe derivada para personalizar a aparência dos botões de legenda.

CMFCVisualManager::OnDrawCheckBox

virtual void OnDrawCheckBox(
    CDC* pDC,
    CRect rect,
    BOOL bHighlighted,
    BOOL bChecked,
    BOOL bEnabled);

Parâmetros

[in] pDC
[in] rect
[in] bHighlighted
[in] bChecked
[in] bEnabled

Comentários

CMFCVisualManager::OnDrawCheckBoxEx

virtual void OnDrawCheckBoxEx(
    CDC* pDC,
    CRect rect,
    int nState,
    BOOL bHighlighted,
    BOOL bPressed,
    BOOL bEnabled);

Parâmetros

[in] pDC
[in] rect
[in] nState
[in] bHighlighted
[in] bPressed
[in] bEnabled

Comentários

CMFCVisualManager::OnDrawComboBorder

A estrutura chama esse método quando desenha a borda em torno de uma instância da classe CMFCToolBarComboBoxButton.

virtual void OnDrawComboBorder(
    CDC* pDC,
    CRect rect,
    BOOL bDisabled,
    BOOL bIsDropped,
    BOOL bIsHighlighted,
    CMFCToolBarComboBoxButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo de um botão de caixa de combinação.

rect
[in] Um retângulo que especifica os limites do botão de caixa de combinação.

bDisabled
[in] Um parâmetro booliano que indica se o botão de caixa de combinação não está disponível.

bIsDropped
[in] Um parâmetro booliano que indica se a caixa de combinação é suspensa.

bIsHighlighted
[in] Um parâmetro booliano que indica se o botão de caixa de combinação está realçado.

pButton
[in] Um ponteiro para um objeto CMFCToolBarComboBoxButton. A estrutura desenha esse botão de caixa de combinação.

Comentários

Substitua esse método no gerenciador visual derivado para personalizar a aparência da borda da caixa de combinação.

CMFCVisualManager::OnDrawComboDropButton

A estrutura chama esse método quando desenha o botão soltar de um CMFCToolBarComboBoxButton.

virtual void OnDrawComboDropButton(
    CDC* pDC,
    CRect rect,
    BOOL bDisabled,
    BOOL bIsDropped,
    BOOL bIsHighlighted,
    CMFCToolBarComboBoxButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão soltar.

bDisabled
[in] Um parâmetro booliano que indica se o botão soltar não está disponível.

bIsDropped
[in] Um parâmetro booliano que indica se a caixa de combinação é suspensa.

bIsHighlighted
[in] Um parâmetro booliano que indica se o botão soltar está realçado.

pButton
[in] Um ponteiro para um objeto CMFCToolBarComboBoxButton. A estrutura desenha o botão soltar para esse botão de caixa de combinação.

Comentários

Substitua esse método no gerenciador visual derivado para personalizar a aparência do botão soltar de um botão de caixa de combinação.

CMFCVisualManager::OnDrawControlBorder

virtual void OnDrawControlBorder(CWnd* pWndCtrl);

Parâmetros

[in] pWndCtrl

Comentários

CMFCVisualManager::OnDrawDefaultRibbonImage

A estrutura chama esse método quando desenha a imagem padrão usada para o botão da faixa de opções.

virtual void OnDrawDefaultRibbonImage(
    CDC* pDC,
    CRect rectImage,
    BOOL bIsDisabled = FALSE,
    BOOL bIsPressed = FALSE,
    BOOL bIsHighlighted = FALSE);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectImage
[in] Um retângulo que especifica os limites da imagem padrão.

bIsDisabled
[in] Um parâmetro booliano que indica se o botão da faixa de opções não está disponível.

bIsPressed
[in] Um parâmetro booliano que indica se o botão da faixa de opções está pressionado.

bIsHighlighted
[in] Um parâmetro booliano que indica se o botão da faixa de opções está realçado.

Comentários

Substitua esse método em um gerenciador visual derivado se quiser personalizar a imagem usada para o botão da faixa de opções.

CMFCVisualManager::OnDrawEditBorder

A estrutura chama esse método quando desenha a borda ao redor de uma instância da classe CMFCToolBarEditBoxButton.

virtual void OnDrawEditBorder(
    CDC* pDC,
    CRect rect,
    BOOL bDisabled,
    BOOL bIsHighlighted,
    CMFCToolBarEditBoxButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do CMFCToolBarEditBoxButton.

bDisabled
[in] Um parâmetro booliano que indica se o botão não está disponível.

bIsHighlighted
[in] Um parâmetro booliano que indica se o botão está realçado.

pButton
[in] Um ponteiro para um objeto CMFCToolBarEditBoxButton. A estrutura desenha a borda desse botão da caixa de edição.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a borda de um objeto CMFCToolBarEditBoxButton.

CMFCVisualManager::OnDrawExpandingBox

virtual void OnDrawExpandingBox(
    CDC* pDC,
    CRect rect,
    BOOL bIsOpened,
    COLORREF colorBox);

Parâmetros

[in] pDC
[in] rect
[in] bIsOpened
[in] colorBox

Comentários

CMFCVisualManager::OnDrawFloatingToolbarBorder

A estrutura chama esse método quando desenha a borda de uma barra de ferramentas flutuante.

virtual void OnDrawFloatingToolbarBorder(
    CDC* pDC,
    CMFCBaseToolBar* pToolBar,
    CRect rectBorder,
    CRect rectBorderSize);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pToolBar
[in] Um ponteiro para a barra de ferramentas flutuante.

rectBorder
[in] Um retângulo que especifica os limites da barra de ferramentas flutuante.

rectBorderSize
[in] Um retângulo que especifica o tamanho da borda da barra de ferramentas.

Comentários

Uma barra de ferramentas flutuante é uma barra de ferramentas que aparece como uma janela com minimoldura. Normalmente, isso ocorre quando um usuário arrasta uma barra de ferramentas para que não esteja mais encaixada.

O tamanho da borda é especificado pelo parâmetro correspondente em rectBorderSize. Por exemplo, a largura da borda superior da barra de ferramentas é especificada por rectBorderSize.top.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de uma barra de ferramentas flutuante.

CMFCVisualManager::OnDrawHeaderCtrlBorder

A estrutura chama esse método quando desenha a borda ao redor de uma instância da classe CMFCHeaderCtrl.

virtual void OnDrawHeaderCtrlBorder(
    CMFCHeaderCtrl* pCtrl,
    CDC* pDC,
    CRect& rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted);

Parâmetros

pCtrl
[in] Um ponteiro para um objeto CMFCHeaderCtrl. A estrutura desenha a borda desse controle de cabeçalho.

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do controle de cabeçalho.

bIsPressed
[in] Um parâmetro booliano que indica se o controle de cabeçalho está pressionado.

bIsHighlighted
[in] Um parâmetro booliano que indica se o controle de cabeçalho está realçado.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a borda do controle de cabeçalho.

CMFCVisualManager::OnDrawHeaderCtrlSortArrow

A estrutura chama essa função quando desenha a seta de classificação de um controle de cabeçalho.

virtual void OnDrawHeaderCtrlSortArrow(
    CMFCHeaderCtrl* pCtrl,
    CDC* pDC,
    CRect& rect,
    BOOL bIsUp);

Parâmetros

pCtrl
[in] Um ponteiro para um controle de cabeçalho. O gerenciador visual desenha a seta de classificação deste objeto classe CMFCHeaderCtrl.

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites da seta de classificação.

bIsUp
[in] Um booliano que especifica a direção da seta de classificação.

Comentários

Se bIsUp for TRUE, o gerenciador visual desenhará uma seta de classificação para cima. Se for FALSE, o gerenciador visual desenhará uma seta de classificação para baixo. Substitua OnDrawHeaderCtrlSortArrow em uma classe derivada para personalizar a aparência do botão de classificação.

CMFCVisualManager::OnDrawMenuArrowOnCustomizeList

virtual void OnDrawMenuArrowOnCustomizeList(
    CDC* pDC,
    CRect rectCommand,
    BOOL bSelected);

Parâmetros

[in] pDC
[in] rectCommand
[in] bSelected

Comentários

CMFCVisualManager::OnDrawMenuBorder

A estrutura chama esse método quando desenha a borda de um CMFCPopupMenu.

virtual void OnDrawMenuBorder(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo para um objeto CMFCPopupMenu.

pMenu
[in] Um ponteiro para um objeto CMFCPopupMenu. A estrutura desenha uma borda ao redor desse menu pop-up.

rect
[in] Um retângulo que especifica os limites do menu pop-up.

Comentários

A implementação padrão desse método exibe a borda do menu padrão. Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda do menu.

CMFCVisualManager::OnDrawMenuCheck

virtual void OnDrawMenuCheck(
    CDC* pDC,
    CMFCToolBarMenuButton* pButton,
    CRect rect,
    BOOL bHighlight,
    BOOL bIsRadio);

Parâmetros

[in] pDC
[in] pButton
[in] rect
[in] bHighlight
[in] bIsRadio

Comentários

CMFCVisualManager::OnDrawMenuItemButton

virtual void OnDrawMenuItemButton(
    CDC* pDC,
    CMFCToolBarMenuButton* pButton,
    CRect rectButton,
    BOOL bHighlight,
    BOOL bDisabled);

Parâmetros

[in] pDC
[in] pButton
[in] rectButton
[in] bHighlight
[in] bDisabled

Comentários

CMFCVisualManager::OnDrawMenuLabel

virtual COLORREF OnDrawMenuLabel(
    CDC* pDC,
    CRect rect);

Parâmetros

[in] pDC
[in] rect

Valor de retorno

Comentários

CMFCVisualManager::OnDrawMenuResizeBar

virtual void OnDrawMenuResizeBar(
    CDC* pDC,
    CRect rect,
    int nResizeFlags);

Parâmetros

[in] pDC
[in] rect
[in] nResizeFlags

Comentários

CMFCVisualManager::OnDrawMenuScrollButton

A estrutura chama esse método quando desenha um botão de rolagem de menu.

virtual void OnDrawMenuScrollButton(
    CDC* pDC,
    CRect rect,
    BOOL bIsScrollDown,
    BOOL bIsHighlited,
    BOOL bIsPressed,
    BOOL bIsDisabled);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão de rolagem.

bIsScrollDown
[in] Um booliano que indica o tipo de botão que o gerenciador visual desenha. Um valor de TRUE indica que o gerenciador visual desenha um botão para baixo.

bIsHighlited
[in] Um booliano que indica se o botão está realçado.

bIsPressed
[in] Um booliano que indica se o botão está pressionado.

bIsDisabled
[in] Um booliano que indica se o botão está desabilitado.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões de rolagem do menu. Os botões de rolagem do menu aparecem na borda dos menus pop-up quando a altura total dos itens de menu excede a altura do menu pop-up.

CMFCVisualManager::OnDrawMenuShadow

virtual void OnDrawMenuShadow(
    CDC* pDC,
    const CRect& rectClient,
    const CRect& rectExclude,
    int nDepth,
    int iMinBrightness,
    int iMaxBrightness,
    CBitmap* pBmpSaveBottom,
    CBitmap* pBmpSaveRight,
    BOOL bRTL);

Parâmetros

[in] pDC
[in] rectClient
[in] rectExclude
[in] nDepth
[in] iMinBrightness
[in] iMaxBrightness
[in] pBmpSaveBottom
[in] pBmpSaveRight
[in] bRTL

Comentários

CMFCVisualManager::OnDrawMenuSystemButton

A estrutura chama esse método quando desenha um botão do sistema de menus para o aplicativo.

virtual void OnDrawMenuSystemButton(
    CDC* pDC,
    CRect rect,
    UINT uiSystemCommand,
    UINT nStyle,
    BOOL bHighlight);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão.

uiSystemCommand
[in] Um sinalizador que especifica qual comando do sistema está associado ao botão. Os valores possíveis são SC_CLOSE, SC_MINIMIZE e SC_RESTORE.

nEstilo
[in] Um sinalizador que especifica o estilo atual do botão. Os valores possíveis são TBBS_PRESSED, TBBS_DISABLED e 0.

bHighlight
[in] Um parâmetro booliano que especifica se o botão está realçado.

Comentários

Os botões do sistema de menus são os botões Fechar, Minimizar, Maximizar e Restaurar localizados na barra de título.

A implementação padrão para esse método chama CDC::DrawFrameControl com o tipo DFC_CAPTION. Substitua esse método na classe do gerenciador visual derivada para personalizar a aparência dos botões do sistema.

CMFCVisualManager::OnDrawMiniFrameBorder

virtual void OnDrawMiniFrameBorder(
    CDC* pDC,
    CPaneFrameWnd* pFrameWnd,
    CRect rectBorder,
    CRect rectBorderSize);

Parâmetros

[in] pDC
[in] pFrameWnd
[in] rectBorder
[in] rectBorderSize

Comentários

CMFCVisualManager::OnDrawOutlookBarSplitter

A estrutura chama esse método quando desenha o divisor para uma barra do Outlook.

virtual void OnDrawOutlookBarSplitter(
    CDC* pDC,
    CRect rectSplitter);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectSplitter
[in] Um retângulo que especifica os limites do divisor.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos divisores em uma barra do Outlook.

CMFCVisualManager::OnDrawOutlookPageButtonBorder

Chamado pela estrutura quando desenha a borda de um botão de página do Outlook.

virtual void OnDrawOutlookPageButtonBorder(
    CDC* pDC,
    CRect& rectBtn,
    BOOL bIsHighlighted,
    BOOL bIsPressed);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectBtn
[in] Um retângulo que especifica o limite do botão de página do Outlook.

bIsHighlighted
[in] Um booliano que especifica se o botão está realçado.

bIsPressed
[in] Um booliano que especifica se o botão está pressionado.

Comentários

Substitua esse método em um gerenciador visual personalizado para alterar a aparência do botão de página do Outlook.

CMFCVisualManager::OnDrawPaneBorder

A estrutura chama esse método quando desenha a borda de um objeto da classe CPane.

virtual void OnDrawPaneBorder(
    CDC* pDC,
    CBasePane* pBar,
    CRect& rect);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo de uma barra de controle.

pBar
[in] Um ponteiro para um painel. O gerenciador visual desenha a borda deste painel.

rect
[in] Um retângulo que indica os limites do painel.

Comentários

A implementação padrão desse método exibe a borda padrão. Substitua esse método em uma classe derivada para personalizar a aparência da borda.

CMFCVisualManager::OnDrawPaneCaption

A estrutura chama esse método quando desenha uma legenda para uma instância da classe CDockablePane.

virtual COLORREF OnDrawPaneCaption(
    CDC* pDC,
    CDockablePane* pBar,
    BOOL bActive,
    CRect rectCaption,
    CRect rectButtons);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pBar
[in] Um ponteiro para um objeto CDockablePane. A estrutura desenha a legenda deste painel.

bActive
[in] Um parâmetro booliano que indica se a barra de controle está ativa.

rectCaption
[in] Um retângulo que especifica os limites da legenda.

rectButtons
[in] Um retângulo que especifica os limites dos botões de legenda.

Valor de retorno

Um parâmetro COLORREF que indica a cor do texto da legenda.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência das legendas do painel.

CMFCVisualManager::OnDrawPaneDivider

virtual void OnDrawPaneDivider(
    CDC* pDC,
    CPaneDivider* pSlider,
    CRect rect,
    BOOL bAutoHideMode);

Parâmetros

[in] pDC
[in] pSlider
[in] rect
[in] bAutoHideMode

Comentários

CMFCVisualManager::OnDrawPopupWindowBorder

virtual void OnDrawPopupWindowBorder(
    CDC* pDC,
    CRect rect);

Parâmetros

[in] pDC
[in] rect

Comentários

CMFCVisualManager::OnDrawPopupWindowButtonBorder

virtual void OnDrawPopupWindowButtonBorder(
    CDC* pDC,
    CRect rectClient,
    CMFCDesktopAlertWndButton* pButton);

Parâmetros

[in] pDC
[in] rectClient
[in] pButton

Comentários

CMFCVisualManager::OnDrawPopupWindowCaption

virtual COLORREF OnDrawPopupWindowCaption(
    CDC* pDC,
    CRect rectCaption,
    CMFCDesktopAlertWnd* pPopupWnd);

Parâmetros

[in] pDC
[in] rectCaption
[in] pPopupWnd

Valor de retorno

Comentários

CMFCVisualManager::OnDrawRibbonApplicationButton

A estrutura chama esse método quando desenha o Botão Principal na faixa de opções.

virtual void OnDrawRibbonApplicationButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para o Botão Principal na faixa de opções.

Comentários

Substitua esse método em um gerenciador visual derivado se quiser personalizar a aparência do Botão Principal.

CMFCVisualManager::OnDrawRibbonButtonBorder

A estrutura chama esse método quando desenha a borda de um botão na faixa de opções.

virtual void OnDrawRibbonButtonBorder(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para um objeto CMFCRibbonButton. A estrutura desenha a borda para esse botão da faixa de opções.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um arquivo CMFCRibbonButton.

CMFCVisualManager::OnDrawRibbonButtonsGroup

A estrutura chama esse método quando desenha um grupo de botões na faixa de opções.

virtual COLORREF OnDrawRibbonButtonsGroup(
    CDC* pDC,
    CMFCRibbonButtonsGroup* pGroup,
    CRect rectGroup);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pGroup
[in] Um ponteiro para um grupo de botões na faixa de opções. A estrutura desenha esse grupo de botões.

rectGroup
[in] Um retângulo que especifica os limites do grupo.

Valor de retorno

Um valor reservado. A implementação padrão retorna -1.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um grupo de botões na faixa de opções.

CMFCVisualManager::OnDrawRibbonCaption

A estrutura chama esse método quando desenha a barra de legenda da janela do quadro principal. A estrutura chamará esse método somente se a faixa de opções estiver integrada ao quadro principal.

virtual void OnDrawRibbonCaption(
    CDC* pDC,
    CMFCRibbonBar* pBar,
    CRect rect,
    CRect rectText);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pBar
[in] Um ponteiro para uma barra da faixa de opções. O gerenciador visual desenha essa barra da faixa de opções.

rect
[in] Um retângulo que especifica os limites da barra da faixa de opções.

rectText
[in] Um retângulo que especifica os limites do texto da barra de legenda.

Comentários

Substitua essa função em um gerenciador visual derivado para personalizar a aparência da barra de legenda. Esse método afetará a barra de legenda somente se a faixa de opções estiver integrada à janela do quadro principal.

CMFCVisualManager::OnDrawRibbonCaptionButton

A estrutura chama esse método quando desenha um botão de título localizado na barra da faixa de opções.

virtual void OnDrawRibbonCaptionButton(
    CDC* pDC,
    CMFCRibbonCaptionButton* pButton);

Parâmetros

pDC
Um ponteiro para um contexto de dispositivo.

pButton
Um ponteiro para uma classe CMFCRibbonCaptionButton. A estrutura desenha esse botão de legenda.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um botão de legenda na faixa de opções.

CMFCVisualManager::OnDrawRibbonCategory

A estrutura chama esse método quando desenha um objeto CMFCRibbonCategory.

virtual void OnDrawRibbonCategory(
    CDC* pDC,
    CMFCRibbonCategory* pCategory,
    CRect rectCategory);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pCategory
[in] Um ponteiro para um objeto CMFCRibbonCategory. A estrutura desenha essa categoria da faixa de opções.

rectCategory
[in] Um retângulo que especifica o limite de todos os painéis de categoria na faixa de opções.

Comentários

Uma categoria da faixa de opções é um agrupamento lógico de comandos do menu. Para obter mais informações sobre as categorias de faixa de opções, consulte classe CMFCRibbonCategory.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de uma categoria da faixa de opções.

CMFCVisualManager::OnDrawRibbonCategoryCaption

A estrutura chama esse método quando desenha a barra de legenda para uma categoria da faixa de opções.

virtual COLORREF OnDrawRibbonCategoryCaption(
    CDC* pDC,
    CMFCRibbonContextCaption* pContextCaption);

Parâmetros

pDC
[in] O contexto do desenho.

pContextCaption
[in] Um ponteiro para uma barra de legenda. O gerenciador visual desenha esse objeto classe CMFCRibbonContextCaption.

Valor de retorno

Um parâmetro COLORREF que indica a cor do texto na barra de legenda.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência da barra de legenda para uma categoria de faixa de opções. Para obter mais informações sobre a barra de legendas, consulte classe CMFCRibbonContextCaption.

CMFCVisualManager::OnDrawRibbonCategoryScroll

virtual void OnDrawRibbonCategoryScroll(
    CDC* pDC,
    CRibbonCategoryScroll* pScroll);

Parâmetros

[in] pDC
[in] pScroll

Comentários

CMFCVisualManager::OnDrawRibbonCategoryTab

A estrutura chama esse método quando desenha a guia para uma categoria de faixa de opções.

virtual COLORREF OnDrawRibbonCategoryTab(
    CDC* pDC,
    CMFCRibbonTab* pTab,
    BOOL bIsActive);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pTab
[in] Um ponteiro para uma instância da CMFCRibbonTabclasse. A estrutura desenha essa guia.

bIsActive
[in] Um parâmetro booliano que indica se a guia está ativa.

Valor de retorno

A cor usada para texto na guia categoria da faixa de opções.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de uma guia de categoria da faixa de opções. Para obter mais informações sobre as categorias da faixa de opções, consulte classe CMFCRibbonCategory.

CMFCVisualManager::OnDrawRibbonCheckBoxOnList

virtual void OnDrawRibbonCheckBoxOnList(
    CDC* pDC,
    CMFCRibbonCheckBox* pCheckBox,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parâmetros

[in] pDC
[in] pCheckBox
[in] rect
[in] bIsSelected
[in] bHighlighted

Comentários

CMFCVisualManager::OnDrawRibbonColorPaletteBox

virtual void OnDrawRibbonColorPaletteBox(
    CDC* pDC,
    CMFCRibbonColorButton* pColorButton,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF color,
    CRect rect,
    BOOL bDrawTopEdge,
    BOOL bDrawBottomEdge,
    BOOL bIsHighlighted,
    BOOL bIsChecked,
    BOOL bIsDisabled);

Parâmetros

[in] pDC
[in] pColorButton
[in] pIcon
[in] color
[in] rect
[in] bDrawTopEdge
[in] bDrawBottomEdge
[in] bIsHighlighted
[in] bIsChecked
[in] bIsDisabled

Comentários

CMFCVisualManager::OnDrawRibbonDefaultPaneButton

A estrutura chama esse método quando desenha o botão padrão para o painel da faixa de opções.

virtual void OnDrawRibbonDefaultPaneButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para o botão padrão do painel da faixa de opções.

Comentários

A estrutura exibe o botão padrão quando um painel da faixa de opções é redimensionado para o tamanho mínimo e não há área para exibir o conteúdo do painel. Quando o usuário clica no botão padrão, a estrutura exibe um menu suspenso que contém o conteúdo do painel.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência do botão padrão.

CMFCVisualManager::OnDrawRibbonDefaultPaneButtonContext

virtual void OnDrawRibbonDefaultPaneButtonContext(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

[in] pDC
[in] pButton

Comentários

CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator

virtual void OnDrawRibbonDefaultPaneButtonIndicator(
    CDC* pDC,
    CMFCRibbonButton* pButton,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parâmetros

[in] pDC
[in] pButton
[in] rect
[in] bIsSelected
[in] bHighlighted

Comentários

CMFCVisualManager::OnDrawRibbonGalleryBorder

virtual void OnDrawRibbonGalleryBorder(
    CDC* pDC,
    CMFCRibbonGallery* pButton,
    CRect rectBorder);

Parâmetros

[in] pDC
[in] pButton
[in] rectBorder

Comentários

CMFCVisualManager::OnDrawRibbonGalleryButton

virtual void OnDrawRibbonGalleryButton(
    CDC* pDC,
    CMFCRibbonGalleryIcon* pButton);

Parâmetros

[in] pDC
[in] pButton

Comentários

CMFCVisualManager::OnDrawRibbonKeyTip

virtual void OnDrawRibbonKeyTip(
    CDC* pDC,
    CMFCRibbonBaseElement* pElement,
    CRect rect,
    CString str);

Parâmetros

[in] pDC
[in] pElement
[in] rect
[in] str

Comentários

CMFCVisualManager::OnDrawRibbonLabel

A estrutura chama esse método quando desenha o rótulo da faixa de opções.

virtual void OnDrawRibbonLabel(
    CDC* pDC,
    CMFCRibbonLabel* pLabel,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pLabel
[in] Um ponteiro para um objeto CMFCRibbonLabel. A estrutura desenha esse rótulo da faixa de opções.

rect
[in] Um retângulo que especifica os limites do painel da faixa de opções.

Comentários

Substitua esse método em uma classe derivada para personalizar o rótulo da faixa de opções.

CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder

A estrutura chama esse método quando desenha a borda de um CMFCRibbonButton posicionado no painel Principal.

virtual void OnDrawRibbonMainPanelButtonBorder(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para um CMFCRibbonButton localizado no painel principal da faixa de opções. A estrutura desenha a borda para esse botão.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de um CMFCRibbonButton no painel Principal.

CMFCVisualManager::OnDrawRibbonMainPanelFrame

A estrutura chama esse método quando desenha o quadro ao redor do CMFCRibbonMainPanel.

virtual void OnDrawRibbonMainPanelFrame(
    CDC* pDC,
    CMFCRibbonMainPanel* pPanel,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pPanel
[in] Um ponteiro para o CMFCRibbonMainPanel.

rect
[in] Um retângulo que especifica os limites de CMFCRibbonMainPanel.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência do quadro para o CMFCRibbonMainPanel.

CMFCVisualManager::OnDrawRibbonMenuCheckFrame

virtual void OnDrawRibbonMenuCheckFrame(
    CDC* pDC,
    CMFCRibbonButton* pButton,
    CRect rect);

Parâmetros

[in] pDC
[in] pButton
[in] rect

Comentários

CMFCVisualManager::OnDrawRibbonPanel

A estrutura chama esse método quando desenha um objeto CMFCRibbonPanel.

virtual COLORREF OnDrawRibbonPanel(
    CDC* pDC,
    CMFCRibbonPanel* pPanel,
    CRect rectPanel,
    CRect rectCaption);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pPanel
[in] Um ponteiro para um objeto CMFCRibbonPanel. A estrutura desenha esse painel da faixa de opções.

rectPanel
[in] Um retângulo que especifica os limites do painel.

rectCaption
[in] Um retângulo que especifica os limites da legenda do painel.

Valor de retorno

A cor do texto no painel da faixa de opções.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência de um painel da faixa de opções.

CMFCVisualManager::OnDrawRibbonPanelCaption

A estrutura chama esse método quando desenha a legenda de uma classe CMFCRibbonPanel.

virtual void OnDrawRibbonPanelCaption(
    CDC* pDC,
    CMFCRibbonPanel* pPanel,
    CRect rectCaption);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pPanel
[in] Um ponteiro para um objeto CMFCRibbonPanel. A estrutura desenha a legenda para esse painel da faixa de opções.

rectCaption
[in] Um retângulo que especifica os limites da legenda para o painel da faixa de opções.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência das legendas dos painéis da faixa de opções.

CMFCVisualManager::OnDrawRibbonProgressBar

A estrutura chama esse método quando desenha uma classe CMFCRibbonProgressBar.

virtual void OnDrawRibbonProgressBar(
    CDC* pDC,
    CMFCRibbonProgressBar* pProgress,
    CRect rectProgress,
    CRect rectChunk,
    BOOL bInfiniteMode);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pProgress
[in] Um ponteiro para um objeto CMFCRibbonProgressBar. A estrutura desenha essa barra de progresso.

rectProgress
[in] Um retângulo que especifica os limites da barra de progresso.

rectChunk
[in] Um retângulo que especifica os limites da área ao redor da barra de progresso.

bInfiniteMode
[in] Um parâmetro booliano que indica o modo da barra de progresso. Um valor TRUE significa que a barra está no modo infinito. A implementação padrão não usa esse parâmetro.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência de uma barra de progresso.

CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator

A estrutura chama esse método quando desenha um separador na Barra de Ferramentas de Acesso Rápido de uma faixa de opções.

virtual void OnDrawRibbonQuickAccessToolBarSeparator(
    CDC* pDC,
    CMFCRibbonSeparator* pSeparator,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSeparator
[in] Um ponteiro para um objeto CMFCRibbonSeparator. A estrutura desenha esse separador de faixa de opções.

rect
[in] Um retângulo que especifica os limites do separador.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência dos separadores da faixa de opções na Barra de Ferramentas de Acesso Rápido.

CMFCVisualManager::OnDrawRibbonRecentFilesFrame

A estrutura chama esse método quando desenha um quadro ao redor de uma lista de arquivos recentes.

virtual void OnDrawRibbonRecentFilesFrame(
    CDC* pDC,
    CMFCRibbonMainPanel* pPanel,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pPanel
[in] Um ponteiro para o painel Principal na faixa de opções.

rect
[in] Um retângulo que especifica os limites do quadro para a lista de arquivos recentes.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da lista de arquivos recentes.

CMFCVisualManager::OnDrawRibbonSliderChannel

A estrutura chama esse método quando desenha o canal de uma classe CMFCRibbonSlider.

virtual void OnDrawRibbonSliderChannel(
    CDC* pDC,
    CMFCRibbonSlider* pSlider,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSlider
[in] Um ponteiro para um objeto CMFCRibbonSlider. A estrutura desenha o canal para este controle deslizante da faixa de opções.

rect
[in] Um retângulo que especifica os limites para o canal do controle deslizante da faixa de opções.

Comentários

Substitua esse método em uma classe derivada para personalizar a aparência do canal do controle deslizante da faixa de opções.

CMFCVisualManager::OnDrawRibbonSliderThumb

A estrutura chama esse método quando desenha a miniatura de um objeto CMFCRibbonSlider.

virtual void OnDrawRibbonSliderThumb(
    CDC* pDC,
    CMFCRibbonSlider* pSlider,
    CRect rect,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSlider
[in] Um ponteiro para um CMFCRibbonSlider. A estrutura desenha o polegar para este controle deslizante da faixa de opções.

rect
[in] Um retângulo que especifica os limites da miniatura para o controle deslizante da faixa de opções.

bIsHighlighted
[in] Um parâmetro booliano que indica se a miniatura está realçada.

bIsPressed
[in] Um parâmetro booliano que indica se a miniatura está pressionada.

bIsDisabled
[in] Um parâmetro booliano que indica se a miniatura não está disponível.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da miniatura para um arquivo CMFCRibbonSlider.

CMFCVisualManager::OnDrawRibbonSliderZoomButton

A estrutura chama esse método quando desenha os botões de zoom para um objeto CMFCRibbonSlider.

virtual void OnDrawRibbonSliderZoomButton(
    CDC* pDC,
    CMFCRibbonSlider* pSlider,
    CRect rect,
    BOOL bIsZoomOut,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSlider
[in] Um ponteiro para um objeto CMFCRibbonSlider. A estrutura desenha esse controle deslizante da faixa de opções.

rect
[in] Um retângulo que especifica os limites dos botões de zoom no controle deslizante da faixa de opções.

bIsZoomOut
[in] Um parâmetro booliano que indica qual botão a estrutura desenha. Um valor de TRUE indica o botão esquerdo com um "-" para reduzir. Um valor FALSE indica o botão direito com um "+" para ampliar.

bIsHighlighted
[in] Um parâmetro booliano que indica se o botão está realçado.

bIsPressed
[in] Um parâmetro booliano que indica se o botão está pressionado.

bIsDisabled
[in] Um parâmetro booliano que indica se o botão não está disponível.

Comentários

Por padrão, os botões de zoom no controle deslizante da faixa de opções são um círculo com um sinal de + ou de - no centro. Para personalizar a aparência dos botões de zoom, substitua esse método em um gerenciador visual derivado.

CMFCVisualManager::OnDrawRibbonStatusBarPane

A estrutura chama esse método quando desenha um painel na barra de status.

virtual COLORREF OnDrawRibbonStatusBarPane(
    CDC* pDC,
    CMFCRibbonStatusBar* pBar,
    CMFCRibbonStatusBarPane* pPane);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pBar
[in] Um ponteiro para a barra de status que contém o painel.

pPane
[in] Um ponteiro para um painel de barras de status. A estrutura desenha esse objeto CMFCRibbonStatusBarPane.

Valor de retorno

Um valor reservado. A implementação padrão retorna -1.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um painel na barra de status.

CMFCVisualManager::OnDrawRibbonTabsFrame

A estrutura chama esse método quando desenha o quadro ao redor de um conjunto de guias de faixa de opções.

virtual COLORREF OnDrawRibbonTabsFrame(
    CDC* pDC,
    CMFCRibbonBar* pWndRibbonBar,
    CRect rectTab);

Parâmetros

pDC
Um ponteiro para um contexto de dispositivo.

pWndRibbonBar
Um ponteiro para um objeto CMFCRibbonBar. A estrutura desenha o quadro para essa barra da faixa de opções.

rectTab
Um retângulo que especifica os limites das guias de faixa de opções.

Valor de retorno

Um valor reservado. Por padrão, esse método retorna -1.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar o quadro ao redor de um conjunto de guias na faixa de opções.

CMFCVisualManager::OnDrawScrollButtons

virtual void OnDrawScrollButtons(
    CDC* pDC,
    const CRect& rect,
    const int nBorderSize,
    int iImage,
    BOOL bHilited);

Parâmetros

[in] pDC
[in] rect
[in] nBorderSize
[in] iImage
[in] bHilited

Comentários

CMFCVisualManager::OnDrawSeparator

A estrutura chama esse método quando desenha um separador.

virtual void OnDrawSeparator(
    CDC* pDC,
    CBasePane* pBar,
    CRect rect,
    BOOL bIsHoriz);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo para uma barra de controle.

pBar
[in] Um ponteiro para um painel que contém o separador.

rect
[in] Um retângulo que especifica os limites do separador.

bIsHoriz
[in] Um parâmetro booliano que indica a orientação de um painel encaixado. Um valor TRUE indica que o painel está encaixado horizontalmente. Um valor FALSE indica que o painel está encaixado verticalmente.

Comentários

Separadores são usados em barras de controle para separar grupos de ícones relacionados. A implementação padrão para esse método exibe o separador padrão. Substitua esse método em um gerenciador visual derivado para personalizar a aparência do separador.

CMFCVisualManager::OnDrawShowAllMenuItems

virtual void OnDrawShowAllMenuItems(
    CDC* pDC,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state);

Parâmetros

[in] pDC
[in] rect
[in] state

Comentários

CMFCVisualManager::OnDrawSpinButtons

A estrutura chama esse método quando desenha uma instância da classe CMFCSpinButtonCtrl.

virtual void OnDrawSpinButtons(
    CDC* pDC,
    CRect rectSpin,
    int nState,
    BOOL bOrientation,
    CMFCSpinButtonCtrl* pSpinCtrl);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectSpin
[in] Um retângulo que especifica os limites do controle de rotação.

nState
[in] Um sinalizador que indica o estado do controle de rotação. Confira a seção Comentários para obter mais informações.

bOrientation
[in] Um parâmetro booliano que especifica a orientação do controle de rotação. Um valor de TRUE indica que o controle de rotação é horizontal. Caso contrário, é vertical.

pSpinCtrl
[in] Um ponteiro para um controle de rotação. A estrutura desenha os botões para esse controle.

Comentários

O parâmetro nState indica o estado do controle de rotação. O parâmetro é um dos seguintes valores:

• AFX_SPIN_PRESSEDUP

• AFX_SPIN_PRESSEDDOWN

• AFX_SPIN_HIGHLIGHTEDUP

• AFX_SPIN_HIGHLIGHTEDDOWN

• AFX_SPIN_DISABLED

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um controle de rotação.

CMFCVisualManager::OnDrawSplitterBorder

A estrutura chama esse método quando desenha a borda em torno de uma instância da classe CSplitterWndEx.

virtual void OnDrawSplitterBorder(
    CDC* pDC,
    CSplitterWndEx* pSplitterWnd,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSplitterWnd
[in] Um ponteiro para uma janela divisora. A estrutura desenha a borda para essa janela.

rect
[in] Um retângulo que especifica os limites da janela divisora.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de uma janela divisora.

CMFCVisualManager::OnDrawSplitterBox

A estrutura chama esse método quando desenha a caixa de arrastar para uma instância da classe CSplitterWndEx. A caixa de arrastar é exibida quando o usuário seleciona a barra de divisor e altera as dimensões das janelas filho.

virtual void OnDrawSplitterBox(
    CDC* pDC,
    CSplitterWndEx* pSplitterWnd,
    CRect& rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSplitterWnd
[in] Um ponteiro para uma janela divisora. A estrutura desenha a caixa para essa janela divisora.

rect
[in] Um retângulo que especifica os limites da janela divisora.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da caixa de arrastar para uma janela divisora.

CMFCVisualManager::OnDrawStatusBarPaneBorder

A estrutura chama esse método quando desenha a borda de um objeto CMFCStatusBar.

virtual void OnDrawStatusBarPaneBorder(
    CDC* pDC,
    CMFCStatusBar* pBar,
    CRect rectPane,
    UINT uiID,
    UINT nStyle);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pBar
[in] Um ponteiro para um objeto CMFCStatusBar. A estrutura desenha esse objeto de barra de status.

rectPane
[in] Um retângulo que especifica os limites da barra de status.

uiID
[in] A ID da barra de status.

nEstilo
[in] O estilo da barra de status.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de um objeto CMFCStatusBar.

CMFCVisualManager::OnDrawStatusBarProgress

A estrutura chama esse método quando desenha o indicador de progresso no objeto CMFCStatusBar.

virtual void OnDrawStatusBarProgress(
    CDC* pDC,
    CMFCStatusBar* pStatusBar,
    CRect rectProgress,
    int nProgressTotal,
    int nProgressCurr,
    COLORREF clrBar,
    COLORREF clrProgressBarDest,
    COLORREF clrProgressText,
    BOOL bProgressText);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo para a barra de status.

pStatusBar
[in] O objeto CMFCStatusBar que contém a barra de progresso.

rectProgress
[in] Um retângulo que especifica os limites da barra de progresso.

nProgressTotal
[in] O número total da barra de progresso.

nProgressCurr
[in] O progresso atual da barra de progresso.

clrBar
[in] Um parâmetro COLORREF que indica a cor inicial da barra de progresso. O valor é o início de um gradiente de cor ou a cor completa da barra de progresso.

clrProgressBarDest
[in] Um parâmetro COLORREF que indica o final de um gradiente de cores para a barra de progresso. Se clrProgressBarDest for -1, a estrutura não desenhará a barra de progresso como um gradiente de cores. Em vez disso, preencherá toda a barra de progresso com a cor especificada por clrBar.

clrProgressText
[in] Um parâmetro COLORREF que indica a cor do texto para a representação textual do progresso atual. Esse parâmetro será ignorado se bProgressText for definido como FALSE.

bTextoDeProgresso
[in] Um parâmetro booliano que indica se a representação textual do progresso atual deve ser exibida.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência do objeto CMFCStatusBar.

CMFCVisualManager::OnDrawStatusBarSizeBox

A estrutura chama esse método quando desenha a caixa de tamanho para CMFCStatusBar.

virtual void OnDrawStatusBarSizeBox(
    CDC* pDC,
    CMFCStatusBar* pStatBar,
    CRect rectSizeBox);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pStatBar
[in] Um ponteiro para uma barra de status. A estrutura desenha a caixa de tamanho para essa barra de status.

rectSizeBox
[in] Um retângulo que especifica os limites da caixa de tamanho.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da caixa de tamanho em um arquivo CMFCStatusBar.

CMFCVisualManager::OnDrawTab

A estrutura chama esse método quando desenha as guias para um objeto CMFCBaseTabCtrl.

virtual void OnDrawTab(
    CDC* pDC,
    CRect rectTab,
    int iTab,
    BOOL bIsActive,
    const CMFCBaseTabCtrl* pTabWnd);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectTab
[in] Um retângulo que especifica os limites do controle guia.

iTab
[in] O índice da guia que a estrutura desenha.

bIsActive
[in] Um parâmetro booliano que especifica se a guia está ativa.

pTabWnd
[in] Um ponteiro para um objeto CMFCBaseTabCtrl. A estrutura desenha esse controle guia.

Comentários

Um objeto CMFCBaseTabCtrl chama esse método quando processa a mensagem de WM_PAINT.

Substitua esse método em uma classe derivada para personalizar a aparência das guias.

CMFCVisualManager::OnDrawTabCloseButton

Chamado pela estrutura quando desenha o botão Fechar na guia ativa.

virtual void OnDrawTabCloseButton(
    CDC* pDC,
    CRect rect,
    const CMFCBaseTabCtrl* pTabWnd,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão Fechar.

pTabWnd
[in] Um ponteiro para um controle guia. A estrutura desenha o botão Fechar para esse controle guia.

bIsHighlighted
[in] Um parâmetro booliano que indica se o botão Fechar está realçado.

bIsPressed
[in] Um parâmetro booliano que indica se o botão Fechar está pressionado.

bIsDisabled
[in] Um parâmetro booliano que indica se o botão Fechar está desabilitado.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência do botão Fechar na guia ativa de pTabWnd.

CMFCVisualManager::OnDrawTabContent

A estrutura chama esse método quando desenha o conteúdo localizado no interior de uma instância da classe CMFCBaseTabCtrl.

virtual void OnDrawTabContent(
    CDC* pDC,
    CRect rectTab,
    int iTab,
    BOOL bIsActive,
    const CMFCBaseTabCtrl* pTabWnd,
    COLORREF clrText);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectTab
[in] Um retângulo que especifica os limites do interior da guia.

iTab
[in] O índice baseado em zero da guia. A estrutura desenha o interior desa guia.

bIsActive
[in] Um parâmetro booliano que indica se uma guia está ativa.

pTabWnd
[in] Um ponteiro para o controle com guias que contém a guia sendo desenhada.

clrTexto
[in] A cor do texto no interior da guia.

Comentários

O interior de uma guia contém o texto e os ícones da guia. Substitua esse método em um gerenciador visual derivado para personalizar a aparência das guias.

CMFCVisualManager::OnDrawTabsButtonBorder

A estrutura chama esse método quando desenha a borda de um botão de guia.

virtual void OnDrawTabsButtonBorder(
    CDC* pDC,
    CRect& rect,
    CMFCButton* pButton,
    UINT uiState,
    CMFCBaseTabCtrl* pWndTab);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão da guia.

pButton
[in] Um ponteiro para um objeto CMFCButton. A estrutura desenha a borda para esta instância CMFCButton.

uiState
[in] Um inteiro sem sinal que especifica o estado do botão.

pWndTab
[in] Um ponteiro para a janela com guias pai.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda do botão da guia.

CMFCVisualManager::OnDrawTask

A estrutura chama esse método quando desenha um objeto CMFCTasksPane.

virtual void OnDrawTask(
    CDC* pDC,
    CMFCTasksPaneTask* pTask,
    CImageList* pIcons,
    BOOL bIsHighlighted = FALSE,
    BOOL bIsSelected = FALSE);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pTask
[in] Um ponteiro para um objetoCMFCTasksPaneTask. A estrutura desenha essa tarefa.

pIcons
[in] Um ponteiro para a lista de imagens associada ao painel de tarefas. Cada tarefa contém um índice para uma imagem nesta lista.

bIsHighlighted
[in] Um parâmetro booliano que especifica se a tarefa exibida está realçada.

bIsSelected
[in] Um parâmetro booliano que especifica se a tarefa exibida está selecionada.

Comentários

A estrutura exibe tarefas na barra de tarefas como ícone e texto. O parâmetro pIcons contém o ícone da tarefa indicada por pTask.

Substitua esse método em uma classe derivada para personalizar a aparência das tarefas na barra de tarefas.

CMFCVisualManager::OnDrawTasksGroupAreaBorder

A estrutura chama esse método quando desenha uma borda ao redor de um grupo em uma Classe CMFCTasksPane.

virtual void OnDrawTasksGroupAreaBorder(
    CDC* pDC,
    CRect rect,
    BOOL bSpecial = FALSE,
    BOOL bNoTitle = FALSE);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites da área de grupo no painel de tarefas.

bSpecial
[in] Um parâmetro booliano que especifica se a borda está realçada. Um valor de TRUE indica que a borda está realçada.

bNoTitle
[in] Um parâmetro booliano que especifica se a área de grupo tem um título. Um valor de TRUE indica que a área de grupo não tem um título.

Comentários

Substitua essa função em uma classe derivada para personalizar a borda em torno de uma área de grupo no painel de tarefas.

CMFCVisualManager::OnDrawTasksGroupCaption

A estrutura chama esse método quando desenha a legenda para um objeto CMFCTasksPaneTaskGroup.

virtual void OnDrawTasksGroupCaption(
    CDC* pDC,
    CMFCTasksPaneTaskGroup* pGroup,
    BOOL bIsHighlighted = FALSE,
    BOOL bIsSelected = FALSE,
    BOOL bCanCollapse = FALSE);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pGroup
[in] Um ponteiro para um objeto CMFCTasksPaneTaskGroup. A estrutura desenha a legenda desse grupo.

bIsHighlighted
[in] Um parâmetro booliano que indica se o grupo está realçado.

bIsSelected
[in] Um parâmetro booliano que indica se o grupo está selecionado no momento.

bCanCollapse
[in] Um parâmetro booliano que indica se o grupo pode ser recolhido.

Comentários

Os grupos de tarefas aparecem no objeto CMFCTasksPane.

Substitua esse método em uma classe derivada para personalizar a legenda de um CMFCTasksPaneTaskGroup.

CMFCVisualManager::OnDrawTasksGroupIcon

virtual void OnDrawTasksGroupIcon(
    CDC* pDC,
    CMFCTasksPaneTaskGroup* pGroup,
    int nIconHOffset = 5,
    BOOL bIsHighlighted = FALSE,
    BOOL bIsSelected = FALSE,
    BOOL bCanCollapse = FALSE);

Parâmetros

[in] pDC
[in] pGroup
[in] nIconHOffset
[in] bIsHighlighted
[in] bIsSelected
[in] bCanCollapse

Comentários

CMFCVisualManager::OnDrawTearOffCaption

A estrutura chama esse método quando desenha a legenda para uma classe CMFCPopupMenu.

virtual void OnDrawTearOffCaption(
    CDC* pDC,
    CRect rect,
    BOOL bIsActive);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites da legenda.

bIsActive
[in] TRUE se a legenda estiver ativa, caso contrário, FALSE.

Comentários

Essa função é chamada pela estrutura quando um objeto CMFCPopupMenu processa uma mensagem WM_PAINT e deve desenhar uma legenda destacável.

Substitua esse método em uma classe derivada para personalizar a aparência das legendas para barras destacáveis.

CMFCVisualManager::OnDrawToolBoxFrame

virtual void OnDrawToolBoxFrame(
    CDC* pDC,
    const CRect& rect);

Parâmetros

[in] pDC
[in] rect

Comentários

CMFCVisualManager::OnEraseMDIClientArea

A estrutura chama esse método quando apaga a área do cliente MDI.

virtual BOOL OnEraseMDIClientArea(
    CDC* pDC,
    CRect rectClient);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectClient
[in] Um retângulo que especifica os limites da área do cliente MDI.

Valor de retorno

Um valor reservado. A implementação padrão retorna FALSE.

Comentários

Substitua esse método para executar o código personalizado quando o gerenciador visual apagar a área do cliente MDI.

CMFCVisualManager::OnErasePopupWindowButton

virtual void OnErasePopupWindowButton(
    CDC* pDC,
    CRect rectClient,
    CMFCDesktopAlertWndButton* pButton);

Parâmetros

[in] pDC
[in] rectClient
[in] pButton

Comentários

CMFCVisualManager::OnEraseTabsArea

A estrutura chama esse método quando apaga a área de guia de uma janela de guia.

virtual void OnEraseTabsArea(
    CDC* pDC,
    CRect rect,
    const CMFCBaseTabCtrl* pTabWnd);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites da área da guia.

pTabWnd
[in] Um ponteiro para uma janela com guias. A estrutura apaga a área de guia da janela com guias especificada.

Comentários

Essa função é chamada pela estrutura quando um objeto da classe CMFCBaseTabCtrl processa uma mensagem WM_PAINT e apaga a área da guia.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência das guias.

CMFCVisualManager::OnEraseTabsButton

A estrutura chama esse método quando apaga o texto e o ícone de um botão da guia.

virtual void OnEraseTabsButton(
    CDC* pDC,
    CRect rect,
    CMFCButton* pButton,
    CMFCBaseTabCtrl* pWndTab);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão da guia.

pButton
[in] Um ponteiro para um botão da guia. A estrutura apaga o texto e o ícone deste botão.

pWndTab
[in] Um ponteiro para o controle guia que contém o botão da guia.

Comentários

A estrutura apaga o texto e o ícone de um botão quando um objeto CMFCBaseTabCtrl processa a mensagem WM_ERASEBKGND.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões da guia.

CMFCVisualManager::OnEraseTabsFrame

A estrutura chama esse método quando apaga um quadro em uma classe CMFCBaseTabCtrl.

virtual BOOL OnEraseTabsFrame(
    CDC* pDC,
    CRect rect,
    const CMFCBaseTabCtrl* pTabWnd);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites da janela com guias.

pTabWnd
[in] Um ponteiro para uma janela com guias. A estrutura apaga um quadro para este CMFCBaseTabCtrl.

Valor de retorno

TRUE se o método for bem-sucedido, caso contrário, será FALSE.

Comentários

Esse método preenche a área indicada pelo rect com a cor da tela de fundo da guia ativa. Ele é chamado quando um objeto CMFCBaseTabCtrl processa uma mensagem WM_PAINT e apaga um quadro da guia.

CMFCVisualManager::OnFillAutoHideButtonBackground

A estrutura chama esse método quando preenche a tela de fundo de um botão de ocultamento automático.

virtual void OnFillAutoHideButtonBackground(
    CDC* pDC,
    CRect rect,
    CMFCAutoHideButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão de ocultamento automático.

pButton
[in] Um ponteiro para um objeto CMFCAutoHideButton. A estrutura preenche a tela de fundo para este botão de ocultamento automático.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um botão de ocultamento automático.

CMFCVisualManager::OnFillBarBackground

A estrutura chama esse método quando preenche a tela de fundo de um objeto CBasePane.

virtual void OnFillBarBackground(
    CDC* pDC,
    CBasePane* pBar,
    CRect rectClient,
    CRect rectClip,
    BOOL bNCArea = FALSE);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo para uma barra de controle.

pBar
[in] Um ponteiro para um objeto CBasePane. A estrutura preenche a tela de fundo desse painel.

rectClient
[in] Um retângulo que especifica os limites do painel.

rectClip
[in] Um retângulo que especifica a área de recorte do painel.

bNCArea
[in] Um valor reservado.

Comentários

A implementação padrão desse método preenche a tela de fundo da barra com a cor da tela de fundo 3d da variável global afxGlobalData. Substitua esse método em um gerenciador visual derivado para personalizar a tela de fundo de um painel.

Exemplo

O exemplo a seguir demonstra como usar o OnFillBarBackground na classe CMFCVisualManager. Este snippet de código faz parte do exemplo de demonstração do Outlook.

// CDC* pDC
// CRect rectClient
// The this pointer points to a CMailBar class which extends the CPaneDialog class.
CMFCVisualManager::GetInstance()->OnFillBarBackground(pDC, this, rectClient, rectClient);

CMFCVisualManager::OnFillButtonInterior

A estrutura chama esse método quando preenche a tela de fundo de um botão de barra de ferramentas.

virtual void OnFillButtonInterior(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo de um botão de barra de ferramentas.

pButton
[in] Um ponteiro para um CMFCToolBarButton. A estrutura preenche a tela de fundo para este botão.

rect
[in] Um retângulo que especifica os limites do botão de barra de ferramentas.

state
[in] O estado do botão da barra de ferramentas.

Comentários

A implementação padrão desse método usa a cor padrão para preencher a tela de fundo. Substitua esse método em um gerenciador visual derivado para personalizar a tela de fundo de um botão de barra de ferramentas.

Os estados possíveis de um botão de barra de ferramentas são ButtonsIsRegular, ButtonsIsPressed ou ButtonsIsHighlighted.

CMFCVisualManager::OnFillCaptionBarButton

virtual COLORREF OnFillCaptionBarButton(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted,
    BOOL bIsDisabled,
    BOOL bHasDropDownArrow,
    BOOL bIsSysButton);

Parâmetros

[in] pDC
[in] pBar
[in] rect
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton

Valor de retorno

Comentários

CMFCVisualManager::OnFillCommandsListBackground

A estrutura chama esse método quando preenche a tela de fundo de um botão de barra de ferramentas que pertence a uma lista de comandos. Essa lista de comandos faz parte da caixa de diálogo de personalização.

virtual COLORREF OnFillCommandsListBackground(
    CDC* pDC,
    CRect rect,
    BOOL bIsSelected = FALSE);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão.

bIsSelected
[in] Um parâmetro booliano que indica se o botão está selecionado.

Valor de retorno

A cor do texto do botão de barra de ferramentas.

Comentários

Para mais informações sobre a lista de personalização, confira CMFCToolBarButton::OnDrawOnCustomizeList. A implementação padrão para esse método preenche a tela de fundo com base no esquema de cores da capa selecionada no momento.

CMFCVisualManager::OnFillHeaderCtrlBackground

A estrutura chama esse método quando preenche a tela de fundo de um controle de cabeçalho.

virtual void OnFillHeaderCtrlBackground(
    CMFCHeaderCtrl* pCtrl,
    CDC* pDC,
    CRect rect);

Parâmetros

pCtrl
[in] Um ponteiro para um objeto CMFCHeaderCtrl. A estrutura preenche a tela de fundo para esse controle de cabeçalho.

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do controle de cabeçalho.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um controle de cabeçalho.

CMFCVisualManager::OnFillMiniFrameCaption

A estrutura chama esse método quando preenche a barra de legenda de uma janela com minimoldura.

virtual COLORREF OnFillMiniFrameCaption(
    CDC* pDC,
    CRect rectCaption,
    CPaneFrameWnd* pFrameWnd,
    BOOL bActive);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectCaption
[in] Um retângulo que especifica os limites da barra de legenda.

pFrameWnd
[in] Um ponteiro para uma janela com minimoldura. A estrutura desenha a barra de legenda para essa janela.

bActive
[in] Um parâmetro booliano que indica se a janela está ativa.

Valor de retorno

A cor que é usada para preencher a tela de fundo da barra de legenda.

Comentários

A implementação padrão para esse método preenche a barra de legendas com a cor da legenda atual para a capa ativa.

CMFCVisualManager::OnFillOutlookBarCaption

A estrutura chama esse método quando preenche a tela de fundo de uma barra de legenda do Outlook.

virtual void OnFillOutlookBarCaption(
    CDC* pDC,
    CRect rectCaption,
    COLORREF& clrText);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectCaption
[in] Um retângulo que especifica os limites da barra de legenda.

clrTexto
[out] Uma referência a um parâmetro COLORREF. O método grava a cor do texto na barra de legendas nesse parâmetro.

Comentários

A implementação padrão desse método preenche a barra de legenda com a cor das sombras com base na capa atual. Substitua esse método em um gerenciador visual derivado para personalizar a cor da barra de legenda do Outlook.

CMFCVisualManager::OnFillOutlookPageButton

A estrutura chama esse método quando preenche o interior de um botão de página do Outlook.

virtual void OnFillOutlookPageButton(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    COLORREF& clrText);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do botão da página do Outlook.

bIsHighlighted
[in] Um parâmetro booliano que especifica se o botão está realçado.

bIsPressed
[in] Um parâmetro booliano que especifica se o botão é pressionado.

clrTexto
[out] Uma referência a um parâmetro COLORREF. Este método armazena a cor do texto do botão de página do Outlook neste parâmetro.

Comentários

Substitua essa função em um gerenciador visual derivado para personalizar a aparência dos botões da página do Outlook.

CMFCVisualManager::OnFillPopupWindowBackground

A estrutura chama esse método quando preenche a tela de fundo de uma janela pop-up.

virtual void OnFillPopupWindowBackground(
    CDC* pDC,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites da janela pop-up.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência das janelas pop-up.

CMFCVisualManager::OnFillRibbonButton

A estrutura chama esse método quando preenche o interior de um botão da faixa de opções.

virtual COLORREF OnFillRibbonButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para um objeto CMFCRibbonButton. A estrutura preenche o interior desse botão da faixa de opções.

Valor de retorno

A cor do texto para o botão da faixa de opções especificado por pButton, se o botão da faixa de opções der suporte para texto. Um valor de -1, se o texto for inválido para o botão da faixa de opções.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões da faixa de opções.

CMFCVisualManager::OnFillRibbonEdit

A estrutura chama esse método quando preenche o interior de uma instância da classe CMFCRibbonRichEditCtrl.

virtual void OnFillRibbonEdit(
    CDC* pDC,
    CMFCRibbonRichEditCtrl* pEdit,
    CRect rect,
    BOOL bIsHighlighted,
    BOOL bIsPaneHighlighted,
    BOOL bIsDisabled,
    COLORREF& clrText,
    COLORREF& clrSelBackground,
    COLORREF& clrSelText);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pEdit
[in] Um ponteiro para um objeto CMFCRibbonRichEditCtrl. A estrutura preenche o interior desse controle de edição.

rect
[in] Um retângulo que especifica os limites do controle de edição.

bIsHighlighted
[in] Um parâmetro booliano que indica se o controle de edição está realçado.

bIsPaneHighlighted
[in] Um parâmetro booliano que indica se o painel pai está realçado.

bIsDisabled
[in] Um parâmetro booliano que indica se o controle de edição não está disponível.

clrTexto
[in] Uma referência à cor do texto do controle de edição.

clrSelBackground
[in] Uma referência à cor da tela de fundo do controle de edição quando é realçado.

clrSelText
[in] Uma referência à cor do texto selecionado no controle de edição.

Comentários

O CMFCRibbonRichEditCtrl indicado por pEdit pode fazer parte de um botão de caixa de combinação na faixa de opções.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um arquivo CMFCRibbonRichEditCtrl.

CMFCVisualManager::OnFillRibbonMainPanelButton

A estrutura chama esse método quando preenche o interior de um botão da faixa de opções localizado no painel Principal.

virtual COLORREF OnFillRibbonMainPanelButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pButton
[in] Um ponteiro para um objeto classe CMFCRibbonButton. A estrutura preenche esse botão da faixa de opções.

Valor de retorno

A cor do texto para o botão da faixa de opções especificado por pButton, se o botão da faixa de opções der suporte para texto. Um valor de -1, se o texto for inválido para o botão da faixa de opções.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões da faixa de opções no painel Principal.

CMFCVisualManager::OnFillRibbonMenuFrame

A estrutura chama esse método quando preenche o quadro de menu do painel da faixa de opções.

virtual void OnFillRibbonMenuFrame(
    CDC* pDC,
    CMFCRibbonMainPanel* pPanel,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pPanel
[in] Um ponteiro para uma instância da classe CMFCRibbonMainPanel. A estrutura preenche o quadro de menu para esse painel da faixa de opções.

rect
[in] Um retângulo que especifica os limites do quadro de menu.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência da barra de menus do CMFCRibbonMainPanel.

CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup

virtual void OnFillRibbonQuickAccessToolBarPopup(
    CDC* pDC,
    CMFCRibbonPanelMenuBar* pMenuBar,
    CRect rect);

Parâmetros

[in] pDC
[in] pMenuBar
[in] rect

Comentários

CMFCVisualManager::OnFillSplitterBackground

A estrutura chama esse método quando preenche a tela de fundo de uma janela divisora.

virtual void OnFillSplitterBackground(
    CDC* pDC,
    CSplitterWndEx* pSplitterWnd,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pSplitterWnd
[in] Um ponteiro para uma instância da classe CSplitterWndEx. A estrutura preenche a tela de fundo para esta janela divisora.

rect
[in] Um retângulo que especifica os limites da janela divisora.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de uma janela divisora.

CMFCVisualManager::OnFillTab

A estrutura chama esse método quando preenche a tela de fundo de uma janela de guia.

virtual void OnFillTab(
    CDC* pDC,
    CRect rectFill,
    CBrush* pbrFill,
    int iTab,
    BOOL bIsActive,
    const CMFCBaseTabCtrl* pTabWnd);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectFill
[in] Um retângulo que especifica os limites da janela com guias.

pbrFill
[in] Um ponteiro para um pincel. A estrutura usa esse pincel para preencher a janela da guia.

iTab
[in] O índice de guia baseado em zero de uma guia para a qual a estrutura preenche a tela de fundo.

bIsActive
[in] TRUE se a guia estiver ativa, caso contrário, será FALSE.

pTabWnd
[in] Um ponteiro para o controle guia pai.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência das guias.

CMFCVisualManager::OnFillTasksGroupInterior

A estrutura chama esse método quando preenche o interior de um objeto CMFCTasksPaneTaskGroup.

virtual void OnFillTasksGroupInterior(
    CDC* pDC,
    CRect rect,
    BOOL bSpecial = FALSE);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica os limites do grupo de tarefas.

bSpecial
[in] Um booliano que indica se o interior está preenchido com uma cor especial.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um grupo de tarefas.

CMFCVisualManager::OnFillTasksPaneBackground

A estrutura chama esse método quando preenche a tela de fundo de um controle CMFCTasksPane.

virtual void OnFillTasksPaneBackground(
    CDC* pDC,
    CRect rectWorkArea);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectWorkArea
[in] Um retângulo que especifica os limites do painel de tarefas.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um objeto CMFCTasksPane.

CMFCVisualManager::OnHighlightMenuItem

A estrutura chama esse método quando desenha um item de menu realçado.

virtual void OnHighlightMenuItem(
    CDC* pDC,
    CMFCToolBarMenuButton* pButton,
    CRect rect,
    COLORREF& clrText);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo para um menu.

pButton
[in] Um ponteiro para um objeto CMFCToolBarMenuButton a ser exibido. A implementação padrão não usa esse parâmetro.

rect
[in] Um retângulo que especifica os limites do item de menu.

clrTexto
[in] A cor do texto atual dos itens de menu realçados. A implementação padrão não usa esse parâmetro.

Comentários

A implementação padrão desse método não usa os parâmetros pButton ou clrText. O retângulo especificado é preenchido por rect com a cor da tela de fundo padrão.

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos itens de menu realçados. Use o parâmetro clrText para modificar a cor do texto de um item de menu realçado.

CMFCVisualManager::OnHighlightRarelyUsedMenuItems

A estrutura chama esse método quando desenha um comando de menu realçado.

virtual void OnHighlightRarelyUsedMenuItems(
    CDC* pDC,
    CRect rectRarelyUsed);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectRarelyUsed
[in] Um retângulo que especifica os limites do comando realçado.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos comandos de menu realçados.

CMFCVisualManager::OnNcActivate

virtual BOOL OnNcActivate(
    CWnd* pWnd,
    BOOL bActive);

Parâmetros

[in] pWnd
[in] bActive

Valor de retorno

Comentários

CMFCVisualManager::OnNcPaint

A estrutura chama esse método quando desenha a área de não cliente.

virtual BOOL OnNcPaint(
    CWnd* pWnd,
    const CObList& lstSysButtons,
    CRect rectRedraw);

Parâmetros

pWnd
[in] Um ponteiro para a janela cuja área de não cliente a estrutura desenha.

lstSysButtons
[in] Uma lista de botões do sistema. Também são conhecidos como botões de título.

rectRedraw
[in] Um retângulo que especifica os limites da área de não cliente.

Valor de retorno

Um valor reservado. A implementação padrão retorna FALSE.

Comentários

Substitua esse método em um gerenciador visual derivado para personalizar a aparência do quadro da janela e botões de título.

CMFCVisualManager::OnSetWindowRegion

A estrutura chama esse método depois de definir uma região que contém quadros e menus pop-up.

virtual BOOL OnSetWindowRegion(
    CWnd* pWnd,
    CSize sizeWindow);

Parâmetros

pWnd
[in] Um ponteiro para a janela com a região que foi alterada.

sizeWindow
[in] O tamanho da janela.

Valor de retorno

TRUE se o método for bem-sucedido, caso contrário, será FALSE.

Comentários

A estrutura chama esse método para notificar o gerenciador visual de que uma região foi definida para quadros e menus pop-up. Para obter mais informações, consulte CWindow::SetWindowRgn.

CMFCVisualManager::OnUpdateSystemColors

A estrutura chama essa função quando altera as cores do sistema.

virtual void OnUpdateSystemColors();

Comentários

A estrutura chama esse método como parte do processamento da mensagem de WM_SYSCOLORCHANGE. A implementação padrão não tem ação. Substitua esse método em um gerenciador visual derivado se você quiser executar um código personalizado quando as cores mudarem em seu aplicativo.

CMFCVisualManager::RedrawAll

Redesenha imediatamente todas as barras de controle no aplicativo.

static void RedrawAll();

CMFCVisualManager::RibbonCategoryColorToRGB

virtual COLORREF RibbonCategoryColorToRGB(AFX_RibbonCategoryColor color);

Parâmetros

[in] color

Valor de retorno

Comentários

CMFCVisualManager::SetDefaultManager

Define o gerenciador padrão.

static void SetDefaultManager(CRuntimeClass* pRTI);

Parâmetros

pRTI
[in] Um ponteiro para as informações de tempo de execução de um gerenciador visual.

Comentários

Use a classe CMFCVisualManager e os gerenciadores visuais derivados para personalizar a aparência do aplicativo. Após definir o gerenciador visual padrão, esse método redesenhará o aplicativo usando o novo gerenciador visual. Para obter mais informações sobre como usar os gerenciadores visuais, consulte Gerenciador de Visualização.

Use esse método para alterar o gerenciador visual que o aplicativo usa.

CMFCVisualManager::SetEmbossDisabledImage

Habilita ou desabilita o modo colocado em alto-relevo para imagens da barra de ferramentas desabilitadas.

void SetEmbossDisabledImage (BOOL bEmboss = TRUE);

Parâmetros

bEmboss
[in] Um parâmetro booliano que indica se deve habilitar o modo em relevo para imagens de barra de ferramentas desabilitadas.

Comentários

Use a função CMFCVisualManager::IsEmbossDisabledImage para determinar se o modo colocado em alto-relevo está ativado.

CMFCVisualManager::SetFadeInactiveImage

Habilita ou desabilita o efeito de iluminação para imagens inativas em um menu ou uma barra de ferramentas.

void SetFadeInactiveImage(BOOL bFade = TRUE);

Parâmetros

bFade
[in] Um parâmetro booliano que especifica se o efeito de iluminação deve ser habilitado.

Comentários

Esse recurso controla se as imagens inativas aparecem esmaecidas em um menu ou em uma barra de ferramentas. Use o método CMFCVisualManager::IsFadeInactiveImage para determinar se esse recurso está habilitado.

CMFCVisualManager::SetMenuFlatLook

Define um sinalizador que indica se os botões do menu parecem planos. Caso contrário, aparecem tridimensionais.

void SetMenuFlatLook(BOOL bMenuFlatLook = TRUE);

Parâmetros

bMenuFlatLook
[in] Um parâmetro booliano que indica se os botões de menu aparecem planos.

Comentários

Por padrão, esse recurso não está habilitado.

CMFCVisualManager::SetMenuShadowDepth

Define a largura e a altura da sombra do menu.

void SetMenuShadowDepth(int nDepth);

Parâmetros

nDepth
[in] Um inteiro que especifica a profundidade da sombra do menu em pixels.

Comentários

A altura e a largura da sombra do menu devem ser idênticas. O valor padrão é 7 pixels.

CMFCVisualManager::SetShadowHighlightedImage

Define um sinalizador que indica se o CMFCVisualManager exibe sombras para imagens realçadas.

void SetShadowHighlightedImage(BOOL bShadow = TRUE);

Parâmetros

bShadow
[in] Um parâmetro booliano que indica se o gerenciador visual exibe uma sombra nas imagens realçadas.

Comentários

Por padrão, esse recurso está desativado.

Confira também

Gráfico da hierarquia
Classes
CMFCVisualManager::GetInstance
Gerenciador de visualização