CMFCVisualClasse Manager

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Oferece suporte para alterar a aparência da sua aplicação a nível global. A CMFCVisualManager classe trabalha em conjunto com uma classe que fornece instruções para desenhar os controlos da interface gráfica da sua aplicação usando um estilo consistente. Estas outras classes são designadas por gestores visuais e herdam de CMFCBaseVisualManager.

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCVisualManager : public CMFCBaseVisualManager

Membros

Construtores Públicos

Nome	Description
`CMFCVisualManager::CMFCVisualManager`	Construtor padrão.

Métodos Públicos

Nome	Description
CMFCVisualManager::AdjustFrames
CMFCVisualManager::AdjustToolbars
CMFCVisualManager::AlwaysHighlight3DTabs	Chamado pelo framework para determinar se os separadores 3D devem sempre ser desenhados usando uma cor de destaque.
CMFCVisualManager::D estroyInstance
CMFCVisualManager::D oDrawHeaderSortArrow
CMFCVisualManager::D rawComboDropButtonWinXP
CMFCVisualManager::D rawPushButtonWinXP
CMFCVisualManager::D rawTextOnGlass
CMFCVisualManager::GetAutoHideButtonTextColor	Chamado pelo framework para recuperar a cor do texto para um botão de ocultação automática.
CMFCVisualManager::GetButtonExtraBorder	Chamado pelo framework para recuperar o tamanho de botão aumentado que o gestor visual atual precisa para desenhar um botão.
CMFCVisualManager::GetCaptionBarTextColor	Chamado pelo framework para recuperar a cor do texto de uma barra de legendas.
CMFCVisualManager::GetDockingTabsBordersSize	Chamado pela estrutura para recuperar o tamanho para a borda de uma barra com separação acoplada.
CMFCVisualManager::GetHighedMenuItemTextColor
CMFCVisualManager::GetInstance	Devolve um ponteiro para o `CMFCVisualManager` objeto.
CMFCVisualManager::GetMDITabsBordersSize	Chamado pelo framework para recuperar o tamanho da borda da janela MDITabs.
CMFCVisualManager::GetMenuItemTextColor
CMFCVisualManager::GetMenuShadowDepth	Devolve um valor que determina a largura e a altura de uma sombra de menu.
CMFCVisualManager::GetNcBtnSize	É chamado pelo framework para determinar o tamanho dos botões do sistema com base no gestor visual atual. Os botões do sistema são os botões na legenda do quadro principal que correspondem aos comandos Fechar, Minimizar, Maximizar e Restaurar.
CMFCVisualManager::GetPopupMenuBorderSize	É chamado pelo framework para recuperar o tamanho da borda para um menu pop-up.
CMFCVisualManager::GetPropertyGridGroupColor	Chamado pelo framework para recuperar a cor de fundo de uma lista de propriedades.
CMFCVisualManager::GetPropertyGridGroupTextColor	Chamado pelo framework para recuperar a cor do texto de uma lista de propriedades.
CMFCVisualManager::GetRibbonHyperlinkTextColor
CMFCVisualManager::GetRibbonPopupBorderSize
CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor
CMFCVisualManager::GetRibbonSliderColors
CMFCVisualManager::GetShowAllMenuItemsHeight
CMFCVisualManager::GetSmartDockingBaseGuideColors
CMFCVisualManager::GetSmartDockingHighlightTonColorColor
CMFCVisualManager::GetSmartDockingTheme	Devolve um tema usado para mostrar marcadores de acoplamento inteligentes.
CMFCVisualManager::GetStatusBarPaneTextColor
CMFCVisualManager::GetTabFrameColors	Chamado pela framework para recuperar o conjunto de cores a usar quando desenha um frame de tabulação.
CMFCVisualManager::GetTabTextColor
CMFCVisualManager::GetToolbarButtonTextColor	Chamado pela framework para recuperar a cor atual do texto no botão da barra de ferramentas. Esta cor varia consoante o gestor visual atual e o estado dos botões.
CMFCVisualManager::GetToolbarDisabledTextColor	Chamado pelo framework para determinar a cor do texto que é exibido nos elementos desativados da barra de ferramentas.
CMFCVisualManager::GetToolbarHighlightColor
CMFCVisualManager::GetToolTipInfo
CMFCVisualManager::HasOverlappedAutoHideButtons	Especifica se os botões de ocultação automática se sobrepõem.
CMFCVisualManager::IsDockingTabHasBorder	Especifica se o gestor visual atual desenha uma borda em torno das barras de atracação com separadores.
CMFCVisualManager::IsEmbossDisabledImage	Especifica se as imagens desativadas devem ser em relevo.
CMFCVisualManager::IsFadeInactiveImage	É chamado pelo framework para determinar se imagens inativas numa barra de ferramentas ou menu aparecem apagadas.
CMFCVisualManager::IsMenuFlatLook	Especifica se os botões do menu têm uma aparência achatada.
CMFCVisualManager::IsOfficeXPStyleMenus	Especifica se o gestor visual implementa menus ao estilo Office XP.
CMFCVisualManager::IsOwnerDrawCaption	Especifica se o gestor visual atual implementa legendas desenhadas pelo proprietário de uma janela de frame.
CMFCVisualGerente::ÉSombraImageDestacadaT	Especifica se uma imagem destacada tem sombra.
CMFCVisualManager::OnDrawAutoHideButtonBorder	É chamado pelo framework quando desenha a borda para um botão de ocultação automática.
CMFCVisualManager::OnDrawBarGripper	Chamado pela estrutura quando puxa a garra de uma barra de controlo. O utilizador deve clicar no gripper para mover a barra de controlo.
CMFCVisualManager::OnDrawBrowseButton	É chamada pelo framework quando desenha um botão de navegação que pertence a um controlo de edição ( CMFCEditBrowseCtrl Class).
CMFCVisualManager::OnDrawButtonBorder	É chamado pela estrutura quando desenha a borda de um botão da barra de ferramentas.
CMFCVisualManager::OnDrawButtonSeparator
CMFCVisualManager::OnDrawCaptionBarBorder	É chamado pelo framework quando desenha a borda da barra de legendas.
CMFCVisualManager::OnDrawCaptionBarButtonBorder
CMFCVisualManager::OnDrawCaptionBarInfoArea
CMFCVisualManager::OnDrawCaptionButton	É chamado pelo framework quando desenha um botão de legenda.
CMFCVisualManager::OnDrawCheckBox
CMFCVisualManager::OnDrawCheckCheckEx
CMFCVisualManager::OnDrawComboBorder	É chamado pela estrutura quando desenha a borda de um botão de combo.
CMFCVisualManager::OnDrawComboDropButton	É chamado pelo framework quando desenha um botão de encaixe de caixa.
CMFCVisualManager::OnDrawControlBorder
CMFCVisualManager::OnDrawDefaultRibbonImage	É chamada pelo framework quando desenha a imagem de fita padrão.
CMFCVisualManager::OnDrawEditBorder	Chamado pelo framework quando desenha uma borda em torno de um objeto CMFCToolBarEditBoxButton .
CMFCVisualManager::OnDrawExpandingBox
CMFCVisualManager::OnDrawFloatingToolbarBorderBorder	Chamada 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 de mini-frame.
CMFCVisualManager::OnDrawHeaderCtrlBorder	Chamado pelo framework quando desenha a borda que contém o controlo do cabeçalho.
CMFCVisualManager::OnDrawHeaderCtrlSortArrow	Chamado pelo framework quando desenha a seta de ordenação de controlo do cabeçalho.
CMFCVisualManager::OnDrawMenuArrowOnCustomizeList
CMFCVisualManager::OnDrawMenuBorder	É chamado pelo framework quando desenha uma borda de menu.
CMFCVisualManager::OnDrawMenuCheck
CMFCVisualManager::OnDrawMenuItemButton
CMFCVisualManager::OnDrawMenuLabel
CMFCVisualManager::OnDrawMenuResizeBarBar
CMFCVisualManager::OnDrawMenuScrollButton	É chamado pelo framework quando desenha um botão de scroll no menu.
CMFCVisualManager::OnDrawMenuShadow
CMFCVisualManager::OnDrawMenuSystemButton	É chamado pelo framework quando desenha os botões do sistema de menus Fechar, Minimizar, Maximizar e Restaurar.
CMFCVisualManager::OnDrawMiniFrameBorder
CMFCVisualManager::OnDrawOutlookBarSplitter	É chamado pelo framework quando desenha o divisor para uma barra do Outlook. O divisor é uma barra horizontal usada para agrupar os controlos.
CMFCVisualManager::OnDrawOutlookPageButtonBorder	É chamado pelo framework quando desenha a borda de um botão de página do Outlook. Os botões da página do Outlook aparecem se o painel de barras do Outlook tiver mais botões do que consegue mostrar.
CMFCVisualManager::OnDrawPaneBorder	Chamada pelo framework quando desenha a fronteira de uma Classe CPane.
CMFCVisualManager::OnDrawPaneCaption	Chamado pelo framework quando desenha a legenda para um `CPane`.
CMFCVisualManager::OnDrawPaneDivider
CMFCVisualManager::OnDrawPopupWindowBorder
CMFCVisualManager::OnDrawPopupWindowButtonBorder
CMFCVisualManager::OnDrawPopupWindowCaption
CMFCVisualManager::OnDrawRibbonApplicationButton	É chamado pela estrutura quando desenha o Botão Principal na fita.
CMFCVisualManager::OnDrawRibbonButtonBorder	Chamado pela estrutura quando desenha a borda de um botão de fita.
CMFCVisualManager::OnDrawRibbonButtonsGroup	Chamada pela estrutura quando desenha um grupo de botões na fita.
CMFCVisualManager::OnDrawRibbonCaption	Chamada pela estrutura quando desenha a legenda do quadro principal, mas só se a barra de fita estiver integrada com a estrutura.
CMFCVisualManager::OnDrawRibbonCaptionButton	Chamada pela estrutura quando desenha um botão de legenda localizado na barra de fita.
CMFCVisualManager::OnDrawRibbonCategory	Chamada pelo framework quando desenha uma categoria de fita.
CMFCVisualManager::OnDrawRibbonCategoriaLegenda	Chamado pela estrutura quando desenha a legenda para uma categoria fita.
CMFCVisualManager::OnDrawRibbonCategoryScroll
CMFCVisualManager::OnDrawRibbonCategoryTab	Chamada pelo framework quando desenha o separador para uma categoria de fita.
CMFCVisualManager::OnDrawRibbonCheckCheckBoxOnList
CMFCVisualManager::OnDrawRibbonColorPaletteBox
CMFCVisualManager::OnDrawRibbonDefaultPaneButtonContext
CMFCVisualManager::OnDrawRibbonDefaultPaneButton	É chamado pelo framework quando desenha o botão padrão do painel de fita. O botão predefinido aparece quando o utilizador reduz um painel de fita para que fique demasiado pequeno para exibir os elementos da fita. O botão padrão é desenhado em vez disso e os elementos da fita são adicionados como itens num menu suspenso.
CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator
CMFCVisualGerente::OnDrawRibbonGalleryBorder
CMFCVisualGerente::OnDrawRibbonGalleryButton
CMFCVisualManager::OnDrawRibbonKeyTip
CMFCVisualManager::OnDrawRibbonLabel	Chamado pela estrutura quando desenha a etiqueta da fita.
CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder	Chamada pela estrutura quando desenha a borda de um botão de fita que está posicionado no painel principal . O painel Principal é o painel que aparece quando o utilizador clica no Botão Principal.
CMFCVisualManager::OnDrawRibbonMainPanelFrame	É chamado pela estrutura quando desenha a estrutura à volta do painel principal .
CMFCVisualManager::OnDrawRibbonMenuCheckFrame
CMFCVisualManager::OnDrawRibbonPanel	Chamado pela estrutura quando desenha um painel de fita.
CMFCVisualManager::OnDrawRibbonPanelLegenda	Chamado pela estrutura quando desenha a legenda de um painel de fita.
CMFCVisualManager::OnDrawRibbonProgressBar	Chamado pela framework quando desenha um objeto CMFCRibbonProgressBar .
CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator	Chamado pelo framework quando desenha um separador na Barra de Ferramentas de Acesso Rápido de uma fita.
CMFCVisualManager::OnDrawRibbonRecentFilesFrame	É chamado pelo framework quando desenha um frame à volta de uma lista de ficheiros recentes.
CMFCVisualManager::OnDrawRibbonSliderChannel	Chamado pela framework quando desenha o canal de um objeto CMFCRibbonSlider .
CMFCVisualManager::OnDrawRibbonSliderThumb	Chamado pela estrutura quando desenha o polegar de um `CMFCRibbonSlider` objeto.
CMFCVisualManager::OnDrawRibbonSliderZoomButton	Chamada pela framework quando desenha os botões de zoom de um `CMFCRibbonSlider` objeto.
CMFCVisualManager::OnDrawRibbonStatusBarPane	Chamado pela estrutura quando desenha o painel de barra de estado de uma fita.
CMFCVisualManager::OnDrawRibbonTabsFrame	Chamada pela estrutura quando desenha uma moldura em torno de um conjunto de separadores de fita.
CMFCVisualManager::OnDrawScrollButtons
CMFCVisualManager::OnDrawSeparator	Chamado pelo framework quando desenha um separador. O separador é normalmente usado numa barra de controlo para separar grupos de ícones.
CMFCVisualManager::OnDrawShowAllMenuItems
CMFCVisualManager::OnDrawSpinButtons	É chamado pelo sistema quando desenha botões de giro.
CMFCVisualManager::OnDrawSplitterBorder	Chamado pelo framework quando desenha a borda de uma janela dividida.
CMFCVisualManager::OnDrawSplitterBox	É chamado pelo framework quando desenha a caixa de arrasto do divisor para uma janela dividida.
CMFCVisualManager::OnDrawStatusBarPaneBorder	Chamado pelo framework quando desenha a fronteira para um painel de barra de estado.
CMFCVisualManager::OnDrawStatusBarProgress	Chamado pelo quadro quando desenha o indicador de progresso da barra de estado.
CMFCVisualManager::OnDrawStatusBarSizeBox	Chamada pelo framework quando desenha a caixa de tamanho da barra de estado.
CMFCVisualManager::OnDrawTab	Chamado pelo framework quando desenha um objeto CMFCTabCtrl .
CMFCVisualManager::OnDrawTabFechaBotão	É chamado pelo framework quando desenha o botão Fechar no separador ativo.
CMFCVisualManager::OnDrawTabContent	É chamado pela framework quando desenha o interior do separador (imagens, textos).
CMFCVisualManager::OnDrawTabsButtonBorder	Chamado pelo framework quando desenha a borda de um botão de tabulação.
CMFCVisualManager::OnDrawTask	É chamado pelo framework quando desenha uma tarefa no painel de tarefas.
CMFCVisualManager::OnDrawTasksGroupAreaFrontier	É chamado pelo framework quando desenha uma fronteira à volta de uma área de grupo no painel de tarefas.
CMFCVisualManager::OnDrawTasksGroupCaption	É chamado pelo framework quando desenha a legenda de um grupo de tarefas no painel de tarefas.
CMFCVisualManager::OnDrawTasksGroupIcon
CMFCVisualManager::OnDrawTearOffCaption	Chamado pela estrutura quando desenha a legenda de remoção para uma barra de remoção.
CMFCVisualManager::OnDrawToolBoxFrame
CMFCVisualManager::OnEraseMDIClientArea	É chamado pelo framework quando este apaga a área do cliente MDI.
CMFCVisualManager::OnErasePopupWindowButton
CMFCVisualManager::OnEraseTabsArea	É chamado pelo framework quando apaga a área de separadores numa janela de separadores.
CMFCVisualManager::OnEraseTabsButton	É chamado pelo framework quando apaga o ícone e o texto de um botão de tabulação.
CMFCVisualManager::OnEraseTabsFrame	É chamado pelo framework quando apaga um frame de tabulação.
CMFCVisualManager::OnFillAutoHideButtonBackground	É chamado pelo framework quando preenche o fundo de um botão de ocultação automática.
CMFCVisualManager::OnFillBarContexto	Chamado pelo framework quando preenche o fundo de uma barra de controlo.
CMFCVisualManager::OnFillButtonInterior	É chamado pela framework quando esta preenche o fundo de um botão da barra de ferramentas.
CMFCVisualManager::OnFillCaptionBarButton
CMFCVisualManager::OnFillCommandsListBackground	É chamada pela framework quando esta preenche o 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 pelo framework quando este preenche o fundo de um controlo de cabeçalho.
CMFCVisualManager::OnFillMiniFrameCaption	É chamado pelo framework quando preenche a legenda de uma mini janela de frame.
CMFCVisualManager::OnFillOutlookBarCaption	É chamado pelo framework quando preenche o fundo de uma legenda da barra do Outlook.
CMFCVisualManager::OnFillOutlookPageButtonT	É chamado pelo framework quando este preenche o interior de um botão da página Outlook.
CMFCVisualManager::OnFillPopupWindowBackground	É chamado pelo framework quando preenche o fundo de uma janela pop-up.
CMFCVisualManager::OnFillRibbonButton	É chamado pela estrutura quando preenche o interior de um botão de fita.
CMFCVisualManager::OnFillRibbonEdit	Chamado pela framework quando preenche o interior de um controlo de edição em fita.
CMFCVisualManager::OnFillRibbonPanelMainPanelButton	É chamado pela estrutura quando esta preenche o interior de um botão de fita localizado no painel principal .
CMFCVisualGerente::OnFillRibbonMenuFrame	É chamada pela estrutura quando esta preenche o quadro do menu do painel principal de fita.
CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup
CMFCVisualGerente::OnFillSplitterAntecedentes	Chamada pela framework quando esta preenche o fundo de uma janela dividida.
CMFCVisualManager::OnFillTab	Chamado pela framework quando preenche o fundo de um separador.
CMFCVisualManager::OnFillTasksGroupInterior	Chamado pelo framework quando este preenche o interior de um objeto CMFCTasksPaneTaskGroup no CMFCTasksPane.
CMFCVisualManager::OnFillTasksPaneBackground	Chamada pela framework quando esta preenche o fundo de um `CMFCTasksPane` controlo.
CMFCVisualManager::OnHighlightMenuItem	É chamado pelo framework quando desenha um item destacado no menu.
CMFCVisualGerente::EmDestaqueRaramenteUsadoMenuItens	É chamado pelo framework quando desenha um item de menu destacado e raramente usado.
CMFCVisualManager::OnNcPaint	Chamado pelo framework quando desenha a área não-cliente.
CMFCVisualManager::OnSetWindowRegion	É chamado pelo framework quando define uma região que contém frames e menus pop-up.
CMFCVisualManager::OnUpdateSystemSystemColors	É chamado pelo framework quando muda a definição de cor do sistema.
CMFCVisualManager::RedrawAll	Redesenha todas as barras de controlo da aplicação.
CMFCVisualManager::RibbonCategoryColorToRGB
CMFCVisualManager::SetDefaultManager	Define o gestor visual padrão.
CMFCVisualManager::SetEmbossDisabledImage	Ativa ou desativa o modo em relevo para imagens desativadas da barra de ferramentas.
CMFCVisualManager::SetFadeInactiveImage	Ativa ou desativa o efeito de iluminação para imagens inativas num menu ou barra de ferramentas.
CMFCVisualManager::SetMenuFlatLook	Define uma bandeira a indicar se os botões do menu de aplicação têm uma aparência achatada.
CMFCVisualManager::SetMenuShadowDepth	Define a largura e a altura da sombra do menu.
CMFCVisualManager::SetShadowImageReallightedT	Define uma bandeira que indica se deve mostrar a sombra ao renderizar imagens destacadas.

