Classe CMFCVisualManager
Dá suporte para alterar a aparência do aplicativo em um nível global. A classe CMFCVisualManager funciona em conjunto com uma classe que fornece instruções para desenhar os controles de GUI do aplicativo usando um estilo consistente. Essas outras classes são conhecidas como gerenciadores visuais e herdam de CMFCBaseVisualManager.
Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.
class CMFCVisualManager : public CMFCBaseVisualManager
| Nome | Descrição |
|---|---|
CMFCVisualManager::CMFCVisualManager |
Construtor padrão. |
| Nome | Descrição |
|---|---|
| CMFCVisualManager::AdjustFrames | |
| CMFCVisualManager::AdjustToolbars | |
| CMFCVisualManager::AlwaysHighlight3DTabs | Chamado pela estrutura para determinar se as guias 3D sempre deverão ser desenhadas usando uma cor de realce. |
| CMFCVisualManager::DestroyInstance | |
| CMFCVisualManager::DoDrawHeaderSortArrow | |
| CMFCVisualManager::DrawComboDropButtonWinXP | |
| CMFCVisualManager::DrawPushButtonWinXP | |
| CMFCVisualManager::DrawTextOnGlass | |
| CMFCVisualManager::GetAutoHideButtonTextColor | Chamado pela estrutura para recuperar a cor do texto de um botão de ocultamento automático. |
| CMFCVisualManager::GetButtonExtraBorder | Chamado pela estrutura para recuperar o tamanho aumentado do botão que o gerenciador visual atual exige para desenhar um botão. |
| CMFCVisualManager::GetCaptionBarTextColor | Chamado pela estrutura para recuperar a cor do texto de uma barra de legenda. |
| CMFCVisualManager::GetDockingTabsBordersSize | Chamado pela estrutura para recuperar o tamanho da borda de uma barra de encaixe com guia. |
| CMFCVisualManager::GetHighlightedMenuItemTextColor | |
| CMFCVisualManager::GetInstance | Retorna um ponteiro para o objeto CMFCVisualManager. |
| CMFCVisualManager::GetMDITabsBordersSize | Chamado pela estrutura para recuperar o tamanho da borda da janela MDITabs. |
| CMFCVisualManager::GetMenuItemTextColor | |
| CMFCVisualManager::GetMenuShadowDepth | Retorna um valor que determina a largura e a altura de uma sombra de menu. |
| CMFCVisualManager::GetNcBtnSize | Chamado pela estrutura para determinar o tamanho dos botões do sistema com base no gerenciador visual atual. Os botões do sistema são os botões na legenda do quadro principal que mapeiam para os comandos Fechar, Minimizar, Maximizar e Restaurar. |
| CMFCVisualManager::GetPopupMenuBorderSize | Chamado pela estrutura para recuperar o tamanho da borda de um menu pop-up. |
| CMFCVisualManager::GetPropertyGridGroupColor | Chamado pela estrutura para recuperar a cor da tela de fundo de uma lista de propriedades. |
| CMFCVisualManager::GetPropertyGridGroupTextColor | Chamado pela estrutura para recuperar a cor do texto de uma lista de propriedades. |
| CMFCVisualManager::GetRibbonHyperlinkTextColor | |
| CMFCVisualManager::GetRibbonPopupBorderSize | |
| CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor | |
| CMFCVisualManager::GetRibbonSliderColors | |
| CMFCVisualManager::GetShowAllMenuItemsHeight | |
| CMFCVisualManager::GetSmartDockingBaseGuideColors | |
| CMFCVisualManager::GetSmartDockingHighlightToneColor | |
| CMFCVisualManager::GetSmartDockingTheme | Retorna um tema usado para exibir os marcadores de encaixe inteligentes. |
| CMFCVisualManager::GetStatusBarPaneTextColor | |
| CMFCVisualManager::GetTabFrameColors | Chamado pela estrutura para recuperar o conjunto de cores a ser usado ao desenhar um quadro da guia. |
| CMFCVisualManager::GetTabTextColor | |
| CMFCVisualManager::GetToolbarButtonTextColor | Chamado pela estrutura para recuperar a cor atual do texto no botão da barra de ferramentas. Essa cor varia com base no gerenciador visual atual e no estado do botão. |
| CMFCVisualManager::GetToolbarDisabledTextColor | Chamado pela estrutura para determinar a cor do texto exibido nos elementos da barra de ferramentas desabilitados. |
| CMFCVisualManager::GetToolbarHighlightColor | |
| CMFCVisualManager::GetToolTipInfo | |
| CMFCVisualManager::HasOverlappedAutoHideButtons | Especifica se os botão de ocultamento automático se sobrepõem. |
| CMFCVisualManager::IsDockingTabHasBorder | Especifica se o gerenciador visual atual desenha uma borda ao redor das barras de encaixe com guias. |
| CMFCVisualManager::IsEmbossDisabledImage | Especifica se as imagens desabilitadas devem ser colocadas em alto-relevo. |
| CMFCVisualManager::IsFadeInactiveImage | Chamado pela estrutura para determinar se as imagens inativas em uma barra de ferramentas ou em um menu aparecerão esmaecidas. |
| CMFCVisualManager::IsMenuFlatLook | Especifica se os botões de menu têm uma aparência plana. |
| CMFCVisualManager::IsOfficeXPStyleMenus | Especifica se o gerenciador visual implementa menus do estilo do Office XP. |
| CMFCVisualManager::IsOwnerDrawCaption | Especifica se o gerenciador visual atual implementa legendas desenhadas do proprietário de uma janela do quadro. |
| CMFCVisualManager::IsShadowHighlightedImage | Especifica se uma imagem realçada tem uma sombra. |
| CMFCVisualManager::OnDrawAutoHideButtonBorder | Chamado pela estrutura quando desenha a borda de um botão de ocultamento automático. |
| CMFCVisualManager::OnDrawBarGripper | Chamado pela estrutura quando desenha a garra de uma barra de controle. O usuário deve clicar na garra para mover a barra de controle. |
| CMFCVisualManager::OnDrawBrowseButton | Chamado pela estrutura quando desenha um botão Procurar que pertence a um controle de edição ( classe CMFCEditBrowseCtrl). |
| CMFCVisualManager::OnDrawButtonBorder | Chamado pela estrutura quando desenha a borda de um botão da barra de ferramentas. |
| CMFCVisualManager::OnDrawButtonSeparator | |
| CMFCVisualManager::OnDrawCaptionBarBorder | Chamado pela estrutura quando desenha a borda da barra de legenda. |
| CMFCVisualManager::OnDrawCaptionBarButtonBorder | |
| CMFCVisualManager::OnDrawCaptionBarInfoArea | |
| CMFCVisualManager::OnDrawCaptionButton | Chamado pela estrutura quando desenha um botão de título. |
| CMFCVisualManager::OnDrawCheckBox | |
| CMFCVisualManager::OnDrawCheckBoxEx | |
| CMFCVisualManager::OnDrawComboBorder | Chamado pela estrutura quando desenha a borda de um botão de caixa de combinação. |
| CMFCVisualManager::OnDrawComboDropButton | Chamado pela estrutura quando desenha um botão soltar da caixa de combinação. |
| CMFCVisualManager::OnDrawControlBorder | |
| CMFCVisualManager::OnDrawDefaultRibbonImage | Chamado pela estrutura quando desenha a imagem da faixa de opções padrão. |
| CMFCVisualManager::OnDrawEditBorder | Chamado pela estrutura quando desenha uma borda ao redor de um objeto CMFCToolBarEditBoxButton. |
| CMFCVisualManager::OnDrawExpandingBox | |
| CMFCVisualManager::OnDrawFloatingToolbarBorder | Chamado pela estrutura quando desenha as bordas de uma barra de ferramentas flutuante. A barra de ferramentas flutuante é uma barra de ferramentas que aparece como uma janela com minimoldura. |
| CMFCVisualManager::OnDrawHeaderCtrlBorder | Chamado pela estrutura quando desenha a borda que contém o controle de cabeçalho. |
| CMFCVisualManager::OnDrawHeaderCtrlSortArrow | Chamado pela estrutura quando desenha a seta de classificação de controle de cabeçalho. |
| CMFCVisualManager::OnDrawMenuArrowOnCustomizeList | |
| CMFCVisualManager::OnDrawMenuBorder | Chamado pela estrutura quando desenha uma borda de menu. |
| CMFCVisualManager::OnDrawMenuCheck | |
| CMFCVisualManager::OnDrawMenuItemButton | |
| CMFCVisualManager::OnDrawMenuLabel | |
| CMFCVisualManager::OnDrawMenuResizeBar | |
| CMFCVisualManager::OnDrawMenuScrollButton | Chamado pela estrutura quando desenha um botão de rolagem de menu. |
| CMFCVisualManager::OnDrawMenuShadow | |
| CMFCVisualManager::OnDrawMenuSystemButton | Chamado pela estrutura quando desenha os botões do sistema de menus Fechar, Minimizar, Maximizar e Restaurar. |
| CMFCVisualManager::OnDrawMiniFrameBorder | |
| CMFCVisualManager::OnDrawOutlookBarSplitter | Chamado pela estrutura quando desenha o divisor para uma barra do Outlook. O divisor é uma barra horizontal usada para agrupar controles. |
| CMFCVisualManager::OnDrawOutlookPageButtonBorder | Chamado pela estrutura quando desenha a borda de um botão de página do Outlook. Os botões de página do Outlook aparecerão se o painel de barra do Outlook contiver mais botões do que pode exibir. |
| CMFCVisualManager::OnDrawPaneBorder | Chamado pela estrutura quando desenha a borda de uma Classe CPane. |
| CMFCVisualManager::OnDrawPaneCaption | Chamado pela estrutura quando desenha a legenda de um CPane. |
| CMFCVisualManager::OnDrawPaneDivider | |
| CMFCVisualManager::OnDrawPopupWindowBorder | |
| CMFCVisualManager::OnDrawPopupWindowButtonBorder | |
| CMFCVisualManager::OnDrawPopupWindowCaption | |
| CMFCVisualManager::OnDrawRibbonApplicationButton | Chamado pela estrutura quando desenha o Botão Principal na faixa de opções. |
| CMFCVisualManager::OnDrawRibbonButtonBorder | Chamado pela estrutura quando desenha a borda de um botão da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonButtonsGroup | Chamado pela estrutura quando desenha um grupo de botões na faixa de opções. |
| CMFCVisualManager::OnDrawRibbonCaption | Chamado pela estrutura quando desenha a legenda do quadro principal, mas somente se a barra da faixa de opções estiver integrada ao quadro. |
| CMFCVisualManager::OnDrawRibbonCaptionButton | Chamado pela estrutura quando desenha um botão de título localizado na barra da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonCategory | Chamado pela estrutura quando desenha uma categoria da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonCategoryCaption | Chamado pela estrutura quando desenha a legenda para uma categoria da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonCategoryScroll | |
| CMFCVisualManager::OnDrawRibbonCategoryTab | Chamado pela estrutura quando desenha a guia para uma categoria da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonCheckBoxOnList | |
| CMFCVisualManager::OnDrawRibbonColorPaletteBox | |
| CMFCVisualManager::OnDrawRibbonDefaultPaneButtonContext | |
| CMFCVisualManager::OnDrawRibbonDefaultPaneButton | Chamado pela estrutura quando desenha o botão padrão da faixa de opções. O botão padrão aparece quando o usuário reduz um painel da faixa de opções para que fique demasiado pequeno para exibir os elementos da faixa de opções. O botão padrão é desenhado e os elementos da faixa de opções são adicionados como itens em um menu suspenso. |
| CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator | |
| CMFCVisualManager::OnDrawRibbonGalleryBorder | |
| CMFCVisualManager::OnDrawRibbonGalleryButton | |
| CMFCVisualManager::OnDrawRibbonKeyTip | |
| CMFCVisualManager::OnDrawRibbonLabel | Chamado pela estrutura quando desenha o rótulo da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder | Chamado pela estrutura quando desenha a borda de um botão da faixa de opções que está posicionado no painel Principal. O painel Principal é o painel que aparece quando um usuário clica no Botão Principal. |
| CMFCVisualManager::OnDrawRibbonMainPanelFrame | Chamado pela estrutura quando desenha o quadro ao redor do painel Principal . |
| CMFCVisualManager::OnDrawRibbonMenuCheckFrame | |
| CMFCVisualManager::OnDrawRibbonPanel | Chamado pela estrutura quando desenha um painel da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonPanelCaption | Chamado pela estrutura quando desenha a legenda de um painel da faixa de opções. |
| CMFCVisualManager::OnDrawRibbonProgressBar | Chamado pela estrutura quando desenha um objeto CMFCRibbonProgressBar. |
| CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator | Chamado pela estrutura quando desenha um separador na Barra de Ferramentas de Acesso Rápido de uma faixa de opções. |
| CMFCVisualManager::OnDrawRibbonRecentFilesFrame | Chamado pela estrutura quando desenha um quadro ao redor de uma lista de arquivos recentes. |
| CMFCVisualManager::OnDrawRibbonSliderChannel | Chamado pela estrutura quando desenha o canal de um objeto CMFCRibbonSlider. |
| CMFCVisualManager::OnDrawRibbonSliderThumb | Chamado pela estrutura quando desenha a miniatura de um objeto CMFCRibbonSlider. |
| CMFCVisualManager::OnDrawRibbonSliderZoomButton | Chamado pela estrutura quando desenha os botões de zoom de um objeto CMFCRibbonSlider. |
| CMFCVisualManager::OnDrawRibbonStatusBarPane | Chamado pela estrutura quando desenha o painel da barra de status de uma faixa de opções. |
| CMFCVisualManager::OnDrawRibbonTabsFrame | Chamado pela estrutura quando desenha uma moldura ao redor de um conjunto de guias de faixa de opções. |
| CMFCVisualManager::OnDrawScrollButtons | |
| CMFCVisualManager::OnDrawSeparator | Chamado pela estrutura quando desenha um separador. O separador é normalmente usado em uma barra de controle para separar os grupos de ícones. |
| CMFCVisualManager::OnDrawShowAllMenuItems | |
| CMFCVisualManager::OnDrawSpinButtons | Chamado pela estrutura quando desenha botões de rotação. |
| CMFCVisualManager::OnDrawSplitterBorder | Chamado pelo framework quando desenha a borda de uma janela dividida. |
| CMFCVisualManager::OnDrawSplitterBox | Chamado pela estrutura quando desenha a caixa de arrastar do divisor para uma janela dividida. |
| CMFCVisualManager::OnDrawStatusBarPaneBorder | Chamado pela estrutura quando desenha a borda de um painel da barra de status. |
| CMFCVisualManager::OnDrawStatusBarProgress | Chamado pela estrutura quando desenha o indicador de progresso da barra de status. |
| CMFCVisualManager::OnDrawStatusBarSizeBox | Chamado pela estrutura quando desenha a caixa de tamanho da barra de status. |
| CMFCVisualManager::OnDrawTab | Chamado pela estrutura quando desenha um objeto CMFCTabCtrl. |
| CMFCVisualManager::OnDrawTabCloseButton | Chamado pela estrutura quando desenha o botão Fechar na guia ativa. |
| CMFCVisualManager::OnDrawTabContent | Chamado pela estrutura quando desenha o interior da guia (imagens, textos). |
| CMFCVisualManager::OnDrawTabsButtonBorder | Chamado pela estrutura quando desenha a borda de um botão da guia. |
| CMFCVisualManager::OnDrawTask | Chamado pela estrutura quando desenha uma tarefa no painel de tarefas. |
| CMFCVisualManager::OnDrawTasksGroupAreaBorder | Chamado pela estrutura quando desenha uma borda ao redor de uma área de grupo no painel de tarefas. |
| CMFCVisualManager::OnDrawTasksGroupCaption | Chamado pela estrutura quando desenha a legenda de um grupo de tarefas no painel de tarefas. |
| CMFCVisualManager::OnDrawTasksGroupIcon | |
| CMFCVisualManager::OnDrawTearOffCaption | Chamado pela estrutura quando desenha a legenda destacável para uma barra destacável. |
| CMFCVisualManager::OnDrawToolBoxFrame | |
| CMFCVisualManager::OnEraseMDIClientArea | Chamado pelo framework quando ele apaga a área do cliente MDI. |
| CMFCVisualManager::OnErasePopupWindowButton | |
| CMFCVisualManager::OnEraseTabsArea | Chamado pela estrutura quando apaga a área da guia em uma janela com guias. |
| CMFCVisualManager::OnEraseTabsButton | Chamado pela estrutura quando apaga o ícone e o texto de um botão da guia. |
| CMFCVisualManager::OnEraseTabsFrame | Chamado pela estrutura quando apaga um quadro da guia. |
| CMFCVisualManager::OnFillAutoHideButtonBackground | Chamado pela estrutura quando preenche a tela de fundo de um botão de ocultamento automático. |
| CMFCVisualManager::OnFillBarBackground | Chamado pela estrutura quando preenche a tela de fundo de uma barra de controle. |
| CMFCVisualManager::OnFillButtonInterior | Chamado pela estrutura quando preenche a tela de fundo de um botão da barra de ferramentas. |
| CMFCVisualManager::OnFillCaptionBarButton | |
| CMFCVisualManager::OnFillCommandsListBackground | Chamado pela estrutura quando preenche a tela de fundo de um botão da barra de ferramentas que pertence a uma lista de comandos que, por sua vez, faz parte de uma caixa de diálogo de personalização. |
| CMFCVisualManager::OnFillHeaderCtrlBackground | Chamado pela estrutura quando preenche a tela de fundo de um controle de cabeçalho. |
| CMFCVisualManager::OnFillMiniFrameCaption | Chamado pela estrutura quando preenche a legenda de uma janela com minimoldura. |
| CMFCVisualManager::OnFillOutlookBarCaption | Chamado pela estrutura quando preenche a tela de fundo de uma legenda da barra do Outlook. |
| CMFCVisualManager::OnFillOutlookPageButton | Chamado pela estrutura quando preenche o interior de um botão de página do Outlook. |
| CMFCVisualManager::OnFillPopupWindowBackground | Chamado pela estrutura quando preenche a tela de fundo de uma janela pop-up. |
| CMFCVisualManager::OnFillRibbonButton | Chamado pela estrutura quando preenche o interior de um botão da faixa de opções. |
| CMFCVisualManager::OnFillRibbonEdit | Chamado pela estrutura quando preenche o interior de um controle de edição da faixa de opções. |
| CMFCVisualManager::OnFillRibbonMainPanelButton | Chamado pela estrutura quando preenche o interior de um botão da faixa de opções localizado no painel Principal. |
| CMFCVisualManager::OnFillRibbonMenuFrame | Chamado pela estrutura quando preenche o quadro de menu principal do painel da faixa de opções. |
| CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup | |
| CMFCVisualManager::OnFillSplitterBackground | Chamado pela estrutura quando preenche a tela de fundo de uma janela dividida. |
| CMFCVisualManager::OnFillTab | Chamado pela estrutura quando preenche a tela de fundo de uma guia. |
| CMFCVisualManager::OnFillTasksGroupInterior | Chamado pela estrutura quando preenche o interior de um objeto CMFCTasksPaneTaskGroup no CMFCTasksPane. |
| CMFCVisualManager::OnFillTasksPaneBackground | Chamado pela estrutura quando preenche a tela de fundo de um controle CMFCTasksPane. |
| CMFCVisualManager::OnHighlightMenuItem | Chamado pela estrutura quando desenha um item de menu realçado. |
| CMFCVisualManager::OnHighlightRarelyUsedMenuItems | Chamado pela estrutura quando desenha um item de menu realçado e raramente usado. |
| CMFCVisualManager::OnNcPaint | Chamado pela estrutura quando desenha a área de não cliente. |
| CMFCVisualManager::OnSetWindowRegion | Chamado pela estrutura quando define uma região que contém quadros e menus pop-up. |
| CMFCVisualManager::OnUpdateSystemColors | Chamado pela estrutura quando altera a configuração de cor do sistema. |
| CMFCVisualManager::RedrawAll | Redesenha todas as barras de controle no aplicativo. |
| CMFCVisualManager::RibbonCategoryColorToRGB | |
| CMFCVisualManager::SetDefaultManager | Define o gerenciador visual padrão. |
| CMFCVisualManager::SetEmbossDisabledImage | Habilita ou desabilita o modo colocado em alto-relevo para imagens da barra de ferramentas desabilitadas. |
| CMFCVisualManager::SetFadeInactiveImage | Habilita ou desabilita o efeito de iluminação para imagens inativas em um menu ou uma barra de ferramentas. |
| CMFCVisualManager::SetMenuFlatLook | Define um sinalizador indicando se os botões de menu do aplicativo têm uma aparência plana. |
| CMFCVisualManager::SetMenuShadowDepth | Define a largura e a altura da sombra do menu. |
| CMFCVisualManager::SetShadowHighlightedImage | Define um sinalizador que indica se a sombra deverá ser exibida ao renderizar as imagens realçadas. |
Como a classe CMFCVisualManager controla a GUI do aplicativo, cada aplicativo poderá ter uma instância de CMFCVisualManager ou uma instância de uma classe derivada de CMFCVisualManager. O aplicativo também poderá funcionar sem um CMFCVisualManager. Use o método estático GetInstance para obter um ponteiro para o objeto derivado do CMFCVisualManager atual.
Para alterar a aparência do aplicativo, será necessário usar outras classes que forneçam métodos para desenhar todos os elementos visuais do aplicativo. Alguns exemplos dessas classes são a classe CMFCVisualManagerOfficeXP, a classe CMFCVisualManagerOffice2003 e a classe CMFCVisualManagerOffice2007. Quando você quiser alterar a aparência do aplicativo, passe um desses gerenciadores visuais para o método SetDefaultManager. Para obter um exemplo que demonstra como o aplicativo poderá simular a aparência do Microsoft Office 2003, consulte classe CMFCVisualManagerOffice2003.
Todos os métodos de desenho são virtuais. Isso permite criar um estilo visual personalizado para a GUI do aplicativo. Se você quiser criar seu próprio estilo visual, derive uma classe de uma das classes do gerenciador visual e substitua os métodos de desenho que deseja alterar.
Este exemplo demonstra como instanciar os objetos CMFCVisualManager padrão e personalizados.
void CMFCSkinsApp::SetSkin (int iIndex)
{ // destroy the current visual manager
if (CMFCVisualManager::GetInstance () != NULL)
{
delete CMFCVisualManager::GetInstance ();
}
switch (iIndex)
{
case 0:
CMFCVisualManager::GetInstance ();
// create the standard visual manager
break;
case 1:
new CMyVisualManager ();
// create the first custom visual manager
break;
case 2:
new CMacStyle ();
// create the second custom visual manager
break;
}
// access the manager and set it properly
CMFCVisualManager::GetInstance ()->SetLook2000 ();
CMFCVisualManager::GetInstance ()->RedrawAll ();
}
O exemplo a seguir demonstra como recuperar os valores padrão de um objeto CMFCVisualManager. Este snippet de código faz parte do exemplo do Painel de Tarefas.
int m_nVMargin;
int m_nHMargin;
int m_nGroupSpacing;
int m_nTaskSpacing;
int m_nCaptionHeight;
int m_nTaskOffset;
int m_nIconOffset;
CMFCVisualManager
Cabeçalho: afxvisualmanager.h
static void __stdcall AdjustFrames();
static void __stdcall AdjustToolbars();
A estrutura chama esse método para determinar se as guias 3D sempre devem ser realçadas no aplicativo.
virtual BOOL AlwaysHighlight3DTabs() const;
TRUE se as guias 3D deverão ser realçadas.
Substitua essa função em um gerenciador visual derivado e retorne TRUE se as guias 3D sempre deverão ser realçadas. A implementação padrão desse método retorna FALSE.
CMFCVisualManager(BOOL bTemporary = FALSE);
[in] bTemporary
static void __stdcall DestroyInstance(BOOL bAutoDestroyOnly = FALSE);
[in] bAutoDestroyOnly
void DoDrawHeaderSortArrow(
CDC* pDC,
CRect rect,
BOOL bIsUp,
BOOL bDlgCtrl);
[in] pDC
[in] rect
[in] bIsUp
[in] bDlgCtrl
virtual BOOL DrawComboBorderWinXP(CDC*,
CRect,
BOOL,
BOOL,
BOOL);
[in] CDC*
[in] CRect
[in] BOOL
virtual BOOL DrawComboDropButtonWinXP(CDC*,
CRect,
BOOL,
BOOL,
BOOL);
[in] CDC*
[in] CRect
[in] BOOL
virtual BOOL DrawPushButtonWinXP(CDC*,
CRect,
CMFCButton*,
UINT);
[in] CDC*
[in] CRect
[in] CMFCButton*
[in] UINT
virtual BOOL DrawTextOnGlass(
CDC* pDC,
CString strText,
CRect rect,
DWORD dwFlags,
int nGlowSize = 0,
COLORREF clrText = (COLORREF)-1);
[in] pDC
[in] strText
[in] rect
[in] dwFlags
[in] nGlowSize
[in] clrText
void EnableToolbarButtonFill(BOOL bEnable = TRUE);
[in] bEnable
A estrutura chama esse método para recuperar a cor do texto de um botão de ocultamento automático.
virtual COLORREF GetAutoHideButtonTextColor(CMFCAutoHideButton* pButton);
pButton
[in] Um ponteiro para um botão de ocultamento automático.
Um parâmetro COLORREF que especifica a cor do texto de pButton.
Substitua esse método em uma classe derivada para personalizar a cor do texto de um botão de ocultamento automático no aplicativo. Para fazer isso, retorne a cor que você quer que o aplicativo use como a cor do texto.
A estrutura chama esse método quando desenha um botão da barra de ferramentas.
virtual CSize GetButtonExtraBorder() const;
Um objeto CSize que contém o tamanho adicional da borda dos botões da barra de ferramentas.
Algumas capas precisam estender as bordas dos botões da barra de ferramentas. Substitua esse método em um gerenciador visual personalizado para estender as bordas dos botões da barra de ferramentas no aplicativo. A implementação padrão desse método retorna um tamanho vazio.
A estrutura chama esse método para recuperar a cor do texto na barra de legenda.
virtual COLORREF GetCaptionBarTextColor(CMFCCaptionBar* pBar);
pBar
[in] Um ponteiro para uma barra de legenda.
Um parâmetro COLORREF que indica a cor do texto em pBar.
Substitua esse método na classe derivada para personalizar a cor do texto de uma barra de legenda. No método substituído, retorne a cor desejada.
virtual CSize GetCaptionButtonExtraBorder() const;
virtual int GetDockingPaneCaptionExtraHeight() const;
A estrutura chama esse método quando desenha um painel encaixado e com guias.
virtual int GetDockingTabsBordersSize();
Um inteiro que indica o tamanho da borda de um painel encaixado e com guias.
Um painel encaixado se torna com guias quando o usuário encaixa vários painéis no mesmo local no aplicativo.
Substitua esse método em um gerenciador visual personalizado para alterar o tamanho da borda das barras de controle com guias encaixadas. A implementação padrão retorna -1.
virtual COLORREF GetHighlightedMenuItemTextColor(CMFCToolBarMenuButton* pButton);
[in] pButton
Retorna um ponteiro para o objeto classe CMFCVisualManager atual para o aplicativo.
static CMFCVisualManager* GetInstance();
Um ponteiro para um objeto CMFCVisualManager.
Um aplicativo poderá ter apenas um objeto CMFCVisualManager associado a ele. Isso inclui os objetos derivados da classe CMFCVisualManager. Esse método retorna um ponteiro para o objeto associado CMFCVisualManager. Se o aplicativo não tiver um objeto CMFCVisualManager associado, esse método criará um e o associará ao aplicativo.
A estrutura chama esse método para determinar o tamanho da borda de uma janela MDITabs antes de desenhar a janela.
virtual int GetMDITabsBordersSize();
O tamanho da borda da janela MDITabs.
Substitua essa função em uma classe derivada para personalizar o tamanho da borda da janela MDITabs.
virtual int GetMenuImageMargin() const;
virtual COLORREF GetMenuItemTextColor(
CMFCToolBarMenuButton* pButton,
BOOL bHighlighted,
BOOL bDisabled);
[in] pButton
[in] bHighlighted
[in] bDisabled
Recupera a largura e a altura da sombra do menu.
int GetMenuShadowDepth() const;
A largura e a altura da sombra do menu em pixels.
A largura e a altura da sombra do menu são equivalentes. O valor padrão é 7 pixels.
Chamado pela estrutura quando é necessário recuperar o tamanho dos botões do sistema.
virtual CSize GetNcBtnSize(BOOL bSmall) const;
bSmall
[in] Um parâmetro booliano que indicará se GetNcBtnSize deverá recuperar o tamanho de um botão de sistema pequeno ou grande. Se bSmall for TRUE, GetNcBtnSize retornará o tamanho de um pequeno botão do sistema. Caso contrário, retornará o tamanho de um botão de sistema grande.
Um parâmetro CSize que indica o tamanho dos botões do sistema.
Os botões do sistema são os botões na legenda da janela do quadro que mapeiam para os comandos Fechar, Minimizar, Maximizar e Restaurar. O tamanho desses botões depende do gerenciador visual atual. Substitua esse método se quiser personalizar o tamanho dos botões do sistema no aplicativo.
A estrutura chama esse método para obter o tamanho da borda dos menus pop-up.
virtual int GetPopupMenuBorderSize() const;
Um inteiro que especifica o tamanho da borda dos menus pop-up.
Substitua esse método para personalizar o tamanho da borda dos menus pop-up no aplicativo.
virtual int GetPopupMenuGap() const;
A estrutura chama esse método para obter a cor da tela de fundo de uma lista de propriedades.
virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);
pPropList
[in] Um ponteiro para a lista de propriedades que a estrutura está desenhando.
Um parâmetro COLORREF que indica a cor da tela de fundo de pPropList.
Substitua essa função para personalizar a cor da tela de fundo de uma lista de propriedades no aplicativo.
A estrutura chama esse método para recuperar a cor do texto de uma lista de propriedades.
virtual COLORREF GetPropertyGridGroupTextColor(CMFCPropertyGridCtrl* pPropList);
pPropList
[in] Um ponteiro para a lista de propriedades.
Um parâmetro COLORREF que indica a cor do texto da lista de propriedades.
Substitua essa função para personalizar a cor do texto de uma lista de propriedades no aplicativo.
virtual COLORREF GetRibbonHyperlinkTextColor(CMFCRibbonLinkCtrl* pHyperLink);
[in] pHyperLink
virtual int GetRibbonPopupBorderSize(const CMFCRibbonPanelMenu*) const;
[in] CMFCRibbonPanelMenu*
virtual int GetRibbonQuickAccessToolBarChevronOffset();
virtual int GetRibbonQuickAccessToolBarRightMargin();
virtual COLORREF GetRibbonQuickAccessToolBarTextColor(BOOL bDisabled = FALSE);
[in] bDisabled
virtual void GetRibbonSliderColors(
CMFCRibbonSlider* pSlider,
BOOL bIsHighlighted,
BOOL bIsPressed,
BOOL bIsDisabled,
COLORREF& clrLine,
COLORREF& clrFill);
[in] pSlider
[in] bIsHighlighted
[in] bIsPressed
[in] bIsDisabled
[in] clrLine
[in] clrFill
virtual COLORREF GetRibbonStatusBarTextColor(CMFCRibbonStatusBar* pStatusBar);
[in] pStatusBar
virtual int GetShowAllMenuItemsHeight(
CDC* pDC,
const CSize& sizeDefault);
[in] pDC
[in] sizeDefault
virtual void GetSmartDockingBaseGuideColors(
COLORREF& clrBaseGroupBackground,
COLORREF& clrBaseGroupBorder);
[in] clrBaseGroupBackground
[in] clrBaseGroupBorder
virtual COLORREF GetSmartDockingHighlightToneColor();
Retorna um tema usado para exibir os marcadores de encaixe inteligentes.
virtual AFX_SMARTDOCK_THEME GetSmartDockingTheme();
Retorna um dos seguintes valores enumerados: AFX_SDT_DEFAULT, AFX_SDT_VS2005 AFX_SDT_VS2008.
virtual COLORREF GetStatusBarPaneTextColor(
CMFCStatusBar* pStatusBar,
CMFCStatusBarPaneInfo* pPane);
[in] pStatusBar
[in] pPane
A estrutura chama essa função quando precisa recuperar o conjunto de cores para desenhar uma janela de guia.
virtual void GetTabFrameColors(
const CMFCBaseTabCtrl* pTabWnd,
COLORREF& clrDark,
COLORREF& clrBlack,
COLORREF& clrHighlight,
COLORREF& clrFace,
COLORREF& clrDarkShadow,
COLORREF& clrLight,
CBrush*& pbrFace,
CBrush*& pbrBlack);
pTabWnd
[in] Um ponteiro para a janela com guias em que o quadro está desenhando uma guia.
clrDark
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da borda escura de uma guia.
clrBlack
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da borda da janela com guias. A cor padrão da borda é preta.
clrHighlight
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor para o estado de realce da janela com guias.
clrFace
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da face da janela com guias.
clrDarkShadow
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor da sombra da janela com guias.
clrLight
[out] Uma referência a um parâmetro COLORREF em que esse método armazena a cor para a borda clara da janela com guias.
pbrFace
[out] Um ponteiro para uma referência para um pincel. Esse método armazena o pincel que utiliza para preencher a face da janela com guias nesse parâmetro.
pbrBlack
[out] Um ponteiro para uma referência para um pincel. Esse método armazena o pincel usado para preencher a borda preta da janela com guias nesse parâmetro.
Substitua essa função em uma classe derivada se quiser personalizar o conjunto de cores que a estrutura usa ao desenhar uma janela com guias.
virtual int GetTabHorzMargin(const CMFCBaseTabCtrl*);
[in] CMFCBaseTabCtrl*
virtual COLORREF GetTabTextColor(
const CMFCBaseTabCtrl*,
int,
BOOL);
[in] CMFCBaseTabCtrl*
[in] int
[in] BOOL
int GetTasksPaneGroupCaptionHeight() const;
int GetTasksPaneGroupCaptionHorzOffset() const;
int GetTasksPaneGroupCaptionVertOffset() const;
int GetTasksPaneGroupVertOffset() const;
int GetTasksPaneHorzMargin() const;
int GetTasksPaneIconHorzOffset() const;
int GetTasksPaneIconVertOffset() const;
int GetTasksPaneTaskHorzOffset() const;
int GetTasksPaneVertMargin() const;
A estrutura chama esse método para determinar a cor do texto de um botão da barra de ferramentas.
virtual COLORREF GetToolbarButtonTextColor(
CMFCToolBarButton* pButton,
CMFCVisualManager::AFX_BUTTON_STATE state);
pButton
[in] Um ponteiro para o botão da barra de ferramentas.
state
[in] O estado do botão da barra de ferramentas.
A cor do texto de pButton quando tem o estado indicado por estado.
A cor do texto de um objeto classe CMFCToolBarButton depende do estado do botão. Os estados possíveis de um botão de barra de ferramentas são ButtonsIsRegular, ButtonsIsPressed ou ButtonsIsHighlighted.
Substitua essa função para personalizar a cor do texto de um botão da barra de ferramentas no aplicativo.
virtual int GetToolBarCustomizeButtonMargin() const;
virtual COLORREF GetToolbarDisabledColor() const;
A estrutura chama essa função para determinar a cor do texto dos botões da barra de ferramentas que não estão disponíveis.
virtual COLORREF GetToolbarDisabledTextColor();
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.
Substitua esse método em um gerenciador visual personalizado para definir a cor do texto dos botões da barra de ferramentas que não estão disponíveis.
virtual COLORREF GetToolbarHighlightColor();
virtual BOOL GetToolTipInfo(
CMFCToolTipInfo& params,
UINT nType = (UINT)(-1));
[in] params
[in] nType
Retornará se os botões de ocultamento automático se sobrepõem no gerenciador visual atual.
virtual BOOL HasOverlappedAutoHideButtons() const;
TRUE se os botões de ocultação automática se sobrepõem, caso contrário, FALSE.
BOOL IsAutoDestroy() const;
virtual BOOL IsDefaultWinXPPopupButton(CMFCDesktopAlertWndButton*) const;
[in] CMFCDesktopAlertWndButton*
Retorna se o gerenciador visual atual desenha bordas em torno de painéis encaixados e com guias.
virtual BOOL IsDockingTabHasBorder();
TRUE se o gerenciador visual desenhar bordas ao redor de painéis encaixados e com guias, caso contrário, será FALSE.
Os painéis encaixados se tornam com guias quando vários painéis são encaixados no mesmo local.
Especifica se a estrutura incorpora imagens que não estão disponíveis.
BOOL IsEmbossDisabledImage() const;
Diferente de zero se a estrutura gravar imagens que não estão disponíveis, caso contrário, 0.
Este método é chamado por CMFCToolBarImages::Draw quando desenha uma imagem na barra de ferramentas que não está disponível.
A estrutura chama esse método quando desenha imagens inativas na barra de ferramentas ou em um menu.
BOOL IsFadeInactiveImage() const;
Diferente de zero se a estrutura usar o efeito de iluminação quando desenhar imagens inativas na barra de ferramentas ou em um menu, caso contrário, 0.
É possível ativar ou desativar o efeito de iluminação chamando CMFCVisualManager::SetFadeInactiveImage. O efeito de iluminação é o que faz as imagens indisponíveis aparecerem esmaecidas.
BOOL IsFrameMenuCheckedItems() const;
virtual BOOL IsHighlightOneNoteTabs() const;
virtual BOOL IsHighlightWholeMenuItem();
virtual BOOL IsLayeredRibbonKeyTip() const;
Indica se os botões do menu aparecem planos.
BOOL IsMenuFlatLook() const;
Diferente de zero se os botões do menu aparecerem planos, caso contrário, 0.
Por padrão, os botões de menu não aparecem planos. Use o método CMFCVisualManager::SetMenuFlatLook para alterar esse comportamento. Quando os botões de menu aparecem simples, eles não alteram a aparência quando o usuário clica neles.
Indica se o gerenciador visual implementa menus no estilo do Office XP.
virtual BOOL IsOfficeXPStyleMenus() const;
Diferente de zero se o gerenciador visual exibir menus no estilo do Office XP, caso contrário, 0.
A classe CMFCPopupMenu chama esse método quando precisa desenhar o menu e a sombra. Por padrão, esse método retorna FALSE. Se quiser usar menus pop-up semelhantes aos menus pop-up do Office XP, substitua esse método em um gerenciador visual personalizado e retorne TRUE.
virtual BOOL IsOffsetPressedButton() const;
Indica se o gerenciador visual atual implementa legendas desenhadas pelo proprietário.
virtual BOOL IsOwnerDrawCaption();
TRUE se todas as janelas do quadro no aplicativo tiverem legendas desenhadas pelo proprietário, caso contrário, será FALSE.
virtual BOOL IsOwnerDrawMenuCheck();
Indica se o gerenciador visual exibe sombras ao renderizar as imagens realçadas.
BOOL IsShadowHighlightedImage() const;
Diferente de zero quando o gerenciador visual exibe sombras em imagens destacadas, caso contrário, 0.
BOOL IsToolbarButtonFillEnabled() const;
virtual BOOL IsToolbarRoundShape(CMFCToolBar*);
[in] CMFCToolBar*
virtual BOOL IsWindowsThemingSupported() const;
virtual void OnActivateApp(
CWnd* pWnd,
BOOL bActive);
[in] pWnd
[in] bActive
A estrutura chama esse método quando desenha a borda de um botão de ocultamento automático.
virtual void OnDrawAutoHideButtonBorder(
CDC* pDC,
CRect rectBounds,
CRect rectBorderSize,
CMFCAutoHideButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectBounds
[in] O tamanho e o local do botão de ocultamento automático.
rectBorderSize
[in] Um parâmetro CRect que contém os tamanhos das bordas.
pButton
[in] Um ponteiro para o botão de ocultamento automático. A estrutura está desenhando a borda para este botão.
Substitua esse método em uma classe derivada se você quiser personalizar a aparência da borda de um botão de ocultamento automático. Por padrão, esse método preenche uma borda plana com a cor de sombra padrão para seu aplicativo.
O parâmetro rectBorderSize não contém as coordenadas da borda. Ele contém o tamanho da borda nos membros de dados top, bottom, left e right. Um valor menor ou igual a 0 não indica nenhuma borda nesse lado do botão de ocultamento automático.
Chamado pela estrutura quando desenha a garra de uma barra de controle.
virtual void OnDrawBarGripper(
CDC* pDC,
CRect rectGripper,
BOOL bHorz,
CBasePane* pBar);
pDC
[in] Um ponteiro para o contexto do dispositivo para uma barra de controle.
rectGripper
[in] O retângulo delimitador da barra de controle.
bHorz
[in] Um parâmetro booliano que especifica se a barra de controle está encaixada horizontal ou verticalmente.
pBar
[in] Um ponteiro para uma barra de controle. O gerenciador visual desenha a garra dessa barra de controle.
A implementação padrão desse método exibe a garra padrão. Para personalizar a aparência da garra, substitua esse método em uma classe personalizada derivada da classe CMFCVisualManager.
A estrutura chama esse método quando desenha o botão procurar para um controle de edição.
virtual BOOL OnDrawBrowseButton(
CDC* pDC,
CRect rect,
CMFCEditBrowseCtrl* pEdit,
CMFCVisualManager::AFX_BUTTON_STATE state,
COLORREF& clrText);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica o limite do botão Procurar.
pEdit
[in] Um ponteiro para um controle de edição. O gerenciador visual desenha o botão Procurar para esse controle de edição.
state
[in] Um valor enumerado que especifica o estado do botão.
clrTexto
[out] Uma referência a um parâmetro COLORREF. Esse é um valor reservado e não é atualmente.
TRUE se tiver êxito; caso contrário, FALSE.
Substitua essa função em uma classe derivada se quiser personalizar a aparência dos botões Procurar em instâncias da classe CMFCEditBrowseCtrl. Os valores possíveis para o estado do botão são ButtonsIsRegular, ButtonsIsPressed e ButtonsIsHighlighted.
A estrutura chama esse método quando desenha a borda de um botão de barra de ferramentas.
virtual void OnDrawButtonBorder(
CDC* pDC,
CMFCToolBarButton* pButton,
CRect rect,
CMFCVisualManager::AFX_BUTTON_STATE state);
pDC
[in] Um ponteiro para o contexto do dispositivo de um botão de barra de ferramentas.
pButton
[in] Um ponteiro para um botão de barra de ferramentas. A estrutura desenha a borda desse botão.
rect
[in] Um retângulo que especifica os limites do botão de barra de ferramentas.
state
[in] Um tipo de dados enumerado que especifica o estado atual do botão de barra de ferramentas.
A implementação padrão desse método exibe a borda padrão. Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de um botão de barra de ferramentas.
Os estados possíveis de um botão de barra de ferramentas são ButtonsIsRegular, ButtonsIsPressed ou ButtonsIsHighlighted.
virtual void OnDrawButtonSeparator(
CDC* pDC,
CMFCToolBarButton* pButton,
CRect rect,
CMFCVisualManager::AFX_BUTTON_STATE state,
BOOL bHorz);
[in] pDC
[in] pButton
[in] rect
[in] state
[in] bHorz
A estrutura chama esse método quando desenha a borda de um objeto classe CMFCCaptionBar.
virtual void OnDrawCaptionBarBorder(
CDC* pDC,
CMFCCaptionBar* pBar,
CRect rect,
COLORREF clrBarBorder,
BOOL bFlatBorder);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pBar
[in] Um ponteiro para um objeto CMFCCaptionBar. A estrutura desenha essa barra de legenda.
rect
[in] Um retângulo que especifica os limites da barra de legenda.
clrBarBorder
[in] A cor da borda.
bFlatBorder
[in] Um parâmetro booliano que especifica se a borda tem uma aparência 2D plana.
Substitua esse método em uma classe derivada para personalizar a aparência da borda de uma barra de legenda.
virtual void OnDrawCaptionBarButtonBorder(
CDC* pDC,
CMFCCaptionBar* pBar,
CRect rect,
BOOL bIsPressed,
BOOL bIsHighlighted,
BOOL bIsDisabled,
BOOL bHasDropDownArrow,
BOOL bIsSysButton);
[in] pDC
[in] pBar
[in] rect
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton
virtual void OnDrawCaptionBarInfoArea(
CDC* pDC,
CMFCCaptionBar* pBar,
CRect rect);
[in] pDC
[in] pBar
[in] rect
A estrutura chama esse método quando desenha um objeto CMFCCaptionButton.
virtual void OnDrawCaptionButton (
CDC* pDC,
CMFCCaptionButton* pButton,
BOOL bActive,
BOOL bHorz,
BOOL bMaximized,
BOOL bDisabled,
int nImageID = -1);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para um objeto CMFCCaptionButton. A estrutura desenha esse botão de legenda.
bActive
[in] Um parâmetro booliano que especifica se o botão está ativo.
bHorz
[in] Um parâmetro booliano que especifica se a legenda é horizontal.
bMaximized
[in] Um parâmetro booliano que especifica se o painel pai é maximizado.
bDisabled
[in] Um parâmetro booliano que especifica se o botão de legenda está desabilitado.
nImageID
[in] O índice de imagem do ícone a ser usado para o botão. Se nImageID for -1, esse método usará o índice de imagem registrado em pButton.
A implementação padrão desse método exibe um pequeno botão da instância global da classe CMenuImages. Os botões são listados no arquivo de cabeçalho para CMenuImages. Alguns exemplos incluem CMenuImages::IdClose, CMenuImages::IdArowLeft, CMenuImages::IdArowRight, CMenuImages::IdArowDown, CMenuImages::IdArowUp e CMenuImages::IdPinHorz.
Substitua esse método em uma classe derivada para personalizar a aparência dos botões de legenda.
virtual void OnDrawCheckBox(
CDC* pDC,
CRect rect,
BOOL bHighlighted,
BOOL bChecked,
BOOL bEnabled);
[in] pDC
[in] rect
[in] bHighlighted
[in] bChecked
[in] bEnabled
virtual void OnDrawCheckBoxEx(
CDC* pDC,
CRect rect,
int nState,
BOOL bHighlighted,
BOOL bPressed,
BOOL bEnabled);
[in] pDC
[in] rect
[in] nState
[in] bHighlighted
[in] bPressed
[in] bEnabled
A estrutura chama esse método quando desenha a borda em torno de uma instância da classe CMFCToolBarComboBoxButton.
virtual void OnDrawComboBorder(
CDC* pDC,
CRect rect,
BOOL bDisabled,
BOOL bIsDropped,
BOOL bIsHighlighted,
CMFCToolBarComboBoxButton* pButton);
pDC
[in] Um ponteiro para o contexto do dispositivo de um botão de caixa de combinação.
rect
[in] Um retângulo que especifica os limites do botão de caixa de combinação.
bDisabled
[in] Um parâmetro booliano que indica se o botão de caixa de combinação não está disponível.
bIsDropped
[in] Um parâmetro booliano que indica se a caixa de combinação é suspensa.
bIsHighlighted
[in] Um parâmetro booliano que indica se o botão de caixa de combinação está realçado.
pButton
[in] Um ponteiro para um objeto CMFCToolBarComboBoxButton. A estrutura desenha esse botão de caixa de combinação.
Substitua esse método no gerenciador visual derivado para personalizar a aparência da borda da caixa de combinação.
A estrutura chama esse método quando desenha o botão soltar de um CMFCToolBarComboBoxButton.
virtual void OnDrawComboDropButton(
CDC* pDC,
CRect rect,
BOOL bDisabled,
BOOL bIsDropped,
BOOL bIsHighlighted,
CMFCToolBarComboBoxButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão soltar.
bDisabled
[in] Um parâmetro booliano que indica se o botão soltar não está disponível.
bIsDropped
[in] Um parâmetro booliano que indica se a caixa de combinação é suspensa.
bIsHighlighted
[in] Um parâmetro booliano que indica se o botão soltar está realçado.
pButton
[in] Um ponteiro para um objeto CMFCToolBarComboBoxButton. A estrutura desenha o botão soltar para esse botão de caixa de combinação.
Substitua esse método no gerenciador visual derivado para personalizar a aparência do botão soltar de um botão de caixa de combinação.
virtual void OnDrawControlBorder(CWnd* pWndCtrl);
[in] pWndCtrl
A estrutura chama esse método quando desenha a imagem padrão usada para o botão da faixa de opções.
virtual void OnDrawDefaultRibbonImage(
CDC* pDC,
CRect rectImage,
BOOL bIsDisabled = FALSE,
BOOL bIsPressed = FALSE,
BOOL bIsHighlighted = FALSE);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectImage
[in] Um retângulo que especifica os limites da imagem padrão.
bIsDisabled
[in] Um parâmetro booliano que indica se o botão da faixa de opções não está disponível.
bIsPressed
[in] Um parâmetro booliano que indica se o botão da faixa de opções está pressionado.
bIsHighlighted
[in] Um parâmetro booliano que indica se o botão da faixa de opções está realçado.
Substitua esse método em um gerenciador visual derivado se quiser personalizar a imagem usada para o botão da faixa de opções.
A estrutura chama esse método quando desenha a borda ao redor de uma instância da classe CMFCToolBarEditBoxButton.
virtual void OnDrawEditBorder(
CDC* pDC,
CRect rect,
BOOL bDisabled,
BOOL bIsHighlighted,
CMFCToolBarEditBoxButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do CMFCToolBarEditBoxButton.
bDisabled
[in] Um parâmetro booliano que indica se o botão não está disponível.
bIsHighlighted
[in] Um parâmetro booliano que indica se o botão está realçado.
pButton
[in] Um ponteiro para um objeto CMFCToolBarEditBoxButton. A estrutura desenha a borda desse botão da caixa de edição.
Substitua esse método em um gerenciador visual derivado para personalizar a borda de um objeto CMFCToolBarEditBoxButton.
virtual void OnDrawExpandingBox(
CDC* pDC,
CRect rect,
BOOL bIsOpened,
COLORREF colorBox);
[in] pDC
[in] rect
[in] bIsOpened
[in] colorBox
A estrutura chama esse método quando desenha a borda de uma barra de ferramentas flutuante.
virtual void OnDrawFloatingToolbarBorder(
CDC* pDC,
CMFCBaseToolBar* pToolBar,
CRect rectBorder,
CRect rectBorderSize);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pToolBar
[in] Um ponteiro para a barra de ferramentas flutuante.
rectBorder
[in] Um retângulo que especifica os limites da barra de ferramentas flutuante.
rectBorderSize
[in] Um retângulo que especifica o tamanho da borda da barra de ferramentas.
Uma barra de ferramentas flutuante é uma barra de ferramentas que aparece como uma janela com minimoldura. Normalmente, isso ocorre quando um usuário arrasta uma barra de ferramentas para que não esteja mais encaixada.
O tamanho da borda é especificado pelo parâmetro correspondente em rectBorderSize. Por exemplo, a largura da borda superior da barra de ferramentas é especificada por rectBorderSize.top.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de uma barra de ferramentas flutuante.
A estrutura chama esse método quando desenha a borda ao redor de uma instância da classe CMFCHeaderCtrl.
virtual void OnDrawHeaderCtrlBorder(
CMFCHeaderCtrl* pCtrl,
CDC* pDC,
CRect& rect,
BOOL bIsPressed,
BOOL bIsHighlighted);
pCtrl
[in] Um ponteiro para um objeto CMFCHeaderCtrl. A estrutura desenha a borda desse controle de cabeçalho.
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do controle de cabeçalho.
bIsPressed
[in] Um parâmetro booliano que indica se o controle de cabeçalho está pressionado.
bIsHighlighted
[in] Um parâmetro booliano que indica se o controle de cabeçalho está realçado.
Substitua esse método em um gerenciador visual derivado para personalizar a borda do controle de cabeçalho.
A estrutura chama essa função quando desenha a seta de classificação de um controle de cabeçalho.
virtual void OnDrawHeaderCtrlSortArrow(
CMFCHeaderCtrl* pCtrl,
CDC* pDC,
CRect& rect,
BOOL bIsUp);
pCtrl
[in] Um ponteiro para um controle de cabeçalho. O gerenciador visual desenha a seta de classificação deste objeto classe CMFCHeaderCtrl.
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites da seta de classificação.
bIsUp
[in] Um booliano que especifica a direção da seta de classificação.
Se bIsUp for TRUE, o gerenciador visual desenhará uma seta de classificação para cima. Se for FALSE, o gerenciador visual desenhará uma seta de classificação para baixo. Substitua OnDrawHeaderCtrlSortArrow em uma classe derivada para personalizar a aparência do botão de classificação.
virtual void OnDrawMenuArrowOnCustomizeList(
CDC* pDC,
CRect rectCommand,
BOOL bSelected);
[in] pDC
[in] rectCommand
[in] bSelected
A estrutura chama esse método quando desenha a borda de um CMFCPopupMenu.
virtual void OnDrawMenuBorder(
CDC* pDC,
CMFCPopupMenu* pMenu,
CRect rect);
pDC
[in] Um ponteiro para o contexto do dispositivo para um objeto CMFCPopupMenu.
pMenu
[in] Um ponteiro para um objeto CMFCPopupMenu. A estrutura desenha uma borda ao redor desse menu pop-up.
rect
[in] Um retângulo que especifica os limites do menu pop-up.
A implementação padrão desse método exibe a borda do menu padrão. Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda do menu.
virtual void OnDrawMenuCheck(
CDC* pDC,
CMFCToolBarMenuButton* pButton,
CRect rect,
BOOL bHighlight,
BOOL bIsRadio);
[in] pDC
[in] pButton
[in] rect
[in] bHighlight
[in] bIsRadio
virtual void OnDrawMenuItemButton(
CDC* pDC,
CMFCToolBarMenuButton* pButton,
CRect rectButton,
BOOL bHighlight,
BOOL bDisabled);
[in] pDC
[in] pButton
[in] rectButton
[in] bHighlight
[in] bDisabled
virtual COLORREF OnDrawMenuLabel(
CDC* pDC,
CRect rect);
[in] pDC
[in] rect
virtual void OnDrawMenuResizeBar(
CDC* pDC,
CRect rect,
int nResizeFlags);
[in] pDC
[in] rect
[in] nResizeFlags
A estrutura chama esse método quando desenha um botão de rolagem de menu.
virtual void OnDrawMenuScrollButton(
CDC* pDC,
CRect rect,
BOOL bIsScrollDown,
BOOL bIsHighlited,
BOOL bIsPressed,
BOOL bIsDisabled);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão de rolagem.
bIsScrollDown
[in] Um booliano que indica o tipo de botão que o gerenciador visual desenha. Um valor de TRUE indica que o gerenciador visual desenha um botão para baixo.
bIsHighlited
[in] Um booliano que indica se o botão está realçado.
bIsPressed
[in] Um booliano que indica se o botão está pressionado.
bIsDisabled
[in] Um booliano que indica se o botão está desabilitado.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões de rolagem do menu. Os botões de rolagem do menu aparecem na borda dos menus pop-up quando a altura total dos itens de menu excede a altura do menu pop-up.
virtual void OnDrawMenuShadow(
CDC* pDC,
const CRect& rectClient,
const CRect& rectExclude,
int nDepth,
int iMinBrightness,
int iMaxBrightness,
CBitmap* pBmpSaveBottom,
CBitmap* pBmpSaveRight,
BOOL bRTL);
[in] pDC
[in] rectClient
[in] rectExclude
[in] nDepth
[in] iMinBrightness
[in] iMaxBrightness
[in] pBmpSaveBottom
[in] pBmpSaveRight
[in] bRTL
A estrutura chama esse método quando desenha um botão do sistema de menus para o aplicativo.
virtual void OnDrawMenuSystemButton(
CDC* pDC,
CRect rect,
UINT uiSystemCommand,
UINT nStyle,
BOOL bHighlight);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão.
uiSystemCommand
[in] Um sinalizador que especifica qual comando do sistema está associado ao botão. Os valores possíveis são SC_CLOSE, SC_MINIMIZE e SC_RESTORE.
nEstilo
[in] Um sinalizador que especifica o estilo atual do botão. Os valores possíveis são TBBS_PRESSED, TBBS_DISABLED e 0.
bHighlight
[in] Um parâmetro booliano que especifica se o botão está realçado.
Os botões do sistema de menus são os botões Fechar, Minimizar, Maximizar e Restaurar localizados na barra de título.
A implementação padrão para esse método chama CDC::DrawFrameControl com o tipo DFC_CAPTION. Substitua esse método na classe do gerenciador visual derivada para personalizar a aparência dos botões do sistema.
virtual void OnDrawMiniFrameBorder(
CDC* pDC,
CPaneFrameWnd* pFrameWnd,
CRect rectBorder,
CRect rectBorderSize);
[in] pDC
[in] pFrameWnd
[in] rectBorder
[in] rectBorderSize
A estrutura chama esse método quando desenha o divisor para uma barra do Outlook.
virtual void OnDrawOutlookBarSplitter(
CDC* pDC,
CRect rectSplitter);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectSplitter
[in] Um retângulo que especifica os limites do divisor.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos divisores em uma barra do Outlook.
Chamado pela estrutura quando desenha a borda de um botão de página do Outlook.
virtual void OnDrawOutlookPageButtonBorder(
CDC* pDC,
CRect& rectBtn,
BOOL bIsHighlighted,
BOOL bIsPressed);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectBtn
[in] Um retângulo que especifica o limite do botão de página do Outlook.
bIsHighlighted
[in] Um booliano que especifica se o botão está realçado.
bIsPressed
[in] Um booliano que especifica se o botão está pressionado.
Substitua esse método em um gerenciador visual personalizado para alterar a aparência do botão de página do Outlook.
A estrutura chama esse método quando desenha a borda de um objeto da classe CPane.
virtual void OnDrawPaneBorder(
CDC* pDC,
CBasePane* pBar,
CRect& rect);
pDC
[in] Um ponteiro para o contexto do dispositivo de uma barra de controle.
pBar
[in] Um ponteiro para um painel. O gerenciador visual desenha a borda deste painel.
rect
[in] Um retângulo que indica os limites do painel.
A implementação padrão desse método exibe a borda padrão. Substitua esse método em uma classe derivada para personalizar a aparência da borda.
A estrutura chama esse método quando desenha uma legenda para uma instância da classe CDockablePane.
virtual COLORREF OnDrawPaneCaption(
CDC* pDC,
CDockablePane* pBar,
BOOL bActive,
CRect rectCaption,
CRect rectButtons);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pBar
[in] Um ponteiro para um objeto CDockablePane. A estrutura desenha a legenda deste painel.
bActive
[in] Um parâmetro booliano que indica se a barra de controle está ativa.
rectCaption
[in] Um retângulo que especifica os limites da legenda.
rectButtons
[in] Um retângulo que especifica os limites dos botões de legenda.
Um parâmetro COLORREF que indica a cor do texto da legenda.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência das legendas do painel.
virtual void OnDrawPaneDivider(
CDC* pDC,
CPaneDivider* pSlider,
CRect rect,
BOOL bAutoHideMode);
[in] pDC
[in] pSlider
[in] rect
[in] bAutoHideMode
virtual void OnDrawPopupWindowBorder(
CDC* pDC,
CRect rect);
[in] pDC
[in] rect
virtual void OnDrawPopupWindowButtonBorder(
CDC* pDC,
CRect rectClient,
CMFCDesktopAlertWndButton* pButton);
[in] pDC
[in] rectClient
[in] pButton
virtual COLORREF OnDrawPopupWindowCaption(
CDC* pDC,
CRect rectCaption,
CMFCDesktopAlertWnd* pPopupWnd);
[in] pDC
[in] rectCaption
[in] pPopupWnd
A estrutura chama esse método quando desenha o Botão Principal na faixa de opções.
virtual void OnDrawRibbonApplicationButton(
CDC* pDC,
CMFCRibbonButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para o Botão Principal na faixa de opções.
Substitua esse método em um gerenciador visual derivado se quiser personalizar a aparência do Botão Principal.
A estrutura chama esse método quando desenha a borda de um botão na faixa de opções.
virtual void OnDrawRibbonButtonBorder(
CDC* pDC,
CMFCRibbonButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para um objeto CMFCRibbonButton. A estrutura desenha a borda para esse botão da faixa de opções.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um arquivo CMFCRibbonButton.
A estrutura chama esse método quando desenha um grupo de botões na faixa de opções.
virtual COLORREF OnDrawRibbonButtonsGroup(
CDC* pDC,
CMFCRibbonButtonsGroup* pGroup,
CRect rectGroup);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pGroup
[in] Um ponteiro para um grupo de botões na faixa de opções. A estrutura desenha esse grupo de botões.
rectGroup
[in] Um retângulo que especifica os limites do grupo.
Um valor reservado. A implementação padrão retorna -1.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um grupo de botões na faixa de opções.
A estrutura chama esse método quando desenha a barra de legenda da janela do quadro principal. A estrutura chamará esse método somente se a faixa de opções estiver integrada ao quadro principal.
virtual void OnDrawRibbonCaption(
CDC* pDC,
CMFCRibbonBar* pBar,
CRect rect,
CRect rectText);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pBar
[in] Um ponteiro para uma barra da faixa de opções. O gerenciador visual desenha essa barra da faixa de opções.
rect
[in] Um retângulo que especifica os limites da barra da faixa de opções.
rectText
[in] Um retângulo que especifica os limites do texto da barra de legenda.
Substitua essa função em um gerenciador visual derivado para personalizar a aparência da barra de legenda. Esse método afetará a barra de legenda somente se a faixa de opções estiver integrada à janela do quadro principal.
A estrutura chama esse método quando desenha um botão de título localizado na barra da faixa de opções.
virtual void OnDrawRibbonCaptionButton(
CDC* pDC,
CMFCRibbonCaptionButton* pButton);
pDC
Um ponteiro para um contexto de dispositivo.
pButton
Um ponteiro para uma classe CMFCRibbonCaptionButton. A estrutura desenha esse botão de legenda.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um botão de legenda na faixa de opções.
A estrutura chama esse método quando desenha um objeto CMFCRibbonCategory.
virtual void OnDrawRibbonCategory(
CDC* pDC,
CMFCRibbonCategory* pCategory,
CRect rectCategory);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pCategory
[in] Um ponteiro para um objeto CMFCRibbonCategory. A estrutura desenha essa categoria da faixa de opções.
rectCategory
[in] Um retângulo que especifica o limite de todos os painéis de categoria na faixa de opções.
Uma categoria da faixa de opções é um agrupamento lógico de comandos do menu. Para obter mais informações sobre as categorias de faixa de opções, consulte classe CMFCRibbonCategory.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de uma categoria da faixa de opções.
A estrutura chama esse método quando desenha a barra de legenda para uma categoria da faixa de opções.
virtual COLORREF OnDrawRibbonCategoryCaption(
CDC* pDC,
CMFCRibbonContextCaption* pContextCaption);
pDC
[in] O contexto do desenho.
pContextCaption
[in] Um ponteiro para uma barra de legenda. O gerenciador visual desenha esse objeto classe CMFCRibbonContextCaption.
Um parâmetro COLORREF que indica a cor do texto na barra de legenda.
Substitua esse método em uma classe derivada para personalizar a aparência da barra de legenda para uma categoria de faixa de opções. Para obter mais informações sobre a barra de legendas, consulte classe CMFCRibbonContextCaption.
virtual void OnDrawRibbonCategoryScroll(
CDC* pDC,
CRibbonCategoryScroll* pScroll);
[in] pDC
[in] pScroll
A estrutura chama esse método quando desenha a guia para uma categoria de faixa de opções.
virtual COLORREF OnDrawRibbonCategoryTab(
CDC* pDC,
CMFCRibbonTab* pTab,
BOOL bIsActive);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pTab
[in] Um ponteiro para uma instância da CMFCRibbonTabclasse. A estrutura desenha essa guia.
bIsActive
[in] Um parâmetro booliano que indica se a guia está ativa.
A cor usada para texto na guia categoria da faixa de opções.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de uma guia de categoria da faixa de opções. Para obter mais informações sobre as categorias da faixa de opções, consulte classe CMFCRibbonCategory.
virtual void OnDrawRibbonCheckBoxOnList(
CDC* pDC,
CMFCRibbonCheckBox* pCheckBox,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
[in] pDC
[in] pCheckBox
[in] rect
[in] bIsSelected
[in] bHighlighted
virtual void OnDrawRibbonColorPaletteBox(
CDC* pDC,
CMFCRibbonColorButton* pColorButton,
CMFCRibbonGalleryIcon* pIcon,
COLORREF color,
CRect rect,
BOOL bDrawTopEdge,
BOOL bDrawBottomEdge,
BOOL bIsHighlighted,
BOOL bIsChecked,
BOOL bIsDisabled);
[in] pDC
[in] pColorButton
[in] pIcon
[in] color
[in] rect
[in] bDrawTopEdge
[in] bDrawBottomEdge
[in] bIsHighlighted
[in] bIsChecked
[in] bIsDisabled
A estrutura chama esse método quando desenha o botão padrão para o painel da faixa de opções.
virtual void OnDrawRibbonDefaultPaneButton(
CDC* pDC,
CMFCRibbonButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para o botão padrão do painel da faixa de opções.
A estrutura exibe o botão padrão quando um painel da faixa de opções é redimensionado para o tamanho mínimo e não há área para exibir o conteúdo do painel. Quando o usuário clica no botão padrão, a estrutura exibe um menu suspenso que contém o conteúdo do painel.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência do botão padrão.
virtual void OnDrawRibbonDefaultPaneButtonContext(
CDC* pDC,
CMFCRibbonButton* pButton);
[in] pDC
[in] pButton
virtual void OnDrawRibbonDefaultPaneButtonIndicator(
CDC* pDC,
CMFCRibbonButton* pButton,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
[in] pDC
[in] pButton
[in] rect
[in] bIsSelected
[in] bHighlighted
virtual void OnDrawRibbonGalleryBorder(
CDC* pDC,
CMFCRibbonGallery* pButton,
CRect rectBorder);
[in] pDC
[in] pButton
[in] rectBorder
virtual void OnDrawRibbonGalleryButton(
CDC* pDC,
CMFCRibbonGalleryIcon* pButton);
[in] pDC
[in] pButton
virtual void OnDrawRibbonKeyTip(
CDC* pDC,
CMFCRibbonBaseElement* pElement,
CRect rect,
CString str);
[in] pDC
[in] pElement
[in] rect
[in] str
A estrutura chama esse método quando desenha o rótulo da faixa de opções.
virtual void OnDrawRibbonLabel(
CDC* pDC,
CMFCRibbonLabel* pLabel,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pLabel
[in] Um ponteiro para um objeto CMFCRibbonLabel. A estrutura desenha esse rótulo da faixa de opções.
rect
[in] Um retângulo que especifica os limites do painel da faixa de opções.
Substitua esse método em uma classe derivada para personalizar o rótulo da faixa de opções.
A estrutura chama esse método quando desenha a borda de um CMFCRibbonButton posicionado no painel Principal.
virtual void OnDrawRibbonMainPanelButtonBorder(
CDC* pDC,
CMFCRibbonButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para um CMFCRibbonButton localizado no painel principal da faixa de opções. A estrutura desenha a borda para esse botão.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de um CMFCRibbonButton no painel Principal.
A estrutura chama esse método quando desenha o quadro ao redor do CMFCRibbonMainPanel.
virtual void OnDrawRibbonMainPanelFrame(
CDC* pDC,
CMFCRibbonMainPanel* pPanel,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pPanel
[in] Um ponteiro para o CMFCRibbonMainPanel.
rect
[in] Um retângulo que especifica os limites de CMFCRibbonMainPanel.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência do quadro para o CMFCRibbonMainPanel.
virtual void OnDrawRibbonMenuCheckFrame(
CDC* pDC,
CMFCRibbonButton* pButton,
CRect rect);
[in] pDC
[in] pButton
[in] rect
A estrutura chama esse método quando desenha um objeto CMFCRibbonPanel.
virtual COLORREF OnDrawRibbonPanel(
CDC* pDC,
CMFCRibbonPanel* pPanel,
CRect rectPanel,
CRect rectCaption);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pPanel
[in] Um ponteiro para um objeto CMFCRibbonPanel. A estrutura desenha esse painel da faixa de opções.
rectPanel
[in] Um retângulo que especifica os limites do painel.
rectCaption
[in] Um retângulo que especifica os limites da legenda do painel.
A cor do texto no painel da faixa de opções.
Substitua esse método em uma classe derivada para personalizar a aparência de um painel da faixa de opções.
A estrutura chama esse método quando desenha a legenda de uma classe CMFCRibbonPanel.
virtual void OnDrawRibbonPanelCaption(
CDC* pDC,
CMFCRibbonPanel* pPanel,
CRect rectCaption);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pPanel
[in] Um ponteiro para um objeto CMFCRibbonPanel. A estrutura desenha a legenda para esse painel da faixa de opções.
rectCaption
[in] Um retângulo que especifica os limites da legenda para o painel da faixa de opções.
Substitua esse método em uma classe derivada para personalizar a aparência das legendas dos painéis da faixa de opções.
A estrutura chama esse método quando desenha uma classe CMFCRibbonProgressBar.
virtual void OnDrawRibbonProgressBar(
CDC* pDC,
CMFCRibbonProgressBar* pProgress,
CRect rectProgress,
CRect rectChunk,
BOOL bInfiniteMode);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pProgress
[in] Um ponteiro para um objeto CMFCRibbonProgressBar. A estrutura desenha essa barra de progresso.
rectProgress
[in] Um retângulo que especifica os limites da barra de progresso.
rectChunk
[in] Um retângulo que especifica os limites da área ao redor da barra de progresso.
bInfiniteMode
[in] Um parâmetro booliano que indica o modo da barra de progresso. Um valor TRUE significa que a barra está no modo infinito. A implementação padrão não usa esse parâmetro.
Substitua esse método em uma classe derivada para personalizar a aparência de uma barra de progresso.
A estrutura chama esse método quando desenha um separador na Barra de Ferramentas de Acesso Rápido de uma faixa de opções.
virtual void OnDrawRibbonQuickAccessToolBarSeparator(
CDC* pDC,
CMFCRibbonSeparator* pSeparator,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSeparator
[in] Um ponteiro para um objeto CMFCRibbonSeparator. A estrutura desenha esse separador de faixa de opções.
rect
[in] Um retângulo que especifica os limites do separador.
Substitua esse método em uma classe derivada para personalizar a aparência dos separadores da faixa de opções na Barra de Ferramentas de Acesso Rápido.
A estrutura chama esse método quando desenha um quadro ao redor de uma lista de arquivos recentes.
virtual void OnDrawRibbonRecentFilesFrame(
CDC* pDC,
CMFCRibbonMainPanel* pPanel,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pPanel
[in] Um ponteiro para o painel Principal na faixa de opções.
rect
[in] Um retângulo que especifica os limites do quadro para a lista de arquivos recentes.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da lista de arquivos recentes.
A estrutura chama esse método quando desenha o canal de uma classe CMFCRibbonSlider.
virtual void OnDrawRibbonSliderChannel(
CDC* pDC,
CMFCRibbonSlider* pSlider,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSlider
[in] Um ponteiro para um objeto CMFCRibbonSlider. A estrutura desenha o canal para este controle deslizante da faixa de opções.
rect
[in] Um retângulo que especifica os limites para o canal do controle deslizante da faixa de opções.
Substitua esse método em uma classe derivada para personalizar a aparência do canal do controle deslizante da faixa de opções.
A estrutura chama esse método quando desenha a miniatura de um objeto CMFCRibbonSlider.
virtual void OnDrawRibbonSliderThumb(
CDC* pDC,
CMFCRibbonSlider* pSlider,
CRect rect,
BOOL bIsHighlighted,
BOOL bIsPressed,
BOOL bIsDisabled);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSlider
[in] Um ponteiro para um CMFCRibbonSlider. A estrutura desenha o polegar para este controle deslizante da faixa de opções.
rect
[in] Um retângulo que especifica os limites da miniatura para o controle deslizante da faixa de opções.
bIsHighlighted
[in] Um parâmetro booliano que indica se a miniatura está realçada.
bIsPressed
[in] Um parâmetro booliano que indica se a miniatura está pressionada.
bIsDisabled
[in] Um parâmetro booliano que indica se a miniatura não está disponível.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da miniatura para um arquivo CMFCRibbonSlider.
A estrutura chama esse método quando desenha os botões de zoom para um objeto CMFCRibbonSlider.
virtual void OnDrawRibbonSliderZoomButton(
CDC* pDC,
CMFCRibbonSlider* pSlider,
CRect rect,
BOOL bIsZoomOut,
BOOL bIsHighlighted,
BOOL bIsPressed,
BOOL bIsDisabled);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSlider
[in] Um ponteiro para um objeto CMFCRibbonSlider. A estrutura desenha esse controle deslizante da faixa de opções.
rect
[in] Um retângulo que especifica os limites dos botões de zoom no controle deslizante da faixa de opções.
bIsZoomOut
[in] Um parâmetro booliano que indica qual botão a estrutura desenha. Um valor de TRUE indica o botão esquerdo com um "-" para reduzir. Um valor FALSE indica o botão direito com um "+" para ampliar.
bIsHighlighted
[in] Um parâmetro booliano que indica se o botão está realçado.
bIsPressed
[in] Um parâmetro booliano que indica se o botão está pressionado.
bIsDisabled
[in] Um parâmetro booliano que indica se o botão não está disponível.
Por padrão, os botões de zoom no controle deslizante da faixa de opções são um círculo com um sinal de + ou de - no centro. Para personalizar a aparência dos botões de zoom, substitua esse método em um gerenciador visual derivado.
A estrutura chama esse método quando desenha um painel na barra de status.
virtual COLORREF OnDrawRibbonStatusBarPane(
CDC* pDC,
CMFCRibbonStatusBar* pBar,
CMFCRibbonStatusBarPane* pPane);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pBar
[in] Um ponteiro para a barra de status que contém o painel.
pPane
[in] Um ponteiro para um painel de barras de status. A estrutura desenha esse objeto CMFCRibbonStatusBarPane.
Um valor reservado. A implementação padrão retorna -1.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um painel na barra de status.
A estrutura chama esse método quando desenha o quadro ao redor de um conjunto de guias de faixa de opções.
virtual COLORREF OnDrawRibbonTabsFrame(
CDC* pDC,
CMFCRibbonBar* pWndRibbonBar,
CRect rectTab);
pDC
Um ponteiro para um contexto de dispositivo.
pWndRibbonBar
Um ponteiro para um objeto CMFCRibbonBar. A estrutura desenha o quadro para essa barra da faixa de opções.
rectTab
Um retângulo que especifica os limites das guias de faixa de opções.
Um valor reservado. Por padrão, esse método retorna -1.
Substitua esse método em um gerenciador visual derivado para personalizar o quadro ao redor de um conjunto de guias na faixa de opções.
virtual void OnDrawScrollButtons(
CDC* pDC,
const CRect& rect,
const int nBorderSize,
int iImage,
BOOL bHilited);
[in] pDC
[in] rect
[in] nBorderSize
[in] iImage
[in] bHilited
A estrutura chama esse método quando desenha um separador.
virtual void OnDrawSeparator(
CDC* pDC,
CBasePane* pBar,
CRect rect,
BOOL bIsHoriz);
pDC
[in] Um ponteiro para o contexto do dispositivo para uma barra de controle.
pBar
[in] Um ponteiro para um painel que contém o separador.
rect
[in] Um retângulo que especifica os limites do separador.
bIsHoriz
[in] Um parâmetro booliano que indica a orientação de um painel encaixado. Um valor TRUE indica que o painel está encaixado horizontalmente. Um valor FALSE indica que o painel está encaixado verticalmente.
Separadores são usados em barras de controle para separar grupos de ícones relacionados. A implementação padrão para esse método exibe o separador padrão. Substitua esse método em um gerenciador visual derivado para personalizar a aparência do separador.
virtual void OnDrawShowAllMenuItems(
CDC* pDC,
CRect rect,
CMFCVisualManager::AFX_BUTTON_STATE state);
[in] pDC
[in] rect
[in] state
A estrutura chama esse método quando desenha uma instância da classe CMFCSpinButtonCtrl.
virtual void OnDrawSpinButtons(
CDC* pDC,
CRect rectSpin,
int nState,
BOOL bOrientation,
CMFCSpinButtonCtrl* pSpinCtrl);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectSpin
[in] Um retângulo que especifica os limites do controle de rotação.
nState
[in] Um sinalizador que indica o estado do controle de rotação. Confira a seção Comentários para obter mais informações.
bOrientation
[in] Um parâmetro booliano que especifica a orientação do controle de rotação. Um valor de TRUE indica que o controle de rotação é horizontal. Caso contrário, é vertical.
pSpinCtrl
[in] Um ponteiro para um controle de rotação. A estrutura desenha os botões para esse controle.
O parâmetro nState indica o estado do controle de rotação. O parâmetro é um dos seguintes valores:
AFX_SPIN_PRESSEDUP
AFX_SPIN_PRESSEDDOWN
AFX_SPIN_HIGHLIGHTEDUP
AFX_SPIN_HIGHLIGHTEDDOWN
AFX_SPIN_DISABLED
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um controle de rotação.
A estrutura chama esse método quando desenha a borda em torno de uma instância da classe CSplitterWndEx.
virtual void OnDrawSplitterBorder(
CDC* pDC,
CSplitterWndEx* pSplitterWnd,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSplitterWnd
[in] Um ponteiro para uma janela divisora. A estrutura desenha a borda para essa janela.
rect
[in] Um retângulo que especifica os limites da janela divisora.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de uma janela divisora.
A estrutura chama esse método quando desenha a caixa de arrastar para uma instância da classe CSplitterWndEx. A caixa de arrastar é exibida quando o usuário seleciona a barra de divisor e altera as dimensões das janelas filho.
virtual void OnDrawSplitterBox(
CDC* pDC,
CSplitterWndEx* pSplitterWnd,
CRect& rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSplitterWnd
[in] Um ponteiro para uma janela divisora. A estrutura desenha a caixa para essa janela divisora.
rect
[in] Um retângulo que especifica os limites da janela divisora.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da caixa de arrastar para uma janela divisora.
A estrutura chama esse método quando desenha a borda de um objeto CMFCStatusBar.
virtual void OnDrawStatusBarPaneBorder(
CDC* pDC,
CMFCStatusBar* pBar,
CRect rectPane,
UINT uiID,
UINT nStyle);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pBar
[in] Um ponteiro para um objeto CMFCStatusBar. A estrutura desenha esse objeto de barra de status.
rectPane
[in] Um retângulo que especifica os limites da barra de status.
uiID
[in] A ID da barra de status.
nEstilo
[in] O estilo da barra de status.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda de um objeto CMFCStatusBar.
A estrutura chama esse método quando desenha o indicador de progresso no objeto CMFCStatusBar.
virtual void OnDrawStatusBarProgress(
CDC* pDC,
CMFCStatusBar* pStatusBar,
CRect rectProgress,
int nProgressTotal,
int nProgressCurr,
COLORREF clrBar,
COLORREF clrProgressBarDest,
COLORREF clrProgressText,
BOOL bProgressText);
pDC
[in] Um ponteiro para o contexto do dispositivo para a barra de status.
pStatusBar
[in] O objeto CMFCStatusBar que contém a barra de progresso.
rectProgress
[in] Um retângulo que especifica os limites da barra de progresso.
nProgressTotal
[in] O número total da barra de progresso.
nProgressCurr
[in] O progresso atual da barra de progresso.
clrBar
[in] Um parâmetro COLORREF que indica a cor inicial da barra de progresso. O valor é o início de um gradiente de cor ou a cor completa da barra de progresso.
clrProgressBarDest
[in] Um parâmetro COLORREF que indica o final de um gradiente de cores para a barra de progresso. Se clrProgressBarDest for -1, a estrutura não desenhará a barra de progresso como um gradiente de cores. Em vez disso, preencherá toda a barra de progresso com a cor especificada por clrBar.
clrProgressText
[in] Um parâmetro COLORREF que indica a cor do texto para a representação textual do progresso atual. Esse parâmetro será ignorado se bProgressText for definido como FALSE.
bTextoDeProgresso
[in] Um parâmetro booliano que indica se a representação textual do progresso atual deve ser exibida.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência do objeto CMFCStatusBar.
A estrutura chama esse método quando desenha a caixa de tamanho para CMFCStatusBar.
virtual void OnDrawStatusBarSizeBox(
CDC* pDC,
CMFCStatusBar* pStatBar,
CRect rectSizeBox);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pStatBar
[in] Um ponteiro para uma barra de status. A estrutura desenha a caixa de tamanho para essa barra de status.
rectSizeBox
[in] Um retângulo que especifica os limites da caixa de tamanho.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da caixa de tamanho em um arquivo CMFCStatusBar.
A estrutura chama esse método quando desenha as guias para um objeto CMFCBaseTabCtrl.
virtual void OnDrawTab(
CDC* pDC,
CRect rectTab,
int iTab,
BOOL bIsActive,
const CMFCBaseTabCtrl* pTabWnd);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectTab
[in] Um retângulo que especifica os limites do controle guia.
iTab
[in] O índice da guia que a estrutura desenha.
bIsActive
[in] Um parâmetro booliano que especifica se a guia está ativa.
pTabWnd
[in] Um ponteiro para um objeto CMFCBaseTabCtrl. A estrutura desenha esse controle guia.
Um objeto CMFCBaseTabCtrl chama esse método quando processa a mensagem de WM_PAINT.
Substitua esse método em uma classe derivada para personalizar a aparência das guias.
Chamado pela estrutura quando desenha o botão Fechar na guia ativa.
virtual void OnDrawTabCloseButton(
CDC* pDC,
CRect rect,
const CMFCBaseTabCtrl* pTabWnd,
BOOL bIsHighlighted,
BOOL bIsPressed,
BOOL bIsDisabled);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão Fechar.
pTabWnd
[in] Um ponteiro para um controle guia. A estrutura desenha o botão Fechar para esse controle guia.
bIsHighlighted
[in] Um parâmetro booliano que indica se o botão Fechar está realçado.
bIsPressed
[in] Um parâmetro booliano que indica se o botão Fechar está pressionado.
bIsDisabled
[in] Um parâmetro booliano que indica se o botão Fechar está desabilitado.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência do botão Fechar na guia ativa de pTabWnd.
A estrutura chama esse método quando desenha o conteúdo localizado no interior de uma instância da classe CMFCBaseTabCtrl.
virtual void OnDrawTabContent(
CDC* pDC,
CRect rectTab,
int iTab,
BOOL bIsActive,
const CMFCBaseTabCtrl* pTabWnd,
COLORREF clrText);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectTab
[in] Um retângulo que especifica os limites do interior da guia.
iTab
[in] O índice baseado em zero da guia. A estrutura desenha o interior desa guia.
bIsActive
[in] Um parâmetro booliano que indica se uma guia está ativa.
pTabWnd
[in] Um ponteiro para o controle com guias que contém a guia sendo desenhada.
clrTexto
[in] A cor do texto no interior da guia.
O interior de uma guia contém o texto e os ícones da guia. Substitua esse método em um gerenciador visual derivado para personalizar a aparência das guias.
A estrutura chama esse método quando desenha a borda de um botão de guia.
virtual void OnDrawTabsButtonBorder(
CDC* pDC,
CRect& rect,
CMFCButton* pButton,
UINT uiState,
CMFCBaseTabCtrl* pWndTab);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão da guia.
pButton
[in] Um ponteiro para um objeto CMFCButton. A estrutura desenha a borda para esta instância CMFCButton.
uiState
[in] Um inteiro sem sinal que especifica o estado do botão.
pWndTab
[in] Um ponteiro para a janela com guias pai.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da borda do botão da guia.
A estrutura chama esse método quando desenha um objeto CMFCTasksPane.
virtual void OnDrawTask(
CDC* pDC,
CMFCTasksPaneTask* pTask,
CImageList* pIcons,
BOOL bIsHighlighted = FALSE,
BOOL bIsSelected = FALSE);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pTask
[in] Um ponteiro para um objetoCMFCTasksPaneTask. A estrutura desenha essa tarefa.
pIcons
[in] Um ponteiro para a lista de imagens associada ao painel de tarefas. Cada tarefa contém um índice para uma imagem nesta lista.
bIsHighlighted
[in] Um parâmetro booliano que especifica se a tarefa exibida está realçada.
bIsSelected
[in] Um parâmetro booliano que especifica se a tarefa exibida está selecionada.
A estrutura exibe tarefas na barra de tarefas como ícone e texto. O parâmetro pIcons contém o ícone da tarefa indicada por pTask.
Substitua esse método em uma classe derivada para personalizar a aparência das tarefas na barra de tarefas.
A estrutura chama esse método quando desenha uma borda ao redor de um grupo em uma Classe CMFCTasksPane.
virtual void OnDrawTasksGroupAreaBorder(
CDC* pDC,
CRect rect,
BOOL bSpecial = FALSE,
BOOL bNoTitle = FALSE);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites da área de grupo no painel de tarefas.
bSpecial
[in] Um parâmetro booliano que especifica se a borda está realçada. Um valor de TRUE indica que a borda está realçada.
bNoTitle
[in] Um parâmetro booliano que especifica se a área de grupo tem um título. Um valor de TRUE indica que a área de grupo não tem um título.
Substitua essa função em uma classe derivada para personalizar a borda em torno de uma área de grupo no painel de tarefas.
A estrutura chama esse método quando desenha a legenda para um objeto CMFCTasksPaneTaskGroup.
virtual void OnDrawTasksGroupCaption(
CDC* pDC,
CMFCTasksPaneTaskGroup* pGroup,
BOOL bIsHighlighted = FALSE,
BOOL bIsSelected = FALSE,
BOOL bCanCollapse = FALSE);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pGroup
[in] Um ponteiro para um objeto CMFCTasksPaneTaskGroup. A estrutura desenha a legenda desse grupo.
bIsHighlighted
[in] Um parâmetro booliano que indica se o grupo está realçado.
bIsSelected
[in] Um parâmetro booliano que indica se o grupo está selecionado no momento.
bCanCollapse
[in] Um parâmetro booliano que indica se o grupo pode ser recolhido.
Os grupos de tarefas aparecem no objeto CMFCTasksPane.
Substitua esse método em uma classe derivada para personalizar a legenda de um CMFCTasksPaneTaskGroup.
virtual void OnDrawTasksGroupIcon(
CDC* pDC,
CMFCTasksPaneTaskGroup* pGroup,
int nIconHOffset = 5,
BOOL bIsHighlighted = FALSE,
BOOL bIsSelected = FALSE,
BOOL bCanCollapse = FALSE);
[in] pDC
[in] pGroup
[in] nIconHOffset
[in] bIsHighlighted
[in] bIsSelected
[in] bCanCollapse
A estrutura chama esse método quando desenha a legenda para uma classe CMFCPopupMenu.
virtual void OnDrawTearOffCaption(
CDC* pDC,
CRect rect,
BOOL bIsActive);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites da legenda.
bIsActive
[in] TRUE se a legenda estiver ativa, caso contrário, FALSE.
Essa função é chamada pela estrutura quando um objeto CMFCPopupMenu processa uma mensagem WM_PAINT e deve desenhar uma legenda destacável.
Substitua esse método em uma classe derivada para personalizar a aparência das legendas para barras destacáveis.
virtual void OnDrawToolBoxFrame(
CDC* pDC,
const CRect& rect);
[in] pDC
[in] rect
A estrutura chama esse método quando apaga a área do cliente MDI.
virtual BOOL OnEraseMDIClientArea(
CDC* pDC,
CRect rectClient);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectClient
[in] Um retângulo que especifica os limites da área do cliente MDI.
Um valor reservado. A implementação padrão retorna FALSE.
Substitua esse método para executar o código personalizado quando o gerenciador visual apagar a área do cliente MDI.
virtual void OnErasePopupWindowButton(
CDC* pDC,
CRect rectClient,
CMFCDesktopAlertWndButton* pButton);
[in] pDC
[in] rectClient
[in] pButton
A estrutura chama esse método quando apaga a área de guia de uma janela de guia.
virtual void OnEraseTabsArea(
CDC* pDC,
CRect rect,
const CMFCBaseTabCtrl* pTabWnd);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites da área da guia.
pTabWnd
[in] Um ponteiro para uma janela com guias. A estrutura apaga a área de guia da janela com guias especificada.
Essa função é chamada pela estrutura quando um objeto da classe CMFCBaseTabCtrl processa uma mensagem WM_PAINT e apaga a área da guia.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência das guias.
A estrutura chama esse método quando apaga o texto e o ícone de um botão da guia.
virtual void OnEraseTabsButton(
CDC* pDC,
CRect rect,
CMFCButton* pButton,
CMFCBaseTabCtrl* pWndTab);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão da guia.
pButton
[in] Um ponteiro para um botão da guia. A estrutura apaga o texto e o ícone deste botão.
pWndTab
[in] Um ponteiro para o controle guia que contém o botão da guia.
A estrutura apaga o texto e o ícone de um botão quando um objeto CMFCBaseTabCtrl processa a mensagem WM_ERASEBKGND.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões da guia.
A estrutura chama esse método quando apaga um quadro em uma classe CMFCBaseTabCtrl.
virtual BOOL OnEraseTabsFrame(
CDC* pDC,
CRect rect,
const CMFCBaseTabCtrl* pTabWnd);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites da janela com guias.
pTabWnd
[in] Um ponteiro para uma janela com guias. A estrutura apaga um quadro para este CMFCBaseTabCtrl.
TRUE se o método for bem-sucedido, caso contrário, será FALSE.
Esse método preenche a área indicada pelo rect com a cor da tela de fundo da guia ativa. Ele é chamado quando um objeto CMFCBaseTabCtrl processa uma mensagem WM_PAINT e apaga um quadro da guia.
A estrutura chama esse método quando preenche a tela de fundo de um botão de ocultamento automático.
virtual void OnFillAutoHideButtonBackground(
CDC* pDC,
CRect rect,
CMFCAutoHideButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão de ocultamento automático.
pButton
[in] Um ponteiro para um objeto CMFCAutoHideButton. A estrutura preenche a tela de fundo para este botão de ocultamento automático.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um botão de ocultamento automático.
A estrutura chama esse método quando preenche a tela de fundo de um objeto CBasePane.
virtual void OnFillBarBackground(
CDC* pDC,
CBasePane* pBar,
CRect rectClient,
CRect rectClip,
BOOL bNCArea = FALSE);
pDC
[in] Um ponteiro para o contexto do dispositivo para uma barra de controle.
pBar
[in] Um ponteiro para um objeto CBasePane. A estrutura preenche a tela de fundo desse painel.
rectClient
[in] Um retângulo que especifica os limites do painel.
rectClip
[in] Um retângulo que especifica a área de recorte do painel.
bNCArea
[in] Um valor reservado.
A implementação padrão desse método preenche a tela de fundo da barra com a cor da tela de fundo 3d da variável global afxGlobalData. Substitua esse método em um gerenciador visual derivado para personalizar a tela de fundo de um painel.
O exemplo a seguir demonstra como usar o OnFillBarBackground na classe CMFCVisualManager. Este snippet de código faz parte do exemplo de demonstração do Outlook.
// CDC* pDC
// CRect rectClient
// The this pointer points to a CMailBar class which extends the CPaneDialog class.
CMFCVisualManager::GetInstance()->OnFillBarBackground(pDC, this, rectClient, rectClient);
A estrutura chama esse método quando preenche a tela de fundo de um botão de barra de ferramentas.
virtual void OnFillButtonInterior(
CDC* pDC,
CMFCToolBarButton* pButton,
CRect rect,
CMFCVisualManager::AFX_BUTTON_STATE state);
pDC
[in] Um ponteiro para o contexto do dispositivo de um botão de barra de ferramentas.
pButton
[in] Um ponteiro para um CMFCToolBarButton. A estrutura preenche a tela de fundo para este botão.
rect
[in] Um retângulo que especifica os limites do botão de barra de ferramentas.
state
[in] O estado do botão da barra de ferramentas.
A implementação padrão desse método usa a cor padrão para preencher a tela de fundo. Substitua esse método em um gerenciador visual derivado para personalizar a tela de fundo de um botão de barra de ferramentas.
Os estados possíveis de um botão de barra de ferramentas são ButtonsIsRegular, ButtonsIsPressed ou ButtonsIsHighlighted.
virtual COLORREF OnFillCaptionBarButton(
CDC* pDC,
CMFCCaptionBar* pBar,
CRect rect,
BOOL bIsPressed,
BOOL bIsHighlighted,
BOOL bIsDisabled,
BOOL bHasDropDownArrow,
BOOL bIsSysButton);
[in] pDC
[in] pBar
[in] rect
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton
A estrutura chama esse método quando preenche a tela de fundo de um botão de barra de ferramentas que pertence a uma lista de comandos. Essa lista de comandos faz parte da caixa de diálogo de personalização.
virtual COLORREF OnFillCommandsListBackground(
CDC* pDC,
CRect rect,
BOOL bIsSelected = FALSE);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão.
bIsSelected
[in] Um parâmetro booliano que indica se o botão está selecionado.
A cor do texto do botão de barra de ferramentas.
Para mais informações sobre a lista de personalização, confira CMFCToolBarButton::OnDrawOnCustomizeList. A implementação padrão para esse método preenche a tela de fundo com base no esquema de cores da capa selecionada no momento.
A estrutura chama esse método quando preenche a tela de fundo de um controle de cabeçalho.
virtual void OnFillHeaderCtrlBackground(
CMFCHeaderCtrl* pCtrl,
CDC* pDC,
CRect rect);
pCtrl
[in] Um ponteiro para um objeto CMFCHeaderCtrl. A estrutura preenche a tela de fundo para esse controle de cabeçalho.
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do controle de cabeçalho.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um controle de cabeçalho.
A estrutura chama esse método quando preenche a barra de legenda de uma janela com minimoldura.
virtual COLORREF OnFillMiniFrameCaption(
CDC* pDC,
CRect rectCaption,
CPaneFrameWnd* pFrameWnd,
BOOL bActive);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectCaption
[in] Um retângulo que especifica os limites da barra de legenda.
pFrameWnd
[in] Um ponteiro para uma janela com minimoldura. A estrutura desenha a barra de legenda para essa janela.
bActive
[in] Um parâmetro booliano que indica se a janela está ativa.
A cor que é usada para preencher a tela de fundo da barra de legenda.
A implementação padrão para esse método preenche a barra de legendas com a cor da legenda atual para a capa ativa.
A estrutura chama esse método quando preenche a tela de fundo de uma barra de legenda do Outlook.
virtual void OnFillOutlookBarCaption(
CDC* pDC,
CRect rectCaption,
COLORREF& clrText);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectCaption
[in] Um retângulo que especifica os limites da barra de legenda.
clrTexto
[out] Uma referência a um parâmetro COLORREF. O método grava a cor do texto na barra de legendas nesse parâmetro.
A implementação padrão desse método preenche a barra de legenda com a cor das sombras com base na capa atual. Substitua esse método em um gerenciador visual derivado para personalizar a cor da barra de legenda do Outlook.
A estrutura chama esse método quando preenche o interior de um botão de página do Outlook.
virtual void OnFillOutlookPageButton(
CDC* pDC,
const CRect& rect,
BOOL bIsHighlighted,
BOOL bIsPressed,
COLORREF& clrText);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do botão da página do Outlook.
bIsHighlighted
[in] Um parâmetro booliano que especifica se o botão está realçado.
bIsPressed
[in] Um parâmetro booliano que especifica se o botão é pressionado.
clrTexto
[out] Uma referência a um parâmetro COLORREF. Este método armazena a cor do texto do botão de página do Outlook neste parâmetro.
Substitua essa função em um gerenciador visual derivado para personalizar a aparência dos botões da página do Outlook.
A estrutura chama esse método quando preenche a tela de fundo de uma janela pop-up.
virtual void OnFillPopupWindowBackground(
CDC* pDC,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites da janela pop-up.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência das janelas pop-up.
A estrutura chama esse método quando preenche o interior de um botão da faixa de opções.
virtual COLORREF OnFillRibbonButton(
CDC* pDC,
CMFCRibbonButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para um objeto CMFCRibbonButton. A estrutura preenche o interior desse botão da faixa de opções.
A cor do texto para o botão da faixa de opções especificado por pButton, se o botão da faixa de opções der suporte para texto. Um valor de -1, se o texto for inválido para o botão da faixa de opções.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões da faixa de opções.
A estrutura chama esse método quando preenche o interior de uma instância da classe CMFCRibbonRichEditCtrl.
virtual void OnFillRibbonEdit(
CDC* pDC,
CMFCRibbonRichEditCtrl* pEdit,
CRect rect,
BOOL bIsHighlighted,
BOOL bIsPaneHighlighted,
BOOL bIsDisabled,
COLORREF& clrText,
COLORREF& clrSelBackground,
COLORREF& clrSelText);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pEdit
[in] Um ponteiro para um objeto CMFCRibbonRichEditCtrl. A estrutura preenche o interior desse controle de edição.
rect
[in] Um retângulo que especifica os limites do controle de edição.
bIsHighlighted
[in] Um parâmetro booliano que indica se o controle de edição está realçado.
bIsPaneHighlighted
[in] Um parâmetro booliano que indica se o painel pai está realçado.
bIsDisabled
[in] Um parâmetro booliano que indica se o controle de edição não está disponível.
clrTexto
[in] Uma referência à cor do texto do controle de edição.
clrSelBackground
[in] Uma referência à cor da tela de fundo do controle de edição quando é realçado.
clrSelText
[in] Uma referência à cor do texto selecionado no controle de edição.
O CMFCRibbonRichEditCtrl indicado por pEdit pode fazer parte de um botão de caixa de combinação na faixa de opções.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um arquivo CMFCRibbonRichEditCtrl.
A estrutura chama esse método quando preenche o interior de um botão da faixa de opções localizado no painel Principal.
virtual COLORREF OnFillRibbonMainPanelButton(
CDC* pDC,
CMFCRibbonButton* pButton);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pButton
[in] Um ponteiro para um objeto classe CMFCRibbonButton. A estrutura preenche esse botão da faixa de opções.
A cor do texto para o botão da faixa de opções especificado por pButton, se o botão da faixa de opções der suporte para texto. Um valor de -1, se o texto for inválido para o botão da faixa de opções.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos botões da faixa de opções no painel Principal.
A estrutura chama esse método quando preenche o quadro de menu do painel da faixa de opções.
virtual void OnFillRibbonMenuFrame(
CDC* pDC,
CMFCRibbonMainPanel* pPanel,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pPanel
[in] Um ponteiro para uma instância da classe CMFCRibbonMainPanel. A estrutura preenche o quadro de menu para esse painel da faixa de opções.
rect
[in] Um retângulo que especifica os limites do quadro de menu.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência da barra de menus do CMFCRibbonMainPanel.
virtual void OnFillRibbonQuickAccessToolBarPopup(
CDC* pDC,
CMFCRibbonPanelMenuBar* pMenuBar,
CRect rect);
[in] pDC
[in] pMenuBar
[in] rect
A estrutura chama esse método quando preenche a tela de fundo de uma janela divisora.
virtual void OnFillSplitterBackground(
CDC* pDC,
CSplitterWndEx* pSplitterWnd,
CRect rect);
pDC
[in] Um ponteiro para um contexto de dispositivo.
pSplitterWnd
[in] Um ponteiro para uma instância da classe CSplitterWndEx. A estrutura preenche a tela de fundo para esta janela divisora.
rect
[in] Um retângulo que especifica os limites da janela divisora.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de uma janela divisora.
A estrutura chama esse método quando preenche a tela de fundo de uma janela de guia.
virtual void OnFillTab(
CDC* pDC,
CRect rectFill,
CBrush* pbrFill,
int iTab,
BOOL bIsActive,
const CMFCBaseTabCtrl* pTabWnd);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectFill
[in] Um retângulo que especifica os limites da janela com guias.
pbrFill
[in] Um ponteiro para um pincel. A estrutura usa esse pincel para preencher a janela da guia.
iTab
[in] O índice de guia baseado em zero de uma guia para a qual a estrutura preenche a tela de fundo.
bIsActive
[in] TRUE se a guia estiver ativa, caso contrário, será FALSE.
pTabWnd
[in] Um ponteiro para o controle guia pai.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência das guias.
A estrutura chama esse método quando preenche o interior de um objeto CMFCTasksPaneTaskGroup.
virtual void OnFillTasksGroupInterior(
CDC* pDC,
CRect rect,
BOOL bSpecial = FALSE);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rect
[in] Um retângulo que especifica os limites do grupo de tarefas.
bSpecial
[in] Um booliano que indica se o interior está preenchido com uma cor especial.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um grupo de tarefas.
A estrutura chama esse método quando preenche a tela de fundo de um controle CMFCTasksPane.
virtual void OnFillTasksPaneBackground(
CDC* pDC,
CRect rectWorkArea);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectWorkArea
[in] Um retângulo que especifica os limites do painel de tarefas.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência de um objeto CMFCTasksPane.
A estrutura chama esse método quando desenha um item de menu realçado.
virtual void OnHighlightMenuItem(
CDC* pDC,
CMFCToolBarMenuButton* pButton,
CRect rect,
COLORREF& clrText);
pDC
[in] Um ponteiro para o contexto do dispositivo para um menu.
pButton
[in] Um ponteiro para um objeto CMFCToolBarMenuButton a ser exibido. A implementação padrão não usa esse parâmetro.
rect
[in] Um retângulo que especifica os limites do item de menu.
clrTexto
[in] A cor do texto atual dos itens de menu realçados. A implementação padrão não usa esse parâmetro.
A implementação padrão desse método não usa os parâmetros pButton ou clrText. O retângulo especificado é preenchido por rect com a cor da tela de fundo padrão.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos itens de menu realçados. Use o parâmetro clrText para modificar a cor do texto de um item de menu realçado.
A estrutura chama esse método quando desenha um comando de menu realçado.
virtual void OnHighlightRarelyUsedMenuItems(
CDC* pDC,
CRect rectRarelyUsed);
pDC
[in] Um ponteiro para um contexto de dispositivo.
rectRarelyUsed
[in] Um retângulo que especifica os limites do comando realçado.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência dos comandos de menu realçados.
virtual BOOL OnNcActivate(
CWnd* pWnd,
BOOL bActive);
[in] pWnd
[in] bActive
A estrutura chama esse método quando desenha a área de não cliente.
virtual BOOL OnNcPaint(
CWnd* pWnd,
const CObList& lstSysButtons,
CRect rectRedraw);
pWnd
[in] Um ponteiro para a janela cuja área de não cliente a estrutura desenha.
lstSysButtons
[in] Uma lista de botões do sistema. Também são conhecidos como botões de título.
rectRedraw
[in] Um retângulo que especifica os limites da área de não cliente.
Um valor reservado. A implementação padrão retorna FALSE.
Substitua esse método em um gerenciador visual derivado para personalizar a aparência do quadro da janela e botões de título.
A estrutura chama esse método depois de definir uma região que contém quadros e menus pop-up.
virtual BOOL OnSetWindowRegion(
CWnd* pWnd,
CSize sizeWindow);
pWnd
[in] Um ponteiro para a janela com a região que foi alterada.
sizeWindow
[in] O tamanho da janela.
TRUE se o método for bem-sucedido, caso contrário, será FALSE.
A estrutura chama esse método para notificar o gerenciador visual de que uma região foi definida para quadros e menus pop-up. Para obter mais informações, consulte CWindow::SetWindowRgn.
A estrutura chama essa função quando altera as cores do sistema.
virtual void OnUpdateSystemColors();
A estrutura chama esse método como parte do processamento da mensagem de WM_SYSCOLORCHANGE. A implementação padrão não tem ação. Substitua esse método em um gerenciador visual derivado se você quiser executar um código personalizado quando as cores mudarem em seu aplicativo.
Redesenha imediatamente todas as barras de controle no aplicativo.
static void RedrawAll();
virtual COLORREF RibbonCategoryColorToRGB(AFX_RibbonCategoryColor color);
[in] color
Define o gerenciador padrão.
static void SetDefaultManager(CRuntimeClass* pRTI);
pRTI
[in] Um ponteiro para as informações de tempo de execução de um gerenciador visual.
Use a classe CMFCVisualManager e os gerenciadores visuais derivados para personalizar a aparência do aplicativo. Após definir o gerenciador visual padrão, esse método redesenhará o aplicativo usando o novo gerenciador visual. Para obter mais informações sobre como usar os gerenciadores visuais, consulte Gerenciador de Visualização.
Use esse método para alterar o gerenciador visual que o aplicativo usa.
Habilita ou desabilita o modo colocado em alto-relevo para imagens da barra de ferramentas desabilitadas.
void SetEmbossDisabledImage (BOOL bEmboss = TRUE);
bEmboss
[in] Um parâmetro booliano que indica se deve habilitar o modo em relevo para imagens de barra de ferramentas desabilitadas.
Use a função CMFCVisualManager::IsEmbossDisabledImage para determinar se o modo colocado em alto-relevo está ativado.
Habilita ou desabilita o efeito de iluminação para imagens inativas em um menu ou uma barra de ferramentas.
void SetFadeInactiveImage(BOOL bFade = TRUE);
bFade
[in] Um parâmetro booliano que especifica se o efeito de iluminação deve ser habilitado.
Esse recurso controla se as imagens inativas aparecem esmaecidas em um menu ou em uma barra de ferramentas. Use o método CMFCVisualManager::IsFadeInactiveImage para determinar se esse recurso está habilitado.
Define um sinalizador que indica se os botões do menu parecem planos. Caso contrário, aparecem tridimensionais.
void SetMenuFlatLook(BOOL bMenuFlatLook = TRUE);
bMenuFlatLook
[in] Um parâmetro booliano que indica se os botões de menu aparecem planos.
Por padrão, esse recurso não está habilitado.
Define a largura e a altura da sombra do menu.
void SetMenuShadowDepth(int nDepth);
nDepth
[in] Um inteiro que especifica a profundidade da sombra do menu em pixels.
A altura e a largura da sombra do menu devem ser idênticas. O valor padrão é 7 pixels.
Define um sinalizador que indica se o CMFCVisualManager exibe sombras para imagens realçadas.
void SetShadowHighlightedImage(BOOL bShadow = TRUE);
bShadow
[in] Um parâmetro booliano que indica se o gerenciador visual exibe uma sombra nas imagens realçadas.
Por padrão, esse recurso está desativado.
Gráfico da hierarquia
Classes
CMFCVisualManager::GetInstance
Gerenciador de visualização