Observações

Como a CMFCVisualManager classe controla a interface gráfica da aplicação, cada aplicação pode ter uma instância de CMFCVisualManagerum , ou uma instância de uma classe derivada de CMFCVisualManager. A sua aplicação também pode funcionar sem um CMFCVisualManager. Use o método GetInstance estático para obter um ponteiro para o objeto derivado da corrente CMFCVisualManagerem .

Para alterar a aparência da sua aplicação, deve usar outras classes que forneçam métodos para desenhar todos os elementos visuais da sua aplicação. Alguns exemplos destas classes são CMFCVisualManagerOfficeXP Class, CMFCVisualManagerOffice2003 Class e CMFCVisualManagerOffice2007 Class. Quando quiser alterar a aparência da sua aplicação, passe um destes gestores visuais para o método SetDefaultManager. Para um exemplo que demonstre como a sua aplicação pode imitar a aparência do Microsoft Office 2003, veja CMFCVisualManagerOffice2003 Class.

Todos os métodos de desenho são virtuais. Isto permite-lhe criar um estilo visual personalizado para a interface gráfica da sua aplicação. Se quiseres criar o teu próprio estilo visual, deriva uma classe de uma das classes do gestor visual e sobrepõe os métodos de desenho que queres alterar.

Exemplos

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

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 seguinte demonstra como recuperar os valores padrão de um CMFCVisualManager objeto. Este excerto 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

Requerimentos

Cabeçalho: afxvisualmanager.h

CMFCVisualManager::AdjustFrames

static void __stdcall AdjustFrames();

Observações

CMFCVisualManager::AdjustToolbars

static void __stdcall AdjustToolbars();

Observações

CMFCVisualManager::AlwaysHighlight3DTabs

O framework chama este método para determinar se os separadores 3D devem estar sempre destacados na aplicação.

virtual BOOL AlwaysHighlight3DTabs() const;

Valor de retorno

TRUE se os separadores 3D deviam ser destacados.

Observações

Sobrescrita esta função num gestor visual derivado e devolve TRUE se os separadores 3D estiverem sempre destacados. A implementação padrão deste método devolve FALSE.

CMFCVisualManager::CMFCVisualManager

CMFCVisualManager(BOOL bTemporary = FALSE);

Parâmetros

[dentro] bTemporário

Observações

CMFCVisualManager::D estroyInstance

static void __stdcall DestroyInstance(BOOL bAutoDestroyOnly = FALSE);

Parâmetros

[dentro] bAutoDestroyOnly

Observações

CMFCVisualManager::D oDrawHeaderSortArrow

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

Parâmetros

[dentro] pDC
[dentro] Rect
[dentro] bIsUp
[dentro] bDlgCtrl

Observações

CMFCVisualManager::D rawComboBorderWinXP

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

Parâmetros

[dentro] CDC*
[dentro] CRect
[dentro] BOOL

Valor de retorno

Observações

CMFCVisualManager::D rawComboDropButtonWinXP

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

Parâmetros

[dentro] CDC*
[dentro] CRect
[dentro] BOOL

Valor de retorno

Observações

CMFCVisualManager::D rawPushButtonWinXP

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

Parâmetros

[dentro] CDC*
[dentro] CRect
[dentro] CMFCButton*
[dentro] UINT

Valor de retorno

Observações

CMFCVisualManager::D rawTextOnGlass

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

Parâmetros

[dentro] pDC
[dentro] strText
[dentro] Rect
[dentro] dwFlags
[dentro] nGlowSize
[dentro] clrText

Valor de retorno

Observações

CMFCVisualManager::EnableToolbarButtonFill

void EnableToolbarButtonFill(BOOL bEnable = TRUE);

Parâmetros

[dentro] bEnable

Observações

CMFCVisualManager::GetAutoHideButtonTextColor

O framework chama este método para recuperar a cor do texto de um botão de ocultação automática.

virtual COLORREF GetAutoHideButtonTextColor(CMFCAutoHideButton* pButton);

Parâmetros

pButton
[dentro] Um apontador para um botão de ocultação automática.

Valor de retorno

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

Observações

Substitua este método numa classe derivada para personalizar a cor do texto de um botão de ocultação automática na sua aplicação. Para isso, devolve a cor que queres que a tua aplicação use como cor do texto.

CMFCVisualManager::GetButtonExtraBorder

O framework chama este 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 extra da borda para botões da barra de ferramentas.

Observações

Algumas skins têm de estender as bordas dos botões da barra de ferramentas. Substitua este método num gestor visual personalizado para estender as bordas dos botões da barra de ferramentas na sua aplicação. A implementação padrão deste método devolve um tamanho vazio.

CMFCVisualManager::GetCaptionBarTextColor

O framework chama este método para recuperar a cor do texto na barra de legendas.

virtual COLORREF GetCaptionBarTextColor(CMFCCaptionBar* pBar);

Parâmetros

pBar
[dentro] Um indicador para uma barra de legendas.

Valor de retorno

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

Observações

Substitua este método na tua classe derivada para personalizar a cor do texto para uma barra de legendas. No método sobreposto, devolve a cor desejada.

CMFCVisualManager::GetCaptionButtonExtraBorder

virtual CSize GetCaptionButtonExtraBorder() const;

Valor de retorno

Observações

CMFCVisualManager::GetDockingPaneCaptionExtraHeight

virtual int GetDockingPaneCaptionExtraHeight() const;

Valor de retorno

Observações

CMFCVisualManager::GetDockingTabsBordersSize

O framework chama este método quando desenha um painel que está acoplado e separado.

virtual int GetDockingTabsBordersSize();

Valor de retorno

Um inteiro que indica o tamanho da borda de um painel que está acoplado e separado.

Observações

Um painel acoplado passa a ser separado quando o utilizador acopla vários painéis ao mesmo local na sua aplicação.

Substitua este método num gestor visual personalizado para alterar o tamanho da borda das barras de controlo com separações acopladas. A implementação padrão devolve -1.

CMFCVisualManager::GetHighedMenuItemTextColor

virtual COLORREF GetHighlightedMenuItemTextColor(CMFCToolBarMenuButton* pButton);

Parâmetros

[dentro] pButton

Valor de retorno

Observações

CMFCVisualManager::GetInstance

Devolve um ponteiro para o objeto atual da Classe CMFCVisualManager para a aplicação.

static CMFCVisualManager* GetInstance();

Valor de retorno

Um ponteiro para um CMFCVisualManager objeto.

Observações

Uma aplicação só pode ter um CMFCVisualManager objeto associado. Isto inclui qualquer objeto derivado da CMFCVisualManager classe. Este método devolve um ponteiro para o objeto associado CMFCVisualManager . Se a aplicação não tiver um objeto associado CMFCVisualManager , este método irá criar um e associá-lo à aplicação.

CMFCVisualManager::GetMDITabsBordersSize

O framework chama este 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 do MDITabs.

Observações

Substitua esta função numa classe derivada para personalizar o tamanho da borda da janela MDITabs.

CMFCVisualManager::GetMenuImageMargin

virtual int GetMenuImageMargin() const;

Valor de retorno

Observações

CMFCVisualManager::GetMenuItemTextColor

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

Parâmetros

[dentro] pButton
[dentro] bDestacado
[dentro] bDeficiente

Valor de retorno

Observações

CMFCVisualManager::GetMenuShadowDepth

Recupera a largura e altura da sombra do menu.

int GetMenuShadowDepth() const;

Valor de retorno

A largura e altura da sombra do menu em pixels.

Observações

A largura e altura da sombra do menu são equivalentes. O valor padrão é 7 píxeis.

CMFCVisualManager::GetNcBtnSize

É chamado pelo framework quando tem de recuperar o tamanho dos botões do sistema.

virtual CSize GetNcBtnSize(BOOL bSmall) const;

Parâmetros

bSmall
[dentro] Um parâmetro booleano que indica se GetNcBtnSize deve recuperar o tamanho de um botão de sistema pequeno ou grande. Se o bSmall for VERDADEIRO, GetNcBtnSize devolve o tamanho de um pequeno botão do sistema. Caso contrário, devolve o tamanho de um grande botão do sistema.

Valor de retorno

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

Observações

Os botões do sistema são os botões na legenda da janela de frames que correspondem aos comandos Fechar, Minimizar, Maximizar e Restaurar. O tamanho destes botões depende do gestor visual atual. Anule este método se quiser personalizar o tamanho dos botões do sistema na sua aplicação.

CMFCVisualManager::GetPopupMenuBorderSize

O framework chama este 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.

Observações

Substitua este método para personalizar o tamanho das bordas dos menus pop-up na sua aplicação.

CMFCVisualManager::GetPopupMenuGap

virtual int GetPopupMenuGap() const;

Valor de retorno

Observações

CMFCVisualManager::GetPropertyGridGroupColor

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

virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);

Parâmetros

pPropList
[dentro] Um apontador para a lista de propriedades que a estrutura está a desenhar.

Valor de retorno

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

Observações

Substitua esta função para personalizar a cor de fundo de uma lista de propriedades na sua aplicação.

CMFCVisualManager::GetPropertyGridGroupTextColor

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

virtual COLORREF GetPropertyGridGroupTextColor(CMFCPropertyGridCtrl* pPropList);

Parâmetros

pPropList
[dentro] Um indicador para a lista de propriedades.

Valor de retorno

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

Observações

Substitua esta função para personalizar a cor do texto de uma lista de propriedades na sua aplicação.

CMFCVisualManager::GetRibbonHyperlinkTextColor

virtual COLORREF GetRibbonHyperlinkTextColor(CMFCRibbonLinkCtrl* pHyperLink);

Parâmetros

[dentro] pHyperLink

Valor de retorno

Observações

CMFCVisualManager::GetRibbonPopupBorderSize

virtual int GetRibbonPopupBorderSize(const CMFCRibbonPanelMenu*) const;

Parâmetros

[dentro] CMFCRibbonPanelMenu*

Valor de retorno

Observações

CMFCVisualManager::GetRibbonQuickAccessToolBarChevronOffset

virtual int GetRibbonQuickAccessToolBarChevronOffset();

Valor de retorno

Observações

CMFCVisualManager::GetRibbonQuickAccessToolBarRightMargin

virtual int GetRibbonQuickAccessToolBarRightMargin();

Valor de retorno

Observações

CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor

virtual COLORREF GetRibbonQuickAccessToolBarTextColor(BOOL bDisabled = FALSE);

Parâmetros

[dentro] bDeficiente

Valor de retorno

Observações

CMFCVisualManager::GetRibbonSliderColors

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

Parâmetros

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

Observações

CMFCVisualManager::GetRibbonStatusBarTextColor

virtual COLORREF GetRibbonStatusBarTextColor(CMFCRibbonStatusBar* pStatusBar);

Parâmetros

[dentro] pStatusBar

Valor de retorno

Observações

CMFCVisualManager::GetShowAllMenuItemsHeight

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

Parâmetros

[dentro] pDC
[dentro] tamanhoPadrão

Valor de retorno

Observações

CMFCVisualManager::GetSmartDockingBaseGuideColors

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

Parâmetros

[dentro] clrBaseGroupAntecedentes
[dentro] clrBaseGroupFronteira

Observações

CMFCVisualManager::GetSmartDockingHighlightTonColorColor

virtual COLORREF GetSmartDockingHighlightToneColor();

Valor de retorno

Observações

CMFCVisualManager::GetSmartDockingTheme

Devolve um tema usado para mostrar marcadores de acoplamento inteligentes.

virtual AFX_SMARTDOCK_THEME GetSmartDockingTheme();

Valor de retorno

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

Observações

CMFCVisualManager::GetStatusBarPaneTextColor

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

Parâmetros

[dentro] pStatusBar
[dentro] pPane

Valor de retorno

Observações

CMFCVisualManager::GetTabFrameColors

O framework chama esta função quando tem de recuperar o conjunto de cores para desenhar uma janela de separador.

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
[dentro] Um apontador para a janela separada onde o quadro desenha um separador.

clrDark
[fora] Uma referência a um parâmetro COLORREF onde este método armazena a cor da borda escura de um separador.

clrBlack
[fora] Uma referência a um parâmetro COLORREF onde este método armazena a cor para a borda da janela do separador. A cor padrão da borda é preta.

clrDestaque
[fora] Uma referência a um parâmetro COLORREF onde este método armazena a cor para o estado de destaque da janela do separador.

clrFace
[fora] Uma referência a um parâmetro COLORREF onde este método armazena a cor para a face da janela de separador.

clrDarkShadow
[fora] Uma referência a um parâmetro COLORREF onde este método armazena a cor para a sombra da janela do separador.

clrLight
[fora] Uma referência a um parâmetro COLORREF onde este método armazena a cor para a borda clara da janela do separador.

pbrFace
[fora] Um indicador para uma referência de um pincel. Este método armazena o pincel que utiliza para preencher a face da janela do separador neste parâmetro.

pbrBlack
[fora] Um indicador para uma referência de um pincel. Este método armazena o pincel que utiliza para preencher a borda preta da janela de separador neste parâmetro.

Observações

Substitua esta função numa classe derivada se quiser personalizar o conjunto de cores que o framework usa quando desenha uma janela de tabulação.

CMFCVisualManager::GetTabHorzMargin

virtual int GetTabHorzMargin(const CMFCBaseTabCtrl*);

Parâmetros

[dentro] CMFCBaseTabCtrl*

Valor de retorno

Observações

CMFCVisualManager::GetTabTextColor

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

Parâmetros

[dentro] CMFCBaseTabCtrl*
[dentro] int
[dentro] BOOL

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneGroupCaptionHeight

int GetTasksPaneGroupCaptionHeight() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneGroupCaptionHorzOffset

int GetTasksPaneGroupCaptionHorzOffset() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneGroupCaptionVertOffset

int GetTasksPaneGroupCaptionVertOffset() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneGroupVertOffset

int GetTasksPaneGroupVertOffset() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneHorzMargin

int GetTasksPaneHorzMargin() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneIconHorzOffset

int GetTasksPaneIconHorzOffset() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneIconVertOffset

int GetTasksPaneIconVertOffset() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneTaskHorzOffset

int GetTasksPaneTaskHorzOffset() const;

Valor de retorno

Observações

CMFCVisualManager::GetTasksPaneVertMargin

int GetTasksPaneVertMargin() const;

Valor de retorno

Observações

CMFCVisualManager::GetToolbarButtonTextColor

A estrutura chama este 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
[dentro] Um apontador para o botão da barra de ferramentas.

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

Valor de retorno

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

Observações

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

Substitua esta função para personalizar a cor do texto de um botão da barra de ferramentas na sua aplicação.

CMFCVisualManager::GetToolBarCustomizeButtonMargin

virtual int GetToolBarCustomizeButtonMargin() const;

Valor de retorno

Observações

CMFCVisualManager::GetToolbarDisabledColor

virtual COLORREF GetToolbarDisabledColor() const;

Valor de retorno

Observações

CMFCVisualManager::GetToolbarDisabledTextColor

A estrutura chama esta 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.

Observações

Substitua este método num gestor 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

Observações

CMFCVisualManager::GetToolTipInfo

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

Parâmetros

[dentro] Params
[dentro] nType

Valor de retorno

Observações

CMFCVisualManager::HasOverlappedAutoHideButtons

Devolve se os botões de ocultação automática se sobrepõem no gestor visual atual.

virtual BOOL HasOverlappedAutoHideButtons() const;

Valor de retorno

TRUE se os botões de ocultação automática se sobrepõem; FALSE se não o fizerem.

CMFCVisualManager::IsAutoDestroy

BOOL IsAutoDestroy() const;

Valor de retorno

Observações

CMFCVisualManager::IsDefaultWinXPPopupButton

virtual BOOL IsDefaultWinXPPopupButton(CMFCDesktopAlertWndButton*) const;

Parâmetros

[dentro] CMFCDesktopAlertWndButton*

Valor de retorno

Observações

CMFCVisualManager::IsDockingTabHasBorder

Devolve se o gestor visual atual desenha bordas em torno dos painéis que estão acoplados e separados.

virtual BOOL IsDockingTabHasBorder();

Valor de retorno

VERDADE se o gestor visual desenhar bordas em painéis que estão acoplados e separados; FALSO, caso contrário.

Observações

Os painéis acoplados tornam-se separados quando vários vidros estão acoplados ao mesmo local.

CMFCVisualManager::IsEmbossDisabledImage

Especifica se o framework embossa imagens que não estão disponíveis.

BOOL IsEmbossDisabledImage() const;

Valor de retorno

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

Observações

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

CMFCVisualManager::IsFadeInactiveImage

O framework chama este método quando desenha imagens inativas na barra de ferramentas ou num menu.

BOOL IsFadeInactiveImage() const;

Valor de retorno

Diferente de zero se a framework usar o efeito de iluminação quando desenha imagens inativas na barra de ferramentas ou num menu; caso contrário, 0.

Observações

Pode ativar ou desativar o efeito de iluminação ligando para CMFCVisualManager::SetFadeInactiveImage. O efeito de iluminação é o que faz com que as imagens indisponíveis pareçam desbotadas.

CMFCVisualManager::IsFrameMenuCheckedItems

BOOL IsFrameMenuCheckedItems() const;

Valor de retorno

Observações

CMFCVisualManager::IsHighlightOneNoteTabs

virtual BOOL IsHighlightOneNoteTabs() const;

Valor de retorno

Observações

CMFCVisualManager::IsHighlightItemMenuInteiro

virtual BOOL IsHighlightWholeMenuItem();

Valor de retorno

Observações

CMFCVisualManager::IsLayeredRibbonKeyTip

virtual BOOL IsLayeredRibbonKeyTip() const;

Valor de retorno

Observações

CMFCVisualManager::IsMenuFlatLook

Indica se os botões do menu parecem planos.

BOOL IsMenuFlatLook() const;

Valor de retorno

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

Observações

Por defeito, os botões do menu não aparecem planos. Use o método CMFCVisualManager::SetMenuFlatLook para alterar este comportamento. Quando os botões do menu parecem planos, não mudam de aparência quando o utilizador clica neles.

CMFCVisualManager::IsOfficeXPStyleMenus

Indica se o gestor visual implementa menus ao estilo Office XP.

virtual BOOL IsOfficeXPStyleMenus() const;

Valor de retorno

Não zero se o gestor visual mostrar menus ao estilo Office XP; caso contrário, 0.

Observações

A classe CMFCPopupMenu chama este método quando tem de desenhar o menu e fazer sombra. Por defeito, este método devolve FALSE. Se quiseres usar menus pop-up semelhantes aos menus pop-up do Office XP, sobrepõe este método num gestor visual personalizado e devolve TRUE.

CMFCVisualManager::IsOffsetPressedButton

virtual BOOL IsOffsetPressedButton() const;

Valor de retorno

Observações

CMFCVisualManager::IsOwnerDrawCaption

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

virtual BOOL IsOwnerDrawCaption();

Valor de retorno

TRUE se todas as janelas de frames na aplicação tiverem legendas desenhadas pelo proprietário; FALSO, caso contrário.

CMFCVisualManager::IsOwnerDrawMenuCheck

virtual BOOL IsOwnerDrawMenuCheck();

Valor de retorno

Observações

CMFCVisualGerente::ÉSombraImageDestacadaT

Indica se o gestor visual apresenta sombras ao renderizar imagens destacadas.

BOOL IsShadowHighlightedImage() const;

Valor de retorno

Não zero quando o gestor visual mostra sombras sob imagens destacadas; 0 caso contrário.

CMFCVisualManager::IsToolbarButtonFillEnabled

BOOL IsToolbarButtonFillEnabled() const;

Valor de retorno

Observações

CMFCVisualManager::IsToolbarRoundShape

virtual BOOL IsToolbarRoundShape(CMFCToolBar*);

Parâmetros

[dentro] CMFCToolBar*

Valor de retorno

Observações

CMFCVisualManager::IsWindowsThemingSuportado

virtual BOOL IsWindowsThemingSupported() const;

Valor de retorno

Observações

CMFCVisualManager::OnActivateApp

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

Parâmetros

[dentro] pWnd
[dentro] bActive

Observações

CMFCVisualManager::OnDrawAutoHideButtonBorder

A estrutura chama este método quando desenha a borda de um botão de ocultação automática.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectBounds
[dentro] O tamanho e localização do botão de ocultação automática.

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

pButton
[dentro] Um apontador para o botão de ocultação automática. A estrutura está a desenhar a borda deste botão.

Observações

Substitua este método numa classe derivada se quiser personalizar a aparência da borda de um botão de ocultação automática. Por defeito, este método preenche uma borda plana com a cor de sombra padrão da sua aplicação.

O parâmetro rectBorderSize não contém as coordenadas da borda. Contém o tamanho da borda nos topmembros , bottom, left, e right dos dados. Um valor menor ou igual a 0 indica que não há fronteira desse lado do botão de ocultação automática.

CMFCVisualManager::OnDrawBarGripper

É chamado pela estrutura quando puxa a garra para uma barra de controlo.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo para uma barra de controlo.

rectGripper
[dentro] O retângulo delimitador para a barra de controlo.

bHorz
[dentro] Um parâmetro booleano que especifica se a barra de controlo está acoplada horizontal ou verticalmente.

pBar
[dentro] Um indicador para uma barra de controlo. O gestor visual desenha o gripper desta barra de controlo.

Observações

A implementação padrão deste método mostra o gripper padrão. Para personalizar a aparência do gripper, substitua este método numa classe personalizada derivada da CMFCVisualManager classe.

CMFCVisualManager::OnDrawBrowseButton

A framework chama este método quando desenha o botão de navegação para um controlo de edição.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica o limite do botão de navegar.

pEdit
[dentro] Um apontador para um controlo de edição. O gestor visual desenha o botão de navegação para este controlo de edição.

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

clrText
[fora] Uma referência a um parâmetro COLORREF . Este é um valor reservado e está atualmente por usar.

Valor de retorno

VERDADEIRO se for bem-sucedido; caso contrário, FALSO.

Observações

Substitua esta função numa classe derivada se quiser personalizar a aparência dos botões de navegação nas 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 este método quando desenha a borda de um botão da barra de ferramentas.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo de um botão da barra de ferramentas.

pButton
[dentro] Um apontador para um botão da barra de ferramentas. A estrutura desenha a borda deste botão.

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

state
[dentro] Um tipo de dado enumerado que especifica o estado atual do botão da barra de ferramentas.

Observações

A implementação padrão deste método mostra a borda padrão. Substitua este método num gestor visual derivado para personalizar a aparência da borda de um botão da barra de ferramentas.

Os possíveis estados 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

[dentro] pDC
[dentro] pButton
[dentro] Rect
[dentro] Estado
[dentro] bHorz

Observações

CMFCVisualManager::OnDrawCaptionBarBorder

A estrutura chama este método quando desenha a borda de um objeto CMFCCaptionBar Class .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pBar
[dentro] Um indicador para um CMFCCaptionBar objeto. A estrutura desenha esta barra de legendas.

retângulo
[dentro] Um retângulo que especifica os limites da barra da legenda.

clrBarBorder
[dentro] A cor da borda.

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

Observações

Substitua este método numa classe derivada para personalizar a aparência da borda de uma barra de legendas.

CMFCVisualManager::OnDrawCaptionBarButtonBorder

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

Parâmetros

[dentro] pDC
[dentro] pBar
[dentro] Rect
[dentro] bIsPressed
[dentro] bIsHighlighted
[dentro] bIsDisabled
[dentro] bHasDropDownArrow
[dentro] bIsSysButton

Observações

CMFCVisualManager::OnDrawCaptionBarInfoArea

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

Parâmetros

[dentro] pDC
[dentro] pBar
[dentro] Rect

Observações

CMFCVisualManager::OnDrawCaptionButton

O framework chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um indicador para um CMFCCaptionButton objeto. A estrutura desenha este botão de legenda.

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

bHorz
[dentro] Um parâmetro booleano que especifica se a legenda é horizontal.

bMaximizado
[dentro] Um parâmetro booleano que especifica se o painel pai é maximizado.

bDeficiente
[dentro] Um parâmetro booleano que especifica se o botão de legenda está desativado.

nImageID
[dentro] O índice da imagem para o ícone a usar no botão. Se o nImageID for -1, este método utiliza o índice de imagem registado em pButton.

Observações

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

Substitua este método numa 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

[dentro] pDC
[dentro] Rect
[dentro] bDestacado
[dentro] bVerificado
[dentro] bEnabled

Observações

CMFCVisualManager::OnDrawCheckCheckEx

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

Parâmetros

[dentro] pDC
[dentro] Rect
[dentro] nState
[dentro] bDestacado
[dentro] bPressed
[dentro] bEnabled

Observações

CMFCVisualManager::OnDrawComboBorder

A estrutura chama este método quando desenha a fronteira 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
[dentro] Um apontador para o contexto do dispositivo de um botão de combo.

retângulo
[dentro] Um retângulo que especifica os limites do botão da caixa de combo.

bDeficiente
[dentro] Um parâmetro booleano que indica se o botão da caixa de combo não está disponível.

bIsDropped
[dentro] Um parâmetro booleano que indica se a caixa de combo é descer.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o botão da caixa de combo está destacado.

pButton
[dentro] Um indicador para um CMFCToolBarComboBoxButton objeto. A estrutura desenha este botão de combo.

Observações

Substitua este método no seu gestor visual derivado para personalizar a aparência da borda da caixa de combo.

CMFCVisualManager::OnDrawComboDropButton

A framework chama este método quando desenha o botão de drop de um CMFCToolBarComboBoxButton.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do botão de drop.

bDeficiente
[dentro] Um parâmetro booleano que indica se o botão de largar está indisponível.

bIsDropped
[dentro] Um parâmetro booleano que indica se a caixa de combo é descer.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o botão de drop está destacado.

pButton
[dentro] Um indicador para um CMFCToolBarComboBoxButton objeto. A estrutura desenha o botão de drop deste botão de combo.

Observações

Substitua este método no seu gestor visual derivado para personalizar a aparência do botão de drop de um botão de combo.

CMFCVisualManager::OnDrawControlBorder

virtual void OnDrawControlBorder(CWnd* pWndCtrl);

Parâmetros

[dentro] pWndCtrl

Observações

CMFCVisualManager::OnDrawDefaultRibbonImage

O framework chama este método quando desenha a imagem padrão usada para o botão de fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

bIsDisabled
[dentro] Um parâmetro booleano que indica se o botão de fita está indisponível.

bIsPressed
[dentro] Um parâmetro booleano que indica se o botão da fita é pressionado.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o botão da fita está destacado.

Observações

Substitua este método num gestor visual derivado se quiser personalizar a imagem usada para o botão de fita.

CMFCVisualManager::OnDrawEditBorder

A estrutura chama este método quando desenha a fronteira em torno de uma instância da Classe CMFCToolBarEditBoxButton.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do CMFCToolBarEditBoxButton objeto.

bDeficiente
[dentro] Um parâmetro booleano que indica se o botão está indisponível.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o botão está destacado.

pButton
[dentro] Um indicador para um CMFCToolBarEditBoxButton objeto. A estrutura desenha a borda deste botão da caixa de edição.

Observações

Substitua este método num gestor visual derivado para personalizar a borda de um CMFCToolBarEditBoxButton objeto.

CMFCVisualManager::OnDrawExpandingBox

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

Parâmetros

[dentro] pDC
[dentro] Rect
[dentro] bIsOpened
[dentro] colorBox

Observações

CMFCVisualManager::OnDrawFloatingToolbarBorderBorder

A estrutura chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

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

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

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

Observações

Uma barra de ferramentas flutuante é uma barra de ferramentas que aparece como uma janela de mini-frame. Normalmente, isto ocorre quando um utilizador arrasta uma barra de ferramentas para que esta deixe de estar acoplada.

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 este método num gestor visual derivado para personalizar a aparência da borda de uma barra de ferramentas flutuante.

CMFCVisualManager::OnDrawHeaderCtrlBorder

A estrutura chama este método quando desenha a fronteira em torno de uma instância da Classe CMFCHeaderCtrl.

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

Parâmetros

pCtrl
[dentro] Um indicador para um CMFCHeaderCtrl objeto. A estrutura desenha a fronteira deste controlo de cabeçalho.

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do controlo do cabeçalho.

bIsPressed
[dentro] Um parâmetro booleano que indica se o controlo do cabeçalho é pressionado.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o controlo do cabeçalho está destacado.

Observações

Substitua este método num gestor visual derivado para personalizar a borda do controlo do cabeçalho.

CMFCVisualManager::OnDrawHeaderCtrlSortArrow

O framework chama esta função quando desenha a seta de ordenação de um controlo de cabeçalho.

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

Parâmetros

pCtrl
[dentro] Um apontador para um controlo de cabeçalho. O gestor visual desenha a seta de ordenação deste objeto CMFCHeaderCtrl Class .

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites da seta de ordenação.

bIsUp
[dentro] Um Booleano que especifica a direção da seta de ordenação.

Observações

Se o bIsUp for VERDADEIRO, o gestor visual desenha uma seta de ordenação para cima. Se for FALSO, o gestor visual desenha uma seta de ordenação para baixo. Sobrescrever OnDrawHeaderCtrlSortArrow numa classe derivada para personalizar a aparência do botão de ordenação.

CMFCVisualManager::OnDrawMenuArrowOnCustomizeList

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

Parâmetros

[dentro] pDC
[dentro] rectCommand
[dentro] bSelecionado

Observações

CMFCVisualManager::OnDrawMenuBorder

A framework chama este método quando desenha a borda de um CMFCPopupMenu.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo para um CMFCPopupMenu objeto.

pMenu
[dentro] Um indicador para um CMFCPopupMenu objeto. A estrutura desenha uma fronteira em torno deste menu pop-up.

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

Observações

A implementação padrão deste método apresenta a borda padrão do menu. Substitua este método num gestor 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

[dentro] pDC
[dentro] pButton
[dentro] Rect
[dentro] bDestaques
[dentro] bIsRadio

Observações

CMFCVisualManager::OnDrawMenuItemButton

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

Parâmetros

[dentro] pDC
[dentro] pButton
[dentro] rectButton
[dentro] bDestaques
[dentro] bDeficiente

Observações

CMFCVisualManager::OnDrawMenuLabel

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

Parâmetros

[dentro] pDC
[dentro] Rect

Valor de retorno

Observações

CMFCVisualManager::OnDrawMenuResizeBarBar

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

Parâmetros

[dentro] pDC
[dentro] Rect
[dentro] nRedimensionFlags

Observações

CMFCVisualManager::OnDrawMenuScrollButton

A estrutura chama este método quando desenha um botão de scroll no menu.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do botão de rolar.

bIsScrollDown
[dentro] Um Booleano que indica que tipo de botão o gestor visual desenha. Um valor de TRUE indica que o gestor visual desenha um botão para baixo.

bIsHighlited
[dentro] Um Booleano que indica se o botão está destacado.

bIsPressed
[dentro] Um Booleano que indica se o botão é pressionado.

bIsDisabled
[dentro] Um Booleano que indica se o botão está desativado.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência dos botões de rolagem do menu. Os botões de scroll do menu aparecem na borda dos menus pop-up quando a altura total dos itens do 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

[dentro] pDC
[dentro] rectClient
[dentro] rectExclude
[dentro] nProfundidade
[dentro] iMinBrightness
[dentro] iMaxBrightness
[dentro] pBmpSaveBottom
[dentro] pBmpSaveRight
[dentro] bRTL

Observações

CMFCVisualManager::OnDrawMenuSystemButton

A estrutura chama este método quando desenha um botão do sistema de menus para a aplicação.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

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

nStyle
[dentro] Uma bandeira que especifica o estilo atual do botão. Os valores possíveis são TBBS_PRESSED, TBBS_DISABLED e 0.

bDestaques
[dentro] Um parâmetro booleano que especifica se o botão está destacado.

Observações

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

A implementação padrão deste método chama CDC::D rawFrameControl com o tipo DFC_CAPTION. Substitua este método na sua classe de gestor 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

[dentro] pDC
[dentro] pFrameWnd
[dentro] rectBorder
[dentro] rectBorderSize

Observações

CMFCVisualManager::OnDrawOutlookBarSplitter

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

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência dos divisores numa barra do Outlook.

CMFCVisualManager::OnDrawOutlookPageButtonBorder

É chamado pelo framework 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
[dentro] Um apontador para o contexto de um dispositivo.

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

bIsHighlighted
[dentro] Um Booleano que especifica se o botão está destacado.

bIsPressed
[dentro] Um Booleano que especifica se o botão é pressionado.

Observações

Substitua este método num gestor visual personalizado para alterar a aparência do botão da página do Outlook.

CMFCVisualManager::OnDrawPaneBorder

A estrutura chama este método quando desenha a borda de um objeto CPane Class .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo de uma barra de controlo.

pBar
[dentro] Um apontador para um painel. O gestor visual desenha a borda deste painel.

retângulo
[dentro] Um retângulo que indica os limites do pane.

Observações

A implementação padrão deste método mostra a borda padrão. Substitua este método numa classe derivada para personalizar a aparência da borda.

CMFCVisualManager::OnDrawPaneCaption

O framework chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

pBar
[dentro] Um indicador para um CDockablePane objeto. A estrutura desenha a legenda para este painel.

bActive
[dentro] Um parâmetro booleano que indica se a barra de controlo está ativa.

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

rectButtons
[dentro] 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.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência das legendas dos painéis.

CMFCVisualManager::OnDrawPaneDivider

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

Parâmetros

[dentro] pDC
[dentro] pSlider
[dentro] Rect
[dentro] bAutoHideMode

Observações

CMFCVisualManager::OnDrawPopupWindowBorder

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

Parâmetros

[dentro] pDC
[dentro] Rect

Observações

CMFCVisualManager::OnDrawPopupWindowButtonBorder

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

Parâmetros

[dentro] pDC
[dentro] rectClient
[dentro] pButton

Observações

CMFCVisualManager::OnDrawPopupWindowCaption

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

Parâmetros

[dentro] pDC
[dentro] rectCaption
[dentro] pPopupWnd

Valor de retorno

Observações

CMFCVisualManager::OnDrawRibbonApplicationButton

A estrutura chama este método quando desenha o Botão Principal na fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um apontador para o Botão Principal na fita.

Observações

Substitua este método num gestor visual derivado se quiser personalizar a aparência do Botão Principal.

CMFCVisualManager::OnDrawRibbonButtonBorder

A estrutura chama este método quando desenha a borda de um botão na fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um apontador para um objeto CMFCRibbonButton . A estrutura desenha a borda deste botão de fita.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um CMFCRibbonButton.

CMFCVisualManager::OnDrawRibbonButtonsGroup

A estrutura chama este método quando desenha um grupo de botões na fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pGroup
[dentro] Um apontador para um grupo de botões na fita. A estrutura desenha este grupo de botões.

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

Valor de retorno

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um grupo de botões na fita.

CMFCVisualManager::OnDrawRibbonCaption

A estrutura chama este método quando desenha a barra de legendas da janela principal. A estrutura chama este método apenas se a fita estiver integrada com a estrutura principal.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pBar
[dentro] Um indicador para uma barra de fitas. O gestor visual desenha esta barra de fitas.

retângulo
[dentro] Um retângulo que especifica os limites da barra de fita.

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

Observações

Substitua esta função num gestor visual derivado para personalizar a aparência da barra de legendas. Este método afeta a barra de legendas apenas se a fita estiver integrada com a janela do quadro principal.

CMFCVisualManager::OnDrawRibbonCaptionButton

A estrutura chama este método quando desenha um botão de legenda localizado na barra de fita.

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

Parâmetros

pDC
Um ponteiro para um contexto de dispositivo.

pButton
Um indicador para uma CMFCRibbonCaptionButton classe. A estrutura desenha este botão de legenda.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um botão de legenda na fita.

CMFCVisualManager::OnDrawRibbonCategory

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

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pCategoria
[dentro] Um indicador para um CMFCRibbonCategory objeto. A estrutura desenha esta categoria de fitas.

rectCategory
[dentro] Um retângulo que especifica o limite de todos os painéis de categoria na fita.

Observações

Uma categoria de fita é um agrupamento lógico de comandos de menu. Para mais informações sobre categorias de fitas, consulte CMFCRibbonCategory Class.

Substitua este método num gestor visual derivado para personalizar a aparência de uma categoria de fita.

CMFCVisualManager::OnDrawRibbonCategoriaLegenda

O framework chama este método quando desenha a barra de legenda para uma categoria de fita.

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

Parâmetros

pDC
[dentro] O contexto de desenho.

pContextCaption
[dentro] Um indicador para uma barra de legendas. O gestor visual desenha este objeto CMFCRibbonContextCaption Class .

Valor de retorno

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

Observações

Substitua este método numa classe derivada para personalizar a aparência da barra de legendas para uma categoria de fita. Para mais informações sobre a barra de legendas, consulte CMFCRibbonContextCaption Class.

CMFCVisualManager::OnDrawRibbonCategoryScroll

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

Parâmetros

[dentro] pDC
[dentro] pScroll

Observações

CMFCVisualManager::OnDrawRibbonCategoryTab

A estrutura chama este método quando desenha o separador para uma categoria de fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pTab
[dentro] Um apontador para uma instância da CMFCRibbonTab classe. A estrutura desenha este separador.

bIsActive
[dentro] Um parâmetro booleano que indica se o separador está ativo.

Valor de retorno

A cor usada para o texto no separador de categoria da fita.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um separador de categoria de fita. Para mais informações sobre categorias de fitas, consulte CMFCRibbonCategory Class.

CMFCVisualManager::OnDrawRibbonCheckCheckBoxOnList

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

Parâmetros

[dentro] pDC
[dentro] pCheckBox
[dentro] Rect
[dentro] bIsSelected
[dentro] bDestacado

Observações

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

[dentro] pDC
[dentro] pColorButton
[dentro] pIcon
[dentro] Cor
[dentro] Rect
[dentro] bDrawTopEdge
[dentro] bDrawBottomEdge
[dentro] bIsHighlighted
[dentro] bIsChecked
[dentro] bIsDisabled

Observações

CMFCVisualManager::OnDrawRibbonDefaultPaneButton

A estrutura chama este método quando desenha o botão padrão para o painel da fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um apontador para o botão predefinido do painel de fita.

Observações

A estrutura apresenta o botão predefinido quando um painel de fita é redimensionado para o seu tamanho mínimo e não existe uma área para mostrar o conteúdo do painel. Quando o utilizador clica no botão predefinido, a estrutura apresenta um menu suspenso que contém o conteúdo do painel.

Substitua este método num gestor visual derivado para personalizar a aparência do botão predefinido.

CMFCVisualManager::OnDrawRibbonDefaultPaneButtonContext

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

Parâmetros

[dentro] pDC
[dentro] pButton

Observações

CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator

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

Parâmetros

[dentro] pDC
[dentro] pButton
[dentro] Rect
[dentro] bIsSelected
[dentro] bDestacado

Observações

CMFCVisualGerente::OnDrawRibbonGalleryBorder

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

Parâmetros

[dentro] pDC
[dentro] pButton
[dentro] rectBorder

Observações

CMFCVisualGerente::OnDrawRibbonGalleryButton

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

Parâmetros

[dentro] pDC
[dentro] pButton

Observações

CMFCVisualManager::OnDrawRibbonKeyTip

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

Parâmetros

[dentro] pDC
[dentro] pElement
[dentro] Rect
[dentro] str

Observações

CMFCVisualManager::OnDrawRibbonLabel

A estrutura chama a este método quando desenha o rótulo da fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pLabel
[dentro] Um apontador para um objeto CMFCRibbonLabel . A estrutura desenha este rótulo de fita.

retângulo
[dentro] Um retângulo que especifica os limites do painel de fita.

Observações

Substitua este método numa classe derivada para personalizar a etiqueta da fita.

CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder

A estrutura chama este método quando desenha a borda de um CMFCRibbonButton que está posicionado no painel principal .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um apontador para um CMFCRibbonButton localizado no painel principal da fita. A estrutura desenha a borda deste botão.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da borda do painel CMFCRibbonButtonprincipal .

CMFCVisualManager::OnDrawRibbonMainPanelFrame

O framework chama este método quando desenha o frame em torno do CMFCRibbonMainPanel.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pPanel
[dentro] Um apontador para o CMFCRibbonMainPanel.

retângulo
[dentro] Um retângulo que especifica os limites do CMFCRibbonMainPanel.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência do frame para o CMFCRibbonMainPanel.

CMFCVisualManager::OnDrawRibbonMenuCheckFrame

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

Parâmetros

[dentro] pDC
[dentro] pButton
[dentro] Rect

Observações

CMFCVisualManager::OnDrawRibbonPanel

O framework chama este método quando desenha um objeto CMFCRibbonPanel .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pPanel
[dentro] Um indicador para um CMFCRibbonPanel objeto. A estrutura desenha este painel de fita.

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

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

Valor de retorno

A cor do texto no painel de fita.

Observações

Substitua este método numa classe derivada para personalizar a aparência de um painel de fita.

CMFCVisualManager::OnDrawRibbonPanelLegenda

O framework chama este método quando desenha a legenda de uma Classe CMFCRibbonPanel.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pPanel
[dentro] Um indicador para um CMFCRibbonPanel objeto. A estrutura desenha a legenda para este painel de fita.

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

Observações

Substitua este método numa classe derivada para personalizar a aparência das legendas para painéis de fita.

CMFCVisualManager::OnDrawRibbonProgressBar

A estrutura chama este método quando desenha uma Classe CMFCRibbonProgressBar.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pProgress
[dentro] Um indicador para um CMFCRibbonProgressBar objeto. O quadro desenha esta barra de progresso.

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

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

bInfiniteMode
[dentro] Um parâmetro booleano que indica o modo da barra de progresso. Um valor de TRUE significa que a barra está em modo infinito. A implementação padrão não utiliza este parâmetro.

Observações

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

CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator

O framework chama este método quando desenha um separador na Barra de Ferramentas de Acesso Rápido de uma fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pSeparator
[dentro] Um apontador para um objeto CMFCRibbonSeparator . A estrutura desenha este separador de fita.

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

Observações

Substitua este método numa classe derivada para personalizar a aparência dos separadores de fita na Barra de Ferramentas de Acesso Rápido.

CMFCVisualManager::OnDrawRibbonRecentFilesFrame

O framework chama este método quando desenha um frame em torno de uma lista de ficheiros recentes.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pPanel
[dentro] Um apontador para o painel principal na fita.

retângulo
[dentro] Um retângulo que especifica os limites da moldura para a lista de ficheiros recentes.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da lista de ficheiros recentes.

CMFCVisualManager::OnDrawRibbonSliderChannel

O framework chama este método quando desenha o canal de uma Classe CMFCRibbonSlider.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pSlider
[dentro] Um apontador para um objeto CMFCRibbonSlider. A estrutura desenha o canal para este deslizador de fita.

retângulo
[dentro] Um retângulo que especifica os limites do canal do deslizador de fita.

Observações

Substitua este método numa classe derivada para personalizar a aparência do canal do slider de fita.

CMFCVisualManager::OnDrawRibbonSliderThumb

A framework chama este método quando desenha o polegar de um objeto CMFCRibbonSlider .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pSlider
[dentro] Um indicador para um CMFCRibbonSlider. A estrutura desenha o polegar para este deslizador de fita.

retângulo
[dentro] Um retângulo que especifica os limites do polegar para o deslizador de fita.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o polegar está destacado.

bIsPressed
[dentro] Um parâmetro booleano que indica se o polegar está pressionado.

bIsDisabled
[dentro] Um parâmetro booleano que indica se o polegar não está disponível.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência do polegar para um CMFCRibbonSlider.

CMFCVisualManager::OnDrawRibbonSliderZoomButton

A framework chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

pSlider
[dentro] Um indicador para um CMFCRibbonSlider objeto. A estrutura desenha este deslizador de fita.

retângulo
[dentro] Um retângulo que especifica os limites dos botões de zoom no slider da fita.

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

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o botão está destacado.

bIsPressed
[dentro] Um parâmetro booleano que indica se o botão é pressionado.

bIsDisabled
[dentro] Um parâmetro booleano que indica se o botão está indisponível.

Observações

Por defeito, os botões de zoom no deslizador da fita são um círculo com um sinal + ou - no centro. Para personalizar a aparência dos botões de zoom, substitua este método num gestor visual derivado.

CMFCVisualManager::OnDrawRibbonStatusBarPane

A estrutura chama este método quando desenha um painel na barra de estado.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pBar
[dentro] Um apontador para a barra de estado que contém o painel.

pPane
[dentro] Um apontador para um painel da barra de estado. O framework desenha este objeto CMFCRibbonStatusBarPane .

Valor de retorno

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um painel na barra de estado.

CMFCVisualManager::OnDrawRibbonTabsFrame

A estrutura chama este método quando desenha a moldura em torno de um conjunto de separadores fita.

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

Parâmetros

pDC
Um ponteiro para um contexto de dispositivo.

pWndRibbonBar
Um apontador para um objeto CMFCRibbonBar . A estrutura desenha a estrutura para esta barra de fita.

rectTab
Um retângulo que especifica os limites das abas da fita.

Valor de retorno

Um valor reservado. Por defeito, este método devolve -1.

Observações

Substitua este método num gestor visual derivado para personalizar o frame em torno de um conjunto de separadores na fita.

CMFCVisualManager::OnDrawScrollButtons

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

Parâmetros

[dentro] pDC
[dentro] Rect
[dentro] nBorderSize
[dentro] iImage
[dentro] bHilited

Observações

CMFCVisualManager::OnDrawSeparator

A estrutura chama a este método quando desenha um separador.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo para uma barra de controlo.

pBar
[dentro] Um apontador para um painel que contém o separador.

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

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

Observações

Os separadores são usados nas barras de controlo para separar grupos de ícones relacionados. A implementação padrão deste método apresenta o separador padrão. Substitua este método num gestor 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

[dentro] pDC
[dentro] Rect
[dentro] Estado

Observações

CMFCVisualManager::OnDrawSpinButtons

O framework chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

rectSpin
[dentro] Um retângulo que especifica os limites do controlo de spin.

nState
[dentro] Uma bandeira que indica o estado do controlo de spin. Consulte a seção Comentários para obter mais informações.

bOrientação
[dentro] Um parâmetro booleano que especifica a orientação do controlo de spin. Um valor de TRUE indica que o controlo de rotação é horizontal. Caso contrário, é vertical.

pSpinCtrl
[dentro] Um indicador para um controlo de rotação. A estrutura desenha os botões para este controlo.

Observações

O parâmetro nState indica o estado do controlo de spin. O parâmetro é um dos seguintes valores:

AFX_SPIN_PRESSEDUP
AFX_SPIN_PRESSEDDOWN
AFX_SPIN_HIGHLIGHTEDUP
AFX_SPIN_HIGHLIGHTEDDOWN
AFX_SPIN_DISABLED

Substitua este método num gestor visual derivado para personalizar a aparência de um controlo de rotação.

CMFCVisualManager::OnDrawSplitterBorder

O framework chama este método quando desenha a fronteira em torno de uma instância da Classe CSplitterWndEx.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pSplitterWnd
[dentro] Um apontador para uma janela divisor. A estrutura desenha a borda desta janela.

retângulo
[dentro] Um retângulo que especifica os limites da janela divisor.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da borda para uma janela divisor.

CMFCVisualManager::OnDrawSplitterBox

O framework chama este método quando desenha a caixa de arrastar para uma instância da Classe CSplitterWndEx. A caixa de arrastar aparece quando o utilizador seleciona a barra divisora e altera as dimensões das janelas filhas.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pSplitterWnd
[dentro] Um apontador para uma janela divisor. A estrutura desenha a caixa para esta janela divisor.

retângulo
[dentro] Um retângulo que especifica os limites da janela divisor.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da caixa de arrasto para uma janela divisor.

CMFCVisualManager::OnDrawStatusBarPaneBorder

A estrutura chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

pBar
[dentro] Um indicador para um CMFCStatusBar objeto. A estrutura desenha este objeto de barra de estado.

rectPane
[dentro] Um retângulo que especifica os limites da barra de estado.

uiID
[dentro] O ID da barra de estado.

nStyle
[dentro] O estilo da barra de status.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da borda de um CMFCStatusBar objeto.

CMFCVisualManager::OnDrawStatusBarProgress

O framework chama este 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
[dentro] Um apontador para o contexto do dispositivo para a barra de estado.

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

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

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

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

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

clrProgressBarDest
[dentro] Um parâmetro COLORREF que indica o fim de um gradiente de cor para a barra de progresso. Se o clrProgressBarDest for -1, a estrutura não desenha a barra de progresso como um gradiente de cor. Em vez disso, preenche toda a barra de progresso com a cor especificada pelo clrBar.

clrProgressText
[dentro] Um parâmetro COLORREF que indica a cor do texto para a representação textual do progresso atual. Este parâmetro é ignorado se o bProgressText estiver definido como FALSE.

bProgressText
[dentro] Um parâmetro booleano que indica se deve ser exibida a representação textual do progresso atual.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência do CMFCStatusBar objeto.

CMFCVisualManager::OnDrawStatusBarSizeBox

O framework chama este método quando desenha a caixa de tamanho para um CMFCStatusBar.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pStatBar
[dentro] Um indicador para uma barra de estado. A estrutura desenha a caixa de tamanho para esta barra de estado.

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da caixa de tamanho num CMFCStatusBar.

CMFCVisualManager::OnDrawTab

A estrutura chama este método quando desenha as tabulações para um objeto CMFCBaseTabCtrl .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectTab
[dentro] Um retângulo que especifica os limites do controlo de tabulação.

iTab
[dentro] O índice do separador que a estrutura desenha.

bIsActive
[dentro] Um parâmetro booleano que especifica se a tabulação está ativa.

pTabWnd
[dentro] Um indicador para um CMFCBaseTabCtrl objeto. O framework desenha este controlo de separador.

Observações

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

Substitua este método numa classe derivada para personalizar o aspeto dos separadores.

CMFCVisualManager::OnDrawTabFechaBotão

O framework chama este método quando desenha o botão Fechar no separador ativo.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

pTabWnd
[dentro] Um apontador para um controlo de tabulação. A estrutura desenha o botão Fechar para este controlo de separador.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o botão Fechar está destacado.

bIsPressed
[dentro] Um parâmetro booleano que indica se o botão de Fechar está pressionado.

bIsDisabled
[dentro] Um parâmetro booleano que indica se o botão Fechar está desativado.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência do botão Fechar no separador ativo do pTabWnd.

CMFCVisualManager::OnDrawTabContent

A estrutura chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

rectTab
[dentro] Um retângulo que especifica os limites do interior do separador.

iTab
[dentro] O índice baseado em zero do separador. A estrutura desenha o interior deste separador.

bIsActive
[dentro] Um parâmetro booleano que indica se uma tabulação está ativa.

pTabWnd
[dentro] Um apontador para o controlo separado que contém o separador a ser desenhado.

clrText
[dentro] A cor do texto no interior do separador.

Observações

O interior de um separador contém o texto e os ícones do separador. Substitua este método num gestor visual derivado para personalizar a aparência dos separadores.

CMFCVisualManager::OnDrawTabsButtonBorder

A estrutura chama este método quando desenha a borda de um botão de tabulação.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do botão de tabulação.

pButton
[dentro] Um apontador para um objeto CMFCButton . A estrutura traça a fronteira neste CMFCButton caso.

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

pWndTab
[dentro] Um apontador para a janela do separador pai.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da borda do botão de separação.

CMFCVisualManager::OnDrawTask

A estrutura chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

pTarefa
[dentro] Um apontador para um objeto CMFCTasksPaneTask . O quadro define esta tarefa.

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

bIsHighlighted
[dentro] Um parâmetro booleano que especifica se a tarefa apresentada está destacada.

bIsSelected
[dentro] Um parâmetro booleano que especifica se a tarefa apresentada está selecionada.

Observações

A estrutura apresenta as tarefas na barra de tarefas tanto como um ícone como texto. O parâmetro pIcons contém o ícone da tarefa indicado por pTask.

Substitua este método numa classe derivada para personalizar a aparência das tarefas na barra de tarefas.

CMFCVisualManager::OnDrawTasksGroupAreaFrontier

A estrutura chama a este método quando desenha uma borda em torno de um grupo numa classe CMFCTasksPane.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

bSpecial
[dentro] Um parâmetro booleano que especifica se a borda está destacada. Um valor de VERDADEIRO indica que a fronteira está destacada.

bNoTitle
[dentro] Um parâmetro booleano que especifica se a área do grupo tem um título. Um valor de VERDADEIRO indica que a área do grupo não tem título.

Observações

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

CMFCVisualManager::OnDrawTasksGroupCaption

O framework chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

pGroup
[dentro] Um indicador para um CMFCTasksPaneTaskGroup objeto. A estrutura define a legenda para este grupo.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o grupo está destacado.

bIsSelected
[dentro] Um parâmetro booleano que indica se o grupo está atualmente selecionado.

bCanCollapse
[dentro] Um parâmetro booleano que indica se o grupo pode ser colapsado.

Observações

Os grupos de tarefa aparecem no objeto CMFCTasksPane .

Substitua este método numa classe derivada para personalizar a legenda para 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

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

Observações

CMFCVisualManager::OnDrawTearOffCaption

A estrutura chama este método quando desenha a legenda para uma Classe CMFCPopupMenu.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

bIsActive
[dentro] TRUE se a legenda estiver ativa; FALSO, caso contrário.

Observações

Esta função é chamada pelo framework quando um CMFCPopupMenu objeto processa uma mensagem WM_PAINT e tem de desenhar uma legenda remotória.

Substitua este método numa classe derivada para personalizar o aspeto das legendas para barras de remoção.

CMFCVisualManager::OnDrawToolBoxFrame

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

Parâmetros

[dentro] pDC
[dentro] Rect

Observações

CMFCVisualManager::OnEraseMDIClientArea

O framework chama este método quando apaga a área cliente do MDI.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

Valor de retorno

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

Observações

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

CMFCVisualManager::OnErasePopupWindowButton

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

Parâmetros

[dentro] pDC
[dentro] rectClient
[dentro] pButton

Observações

CMFCVisualManager::OnEraseTabsArea

O framework chama este método quando apaga a área de separação de uma janela de separador.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites da área do separador.

pTabWnd
[dentro] Um apontador para uma janela de separador. A estrutura apaga a área do separador da janela de separador especificada.

Observações

Esta função é chamada pelo framework quando um objeto de classe CMFCBaseTabCtrl processa uma mensagem de WM_PAINT e apaga a área do separador.

Substitua este método num gestor visual derivado para personalizar a aparência dos separadores.

CMFCVisualManager::OnEraseTabsButton

A estrutura chama este método quando apaga o texto e o ícone de um botão de tabulação.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do botão de tabulação.

pButton
[dentro] Um apontador para um botão de separação. A estrutura apaga o texto e o ícone deste botão.

pWndTab
[dentro] Um apontador para o controlo de tabulação que contém o botão de tabulação.

Observações

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

Substitua este método num gestor visual derivado para personalizar a aparência dos botões de tabulação.

CMFCVisualManager::OnEraseTabsFrame

O framework chama este método quando apaga um frame numa Classe CMFCBaseTabCtrl.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites da janela de separador.

pTabWnd
[dentro] Um apontador para uma janela de separador. A estrutura apaga um referencial para este CMFCBaseTabCtrl.

Valor de retorno

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

Observações

Este método preenche a área indicada por retângulo com a cor de fundo do separador ativo. É chamada quando um CMFCBaseTabCtrl objeto processa uma mensagem WM_PAINT e apaga um frame de tabulação.

CMFCVisualManager::OnFillAutoHideButtonBackground

O framework chama este método quando preenche o fundo de um botão de ocultação automática.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do botão de ocultação automática.

pButton
[dentro] Um apontador para um objeto CMFCAutoHideButton . A estrutura preenche o fundo deste botão de ocultação automática.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um botão de ocultação automática.

CMFCVisualManager::OnFillBarContexto

A estrutura chama este método quando preenche o fundo de um objeto CBasePane .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo para uma barra de controlo.

pBar
[dentro] Um indicador para um CBasePane objeto. A estrutura preenche o pano de fundo deste painel.

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

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

bNCArea
[dentro] Um valor reservado.

Observações

A implementação padrão deste método preenche o fundo da barra com a cor de fundo 3D da variável afxGlobalDataglobal . Substitua este método num gestor visual derivado para personalizar o fundo de um painel.

Example

O exemplo seguinte demonstra como usar o OnFillBarBackground na CMFCVisualManager aula. Este excerto 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 framework chama este método quando preenche o fundo de um botão da barra de ferramentas.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo de um botão da barra de ferramentas.

pButton
[dentro] Um apontador para um CMFCToolBarButton. A estrutura preenche o fundo deste botão.

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

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

Observações

A implementação padrão deste método usa a cor padrão para preencher o fundo. Substitua este método num gestor visual derivado para personalizar o fundo de um botão da barra de ferramentas.

Os possíveis estados 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

[dentro] pDC
[dentro] pBar
[dentro] Rect
[dentro] bIsPressed
[dentro] bIsHighlighted
[dentro] bIsDisabled
[dentro] bHasDropDownArrow
[dentro] bIsSysButton

Valor de retorno

Observações

CMFCVisualManager::OnFillCommandsListBackground

O framework chama este método quando preenche o fundo de um botão da barra de ferramentas que pertence a uma lista de comandos. Esta lista de comandos faz parte do diálogo de personalização.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

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

Valor de retorno

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

Observações

Para mais informações sobre a lista de personalização, consulte CMFCToolBarButton::OnDrawOnCustomizeList. A implementação padrão deste método preenche o fundo com base no esquema de cores da skin atualmente selecionada.

CMFCVisualManager::OnFillHeaderCtrlBackground

O framework chama este método quando preenche o fundo de um controlo de cabeçalho.

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

Parâmetros

pCtrl
[dentro] Um apontador para um objeto CMFCHeaderCtrl . A estrutura preenche o fundo para este controlo de cabeçalho.

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do controlo do cabeçalho.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um controlo de cabeçalho.

CMFCVisualManager::OnFillMiniFrameCaption

A estrutura chama este método quando preenche a barra de legendas de uma janela de mini moldura.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

pFrameWnd
[dentro] Um apontador para uma janela em miniatura. A estrutura desenha a barra de legendas para esta janela.

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

Valor de retorno

A cor usada para preencher o fundo da barra de legendas.

Observações

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

CMFCVisualManager::OnFillOutlookBarCaption

O framework chama este método quando preenche o fundo de uma barra de legendas do Outlook.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

clrText
[fora] Uma referência a um parâmetro COLORREF . O método escreve a cor do texto na barra de legendas neste parâmetro.

Observações

A implementação padrão deste método preenche a barra de legendas com a cor das sombras com base na skin atual. Substitua este método num gestor visual derivado para personalizar a cor da barra de legendas do Outlook.

CMFCVisualManager::OnFillOutlookPageButtonT

A estrutura chama este 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
[dentro] Um apontador para o contexto de um dispositivo.

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

bIsHighlighted
[dentro] Um parâmetro booleano que especifica se o botão está destacado.

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

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

Observações

Substitua esta função num gestor visual derivado para personalizar a aparência dos botões da página do Outlook.

CMFCVisualManager::OnFillPopupWindowBackground

O framework chama este método quando preenche o fundo de uma janela pop-up.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência das janelas pop-up.

CMFCVisualManager::OnFillRibbonButton

A estrutura chama este método quando preenche o interior de um botão de fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um apontador para um objeto CMFCRibbonButton . A estrutura preenche o interior deste botão de fita.

Valor de retorno

A cor do texto para o botão de fita especificada por pButton se o botão de fita suportar texto. Um valor de -1 se o texto for inválido para o botão de fita.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência dos botões de fita.

CMFCVisualManager::OnFillRibbonEdit

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

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pEdit
[dentro] Um indicador para um CMFCRibbonRichEditCtrl objeto. A estrutura preenche o interior deste controlo de edição.

retângulo
[dentro] Um retângulo que especifica os limites do controlo de edição.

bIsHighlighted
[dentro] Um parâmetro booleano que indica se o controlo de edição está destacado.

bIsPaneDestacado
[dentro] Um parâmetro booleano que indica se o painel pai está destacado.

bIsDisabled
[dentro] Um parâmetro booleano que indica se o controlo de edição está indisponível.

clrText
[dentro] Uma referência à cor do texto do controlo de edição.

clrSelContexto
[dentro] Uma referência à cor de fundo do controlo de edição quando está destacado.

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

Observações

O CMFCRibbonRichEditCtrlindicado por pEdit pode ser parte de um botão de combo box na fita.

Substitua este método num gestor visual derivado para personalizar a aparência de um CMFCRibbonRichEditCtrl.

CMFCVisualManager::OnFillRibbonPanelMainPanelButton

A estrutura chama este método quando preenche o interior de um botão de fita localizado no painel principal .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pButton
[dentro] Um apontador para um objeto CMFCRibbonButton Class . A estrutura preenche este botão de fita.

Valor de retorno

A cor do texto para o botão de fita especificada por pButton se o botão de fita suportar texto. Um valor de -1 se o texto for inválido para o botão de fita.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência dos botões de fita no painel principal .

CMFCVisualGerente::OnFillRibbonMenuFrame

O framework chama este método quando preenche o quadro do menu do painel de fita.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pPanel
[dentro] Um apontador para uma instância da Classe CMFCRibbonMainPanel. A estrutura preenche a moldura do menu deste painel de fita.

retângulo
[dentro] Um retângulo que especifica os limites da moldura do menu.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da barra de menu para o CMFCRibbonMainPanel.

CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup

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

Parâmetros

[dentro] pDC
[dentro] pMenuBar
[dentro] Rect

Observações

CMFCVisualGerente::OnFillSplitterAntecedentes

A framework chama este método quando preenche o fundo de uma janela divisor.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pSplitterWnd
[dentro] Um apontador para uma instância da classe CSplitterWndEx. A estrutura preenche o fundo desta janela divisor.

retângulo
[dentro] Um retângulo que especifica os limites da janela divisor.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de uma janela divisor.

CMFCVisualManager::OnFillTab

O framework chama este método quando preenche o fundo de uma janela de separador.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectFill
[dentro] Um retângulo que especifica os limites da janela de separador.

pbrFill
[dentro] Um apontar para um pincel. A framework usa este pincel para preencher a janela do separador.

iTab
[dentro] O índice de tabulação baseado em zero de um separador para o qual a estrutura preenche o fundo.

bIsActive
[dentro] TRUE se o separador estiver ativo; caso contrário, FALSO.

pTabWnd
[dentro] Um apontador para o controlo do separador pai.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência dos separadores.

CMFCVisualManager::OnFillTasksGroupInterior

O framework chama este método quando preenche o interior de um objeto CMFCTasksPaneTaskGroup .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Um retângulo que especifica os limites do grupo de tarefa.

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um grupo de tarefa.

CMFCVisualManager::OnFillTasksPaneBackground

O framework chama este método quando preenche o fundo de um controlo CMFCTasksPane .

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectWorkArea
[dentro] Um retângulo que especifica os limites do painel de tarefa.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência de um CMFCTasksPane objeto.

CMFCVisualManager::OnHighlightMenuItem

A framework chama este método quando desenha um item destacado no menu.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto do dispositivo para um menu.

pButton
[dentro] Um apontador para um objeto CMFCToolBarMenuButton para exibir. A implementação padrão não utiliza este parâmetro.

retângulo
[dentro] Um retângulo que especifica os limites do item do menu.

clrText
[dentro] A cor atual do texto dos itens destacados do menu. A implementação padrão não utiliza este parâmetro.

Observações

A implementação padrão deste método não utiliza os parâmetros pButton ou clrText. Preenche o retângulo especificado por rect com a cor de fundo padrão.

Substitua este método num gestor visual derivado para personalizar a aparência dos itens destacados do menu. Use o parâmetro clrText para modificar a cor do texto de um item destacado no menu.

CMFCVisualGerente::EmDestaqueRaramenteUsadoMenuItens

O framework chama este método quando desenha um comando de menu destacado.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectRaramenteUsado
[dentro] Um retângulo que especifica os limites do comando destacado.

Observações

Substitua este método num gestor visual derivado para personalizar a aparência dos comandos de menu destacados.

CMFCVisualManager::OnNcActivate

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

Parâmetros

[dentro] pWnd
[dentro] bActive

Valor de retorno

Observações

CMFCVisualManager::OnNcPaint

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

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

Parâmetros

pWnd
[dentro] Um apontador para a janela cuja área não cliente é desenhada pela estrutura.

lstSysButtons
[dentro] Uma lista de botões do sistema. Estes também são conhecidos como botões de legenda.

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

Valor de retorno

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

Observações

Substitua este método num gestor visual derivado para personalizar a aparência da moldura da janela e dos botões de legenda.

CMFCVisualManager::OnSetWindowRegion

O framework chama este método depois de definir uma região que contém frames e menus pop-up.

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

Parâmetros

pWnd
[dentro] Um apontador para a janela com a região que mudou.

WindowTamanho
[dentro] O tamanho da janela.

Valor de retorno

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

Observações

O framework chama este método para notificar o gestor visual de que foi definida uma região para frames e menus pop-up. Para mais informações, consulte CWindow::SetWindowRgn.

CMFCVisualManager::OnUpdateSystemSystemColors

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

virtual void OnUpdateSystemColors();

Observações

O framework chama este método como parte do processamento da mensagem WM_SYSCOLORCHANGE. A implementação padrão não faz nada. Substitua este método num gestor visual derivado se quiser executar código personalizado quando as cores mudarem na sua aplicação.

CMFCVisualManager::RedrawAll

Imediatamente redesenha todas as barras de controlo na aplicação.

static void RedrawAll();

CMFCVisualManager::RibbonCategoryColorToRGB

virtual COLORREF RibbonCategoryColorToRGB(AFX_RibbonCategoryColor color);

Parâmetros

[dentro] Cor

Valor de retorno

Observações

CMFCVisualManager::SetDefaultManager

Define o gestor padrão.

static void SetDefaultManager(CRuntimeClass* pRTI);

Parâmetros

pRTI
[dentro] Um apontador para a informação de tempo de execução para um gestor visual.

Observações

Use a CMFCVisualManager classe e quaisquer gestores visuais derivados para personalizar a aparência da sua aplicação. Depois de definir o gestor visual predefinido, este método redesenha a sua aplicação usando o novo gestor visual. Para mais informações sobre como usar gestores visuais, consulte Gestor de Visualização.

Use este método para alterar o gestor visual que a sua aplicação utiliza.

CMFCVisualManager::SetEmbossDisabledImage

Ativa ou desativa o modo em relevo para imagens desativadas da barra de ferramentas.

void SetEmbossDisabledImage (BOOL bEmboss = TRUE);

Parâmetros

bEmboss
[dentro] Um parâmetro booleano que indica se deve ativar o modo em relevo para imagens desativadas da barra de ferramentas.

Observações

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

CMFCVisualManager::SetFadeInactiveImage

Ativa ou desativa o efeito de iluminação para imagens inativas num menu ou barra de ferramentas.

void SetFadeInactiveImage(BOOL bFade = TRUE);

Parâmetros

bFade
[dentro] Um parâmetro booleano que especifica se deve ativar o efeito de iluminação.

Observações

Esta funcionalidade controla se as imagens inativas aparecem desbotadas num menu ou barra de ferramentas. Use o método CMFCVisualManager::IsFadeInactiveImage para determinar se esta funcionalidade está ativada.

CMFCVisualManager::SetMenuFlatLook

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

void SetMenuFlatLook(BOOL bMenuFlatLook = TRUE);

Parâmetros

bMenuFlatLook
[dentro] Um parâmetro booleano que indica se os botões do menu aparecem planos.

Observações

Por defeito, esta funcionalidade não está ativada.

CMFCVisualManager::SetMenuShadowDepth

Define a largura e a altura da sombra do menu.

void SetMenuShadowDepth(int nDepth);

Parâmetros

nProfundidade
[dentro] Um inteiro que especifica a profundidade da sombra do menu em pixels.

Observações

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

CMFCVisualManager::SetShadowImageReallightedT

Define um flag que indica se o CMFCVisualManager mostra sombras para imagens destacadas.

void SetShadowHighlightedImage(BOOL bShadow = TRUE);

Parâmetros

bShadow
[dentro] Um parâmetro booleano que indica se o gestor visual apresenta uma sombra sob imagens destacadas.

Observações

Por defeito, esta funcionalidade está desativada.

Consulte também

Gráfico de Hierarquia
Classes
CMFCVisualManager::GetInstance
Gestor de Visualização

Comentários

Esta página foi útil?

Last updated on 2026-02-23

Partilhar via

CMFCVisualClasse Manager

Sintaxe

Membros

Construtores Públicos

Métodos Públicos

Observações

Exemplos

Hierarquia de herança

Requerimentos

CMFCVisualManager::AdjustFrames

Observações

CMFCVisualManager::AdjustToolbars

Observações

CMFCVisualManager::AlwaysHighlight3DTabs

Valor de retorno

Observações

CMFCVisualManager::CMFCVisualManager

Parâmetros

Observações

CMFCVisualManager::D estroyInstance

Parâmetros

Observações

CMFCVisualManager::D oDrawHeaderSortArrow

Parâmetros

Observações

CMFCVisualManager::D rawComboBorderWinXP

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::D rawComboDropButtonWinXP

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::D rawPushButtonWinXP

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::D rawTextOnGlass

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::EnableToolbarButtonFill

Parâmetros

Observações

CMFCVisualManager::GetAutoHideButtonTextColor

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::GetButtonExtraBorder

Valor de retorno

Observações

CMFCVisualManager::GetCaptionBarTextColor

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::GetCaptionButtonExtraBorder

Valor de retorno

Observações

CMFCVisualManager::GetDockingPaneCaptionExtraHeight

Valor de retorno

Observações

CMFCVisualManager::GetDockingTabsBordersSize

Valor de retorno

Observações

CMFCVisualManager::GetHighedMenuItemTextColor

Parâmetros

Valor de retorno

Observações

CMFCVisualManager::GetInstance

Valor de retorno

Observações

CMFCVisualManager::GetMDITabsBordersSize

Valor de retorno

Observações

CMFCVisualManager::GetMenuImageMargin

Valor de retorno

Observações

CMFCVisualManager::GetMenuItemTextColor

Parâmetros