`CFrameWndEx` Třída

Článek
07/05/2024

Implementuje funkce rozhraní SDI (Single Document Interface) systému Windows překrývající se nebo automaticky otevírané okno rámečku a poskytuje členy pro správu okna. Rozšiřuje CFrameWnd třídu.

Syntaxe

class CFrameWndEx : public CFrameWnd

Členové

Veřejné metody

Název	Popis
`CFrameWndEx::ActiveItemRecalcLayout`	Upraví rozložení položky klienta OLE a oblasti klienta rámce.
`CFrameWndEx::AddDockSite`	Tato metoda se nepoužívá.
`CFrameWndEx::AddPane`	Zaregistruje ovládací panel ve správci ukotvení.
`CFrameWndEx::AdjustDockingLayout`	Přepočítá rozložení všech podoken ukotvených do okna rámečku.
`CFrameWndEx::DelayUpdateFrameMenu`	Nastaví nabídku rámečku a pak ji aktualizuje, když je zpracování příkazu nečinné.
`CFrameWndEx::DockPane`	Ukotví zadané podokno do okna rámečku.
`CFrameWndEx::DockPaneLeftOf`	Ukotví jedno podokno vlevo od jiného podokna.
`CFrameWndEx::EnableAutoHidePanes`	Povolí režim automatického skrytí pro podokna, když jsou ukotvená na určené strany okna hlavního rámečku.
`CFrameWndEx::EnableDocking`	Povolí ukotvení podoken, které patří do okna rámečku.
`CFrameWndEx::EnableFullScreenMainMenu`	Zobrazí nebo skryje hlavní nabídku v režimu celé obrazovky.
`CFrameWndEx::EnableFullScreenMode`	Povolí režim zobrazení na celé obrazovce pro okno rámečku.
`CFrameWndEx::EnableLoadDockState`	Povolí nebo zakáže načítání stavu ukotvení.
`CFrameWndEx::EnablePaneMenu`	Povolí nebo zakáže automatické zpracování nabídky podokna.
`CFrameWndEx::GetActivePopup`	Vrátí ukazatel na aktuálně zobrazenou místní nabídku.
`CFrameWndEx::GetDefaultResId`	Vrátí ID prostředku, které jste zadali při načtení rozhraní okna rámce.
`CFrameWndEx::GetDockingManager`	`CDockingManager` Načte objekt Třídy pro okno rámečku.
`CFrameWndEx::GetMenuBar`	Vrátí ukazatel na objekt řádku nabídek připojený k okně rámečku.
`CFrameWndEx::GetPane`	Vrátí ukazatel na podokno se zadaným ID.
`CFrameWndEx::GetRibbonBar`	Načte ovládací prvek pásu karet pro rámeček.
`CFrameWndEx::GetTearOffBars`	Vrátí seznam objektů podokna, které jsou ve stavu odtrhání.
`CFrameWndEx::GetToolbarButtonToolTipText`	Volá se rozhraním, když aplikace zobrazí popis tlačítka panelu nástrojů.
`CFrameWndEx::InsertPane`	Zaregistruje podokno ve správci ukotvení.
`CFrameWndEx::IsFullScreen`	Určuje, zda je okno rámečku v režimu celé obrazovky.
`CFrameWndEx::IsMenuBarAvailable`	Určuje, zda je ukazatel na objekt řádku nabídek platný.
`CFrameWndEx::IsPointNearDockSite`	Určuje, zda je bod umístěn v zóně zarovnání.
`CFrameWndEx::IsPrintPreview`	Určuje, jestli je okno rámečku v režimu náhledu tisku.
`CFrameWndEx::LoadFrame`	Tato metoda se volá po konstrukci, aby se vytvořilo okno rámce a načetly jeho prostředky.
`CFrameWndEx::NegotiateBorderSpace`	Implementuje vyjednávání ohraničení klienta OLE.
`CFrameWndEx::OnActivate`	Architektura volá tuto metodu, když se uživatelský vstup přepne do rámce nebo mimo rámec.
`CFrameWndEx::OnActivateApp`	Volá se rozhraním, pokud je aplikace vybrána nebo zrušena.
`CFrameWndEx::OnChangeVisualManager`	Volá se rozhraním, když změna rámce vyžaduje změnu správce vizuálů.
`CFrameWndEx::OnClose`	Architektura volá tuto metodu pro uzavření rámce.
`CFrameWndEx::OnCloseDockingPane`	Volá se rozhraním, když uživatel klikne na tlačítko Zavřít v dokovacím podokně.
`CFrameWndEx::OnCloseMiniFrame`	Volá se rozhraním, když uživatel klikne na tlačítko Zavřít v plovoucím mini rámečku okna.
`CFrameWndEx::OnClosePopupMenu`	Volá se rozhraním, když aktivní místní nabídka zpracuje `WM_DESTROY` zprávu.
`CFrameWndEx::OnCmdMsg`	Odesílá zprávy příkazů.
`CFrameWndEx::OnContextHelp`	Volá se rozhraním pro zobrazení nápovědy související s kontextem.
`CFrameWndEx::OnCreate`	Volá se rozhraním po vytvoření rámce.
`CFrameWndEx::OnDestroy`	Volané architekturou při zničení rámce.
`CFrameWndEx::OnDrawMenuImage`	Volá se rozhraním, když aplikace nakreslí obrázek přidružený k položce nabídky.
`CFrameWndEx::OnDrawMenuLogo`	Volá se rozhraním, když `CMFCPopupMenu` objekt zpracuje `WM_PAINT` zprávu.
`CFrameWndEx::OnDWMCompositionChanged`	Volá se architekturou, když je povolené nebo zakázané složení Správce oken plochy (DWM).
`CFrameWndEx::OnExitSizeMove`	Volá se architekturou, když se rámec přestane přesouvat nebo přemísťovat.
`CFrameWndEx::OnGetMinMaxInfo`	Volá se rozhraním při změně velikosti rámce, aby se nastavily limity rozměrů okna.
`CFrameWndEx::OnIdleUpdateCmdUI`	Volá se rozhraním pro aktualizaci zobrazení rámce při zpracování příkazu je nečinné.
`CFrameWndEx::OnLButtonDown`	Architektura volá tuto metodu, když uživatel stiskne levé tlačítko myši.
`CFrameWndEx::OnLButtonUp`	Architektura volá tuto metodu, když uživatel uvolní levé tlačítko myši.
`CFrameWndEx::OnMenuButtonToolHitTest`	Volá se rozhraním, když `CMFCToolBarButton` objekt zpracuje `WM_NCHITTEST` zprávu.
`CFrameWndEx::OnMenuChar`	Volá se rozhraním při zobrazení nabídky a uživatel stiskne klávesu, která neodpovídá příkazu.
`CFrameWndEx::OnMouseMove`	Architektura volá tuto metodu, když se ukazatel přesune.
`CFrameWndEx::OnMoveMiniFrame`	Volá se rozhraním, když se přesune okno podokna.
`CFrameWndEx::OnNcActivate`	Volá se rozhraním, pokud je nutné překreslit oblast rámce, která není klientem, aby bylo možné indikovat změnu v aktivním stavu.
`CFrameWndEx::OnNcCalcSize`	Volané architekturou, když se musí vypočítat velikost a umístění klientské oblasti.
`CFrameWndEx::OnNcHitTest`	Volané architekturou, když se ukazatel přesune nebo když je tlačítko myši stisknuto nebo uvolněno.
`CFrameWndEx::OnNcMouseMove`	Volá se architekturou, když se ukazatel přesune do jiné než klientské oblasti.
`CFrameWndEx::OnNcPaint`	Volané architekturou, když se musí vykreslit oblast, která není klientem.
`CFrameWndEx::OnPaneCheck`	Volá se rozhraním pro řízení viditelnosti podokna.
`CFrameWndEx::OnPostPreviewFrame`	Volá se rozhraním, když uživatel změnil režim náhledu tisku.
`CFrameWndEx::OnPowerBroadcast`	Volá se rozhraním, když dojde k události řízení spotřeby.
`CFrameWndEx::OnSetMenu`	Volá se rozhraním pro nahrazení nabídky okna rámečku.
`CFrameWndEx::OnSetPreviewMode`	Volal rozhraní pro nastavení režimu náhledu tisku pro rámeček.
`CFrameWndEx::OnSetText`	Volá se rozhraním pro nastavení textu okna.
`CFrameWndEx::OnShowCustomizePane`	Volá se rozhraním, když je povolené podokno rychlého přizpůsobení.
`CFrameWndEx::OnShowPanes`	Volá se rozhraním pro zobrazení nebo skrytí podoken.
`CFrameWndEx::OnShowPopupMenu`	Volá se rozhraním, když je povolená místní nabídka.
`CFrameWndEx::OnSize`	Architektura volá tuto metodu po změně velikosti rámce.
`CFrameWndEx::OnSizing`	Architektura volá tuto metodu, když uživatel změní velikost rámce.
`CFrameWndEx::OnSysColorChange`	Volá se rozhraním při změně systémových barev.
`CFrameWndEx::OnTearOffMenu`	Volá se rozhraním, pokud je povolená nabídka s odtrženou lištou.
`CFrameWndEx::OnToolbarContextMenu`	Volá se rozhraním pro vytvoření místní nabídky panelu nástrojů.
`CFrameWndEx::OnToolbarCreateNew`	Architektura volá tuto metodu pro vytvoření nového panelu nástrojů.
`CFrameWndEx::OnToolbarDelete`	Volá se rozhraním při odstranění panelu nástrojů.
`CFrameWndEx::OnUpdateFrameMenu`	Volá se rozhraním pro nastavení nabídky rámečku.
`CFrameWndEx::OnUpdateFrameTitle`	Architektura volá tuto metodu pro aktualizaci záhlaví okna rámečku.
`CFrameWndEx::OnUpdatePaneMenu`	Volá se rozhraním pro aktualizaci nabídky podokna.
`CFrameWndEx::OnWindowPosChanged`	Volá se architekturou, když se změnila velikost rámce, pozice nebo pořadí vykreslování kvůli volání metody správy oken.
`CFrameWndEx::PaneFromPoint`	Vrátí dokovací podokno, které obsahuje zadaný bod.
`CFrameWndEx::PreTranslateMessage`	Zpracovává konkrétní zprávy okna před odesláním.
`CFrameWndEx::RecalcLayout`	Upraví rozložení rámečku a jeho podřízených oken.
`CFrameWndEx::RemovePaneFromDockManager`	Zruší registraci podokna a odebere ho z interního seznamu ve správci ukotvení.
`CFrameWndEx::SetDockState`	Obnoví dokovací rozložení do stavu ukotvení uloženého v registru.
`CFrameWndEx::SetPrintPreviewFrame`	Nastaví okno rámečku náhledu tisku.
`CFrameWndEx::SetupToolbarMenu`	Vloží uživatelem definované příkazy do nabídky panelu nástrojů.
`CFrameWndEx::ShowFullScreen`	Přepne hlavní rámec mezi celou obrazovkou a běžnými režimy.
`CFrameWndEx::ShowPane`	Zobrazí nebo skryje zadané podokno.
`CFrameWndEx::UpdateCaption`	Volá se rozhraním pro aktualizaci titulku rámečku okna.
`CFrameWndEx::WinHelp`	Vyvolá nápovědu `WinHelp` související s aplikací nebo kontextem.

Příklad

Následující příklad ukazuje, jak dědit třídu z CFrameWndEx třídy. Příklad znázorňuje podpisy metody v podtřídě a jak přepsat metodu OnShowPopupMenu . Tento fragment kódu je součástí ukázky wordové oblasti.

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
   CMainFrame();
   DECLARE_DYNCREATE(CMainFrame)

   // Attributes
public:
   HICON m_hIconDoc;
   HICON m_hIconText;
   HICON m_hIconWrite;
   HICON GetIcon(int nDocType);

   // Operations
public:
   void UpdateMRUFilesList()
   {
      m_wndTaskPane.UpdateMRUFilesList();
   }

   void OnChangeLook();

   // Overrides
   // ClassWizard generated virtual function overrides
   //{{AFX_VIRTUAL(CMainFrame)
public:
   virtual void ActivateFrame(int nCmdShow = -1);
   virtual BOOL LoadFrame(UINT nIDResource,
                          DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
                          CWnd *pParentWnd = NULL,
                          CCreateContext *pContext = NULL);

protected:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
   //}}AFX_VIRTUAL

   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);
   virtual BOOL OnTearOffMenu(CMFCPopupMenu *pMenuPopup, CPane *pBar);

protected:
   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void AdjustColorsMenu(CMFCPopupMenu *pMenuPopup, UINT uiId);

   // Implementation
public:
   virtual ~CMainFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

public:
   CMFCMenuBar m_wndMenuBar;
   CMFCToolBar m_wndToolBar;
   CMFCStatusBar m_wndStatusBar;
   CFormatBar m_wndFormatBar;
   CRulerBar m_wndRulerBar;
   CTaskPane m_wndTaskPane;

protected: // control bar embedded members
   BOOL CreateMenuBar();
   BOOL CreateToolBar();
   BOOL CreateFormatBar();
   BOOL CreateStatusBar();
   BOOL CreateRulerBar();
   BOOL CreateTaskPane();

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnSysColorChange();
   afx_msg void OnSize(UINT nType, int cx, int cy);
   afx_msg void OnMove(int x, int y);
   afx_msg void OnHelpFinder();
   afx_msg void OnDropFiles(HDROP hDropInfo);
   afx_msg void OnFontChange();
   afx_msg BOOL OnQueryNewPalette();
   afx_msg void OnPaletteChanged(CWnd *pFocusWnd);
   afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
   afx_msg void OnViewCustomize();
   afx_msg void OnViewFullScreen();
   //}}AFX_MSG
   afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnToolbarCreateNew(WPARAM, LPARAM);
   afx_msg LRESULT OnGetDocumentColors(WPARAM, LPARAM);
   afx_msg void OnDummy();
   afx_msg void OnAskQuestion();
   DECLARE_MESSAGE_MAP()
};

// CMainFrame is application-defined object of type CFrameWndEx
BOOL CMainFrame::OnShowPopupMenu(CMFCPopupMenu *pMenuPopup)
{
   BOOL bRes = CFrameWndEx::OnShowPopupMenu(pMenuPopup);

   if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
   {
      AdjustObjectSubmenu(pMenuPopup);
      AdjustColorsMenu(pMenuPopup, ID_CHAR_COLOR);
   }

   return bRes;
}

Hierarchie dědičnosti

Požadavky

Záhlaví: afxframewndex.h

`CFrameWndEx::ActiveItemRecalcLayout`

Upraví rozložení položky klienta OLE a oblasti klienta rámce.

void ActiveItemRecalcLayout();

Poznámky

`CFrameWndEx::AddPane`

Zaregistruje ovládací panel ve správci ukotvení.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail=TRUE);

Parametry

pControlBar
[v] Podokno řídicího panelu, které se má zaregistrovat.

bTail
[v] TRUE pokud chcete přidat podokno řídicího panelu na konec seznamu; FALSE jinak.

Návratová hodnota

TRUE pokud byl řídicí panel úspěšně zaregistrován; FALSE jinak.

`CFrameWndEx::AdjustDockingLayout`

Přepočítá rozložení všech podoken ukotvených do okna rámečku.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parametry

hdwp
Popisovač struktury, která obsahuje pozice více oken. .

Poznámky

Struktura hdwp je inicializována metodou BeginDeferWindowPos .

`CFrameWndEx::DelayUpdateFrameMenu`

Nastaví nabídku rámečku a pak ji aktualizuje, když je zpracování příkazu nečinné.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parametry

hMenuAlt
[v] Popisovač v alternativní nabídce

Poznámky

`CFrameWndEx::DockPane`

Ukotví zadané podokno do okna rámečku.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID=0,
    LPCRECT lpRect=NULL);

Parametry

pBar
[v] Ukazatel na řídicí panel, který se má ukotvit.

nDockBarID
[v] ID strany okna rámečku, do které se má ukotvit.

lpRect
[v] Ukazatel na konstantní Rect strukturu, která určuje umístění a velikost obrazovky okna.

Poznámky

Parametr nDockBarID může mít jednu z následujících hodnot:

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

Ukotví zadané podokno vlevo od jiného podokna.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parametry

pBar
[v] Ukazatel na objekt podokna, který se má ukotvit.

pLeftOf
[v] Ukazatel na podokno nalevo od kterého chcete ukotvit podokno určené .pBar

Návratová hodnota

TRUE pokud pBar je úspěšně ukotveno. FALSE jinak.

Poznámky

Metoda vezme panel nástrojů určený parametrem pBar a ukotví ho na levé straně panelu nástrojů určeného parametrem pLeftOf .

`CFrameWndEx::EnableAutoHidePanes`

Povolí režim automatického skrytí podokna, když je ukotvený na zadanou stranu okna hlavního rámce.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametry

dwDockStyle
[v] Určuje stranu okna hlavního rámce, do kterého se má podokno ukotvit.

Návratová hodnota

TRUE pokud je podokno pruhu úspěšně ukotveno na straně okna rámečku určené dwDockStyle, FALSE jinak.

Poznámky

dwDockStyle může mít jednu z následujících hodnot:

CBRS_ALIGN_TOP: Umožňuje ukotvit ovládací panel do horní části klientské oblasti okna rámečku.
CBRS_ALIGN_BOTTOM: Umožňuje ukotvit ovládací panel do dolní části klientské oblasti okna rámečku.
CBRS_ALIGN_LEFT: Umožňuje ukotvit ovládací panel na levou stranu klientské oblasti okna rámečku.
CBRS_ALIGN_RIGHT: Umožňuje ukotvit ovládací panel na pravou stranu klientské oblasti okna rámečku.

`CFrameWndEx::EnableDocking`

Povolí ukotvení podoken okna rámečku.

BOOL EnableDocking(DWORD dwDockStyle);

Parametry

dwDockStyle
[v] Určuje stranu okna hlavního rámečku, kde se ukotvení panelu podokna.

Návratová hodnota

TRUE pokud je možné podokno pruhu úspěšně ukotvit na zadanou stranu. FALSE jinak.

Poznámky

Parametr dwDockStyle může mít jednu z následujících hodnot:

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

Zobrazí nebo skryje hlavní nabídku v režimu celé obrazovky.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parametry

bEnableMenu
[v] TRUE chcete-li zobrazit hlavní nabídku v režimu celé obrazovky, FALSE jinak.

`CFrameWndEx::EnableFullScreenMode`

Povolí režim zobrazení na celé obrazovce pro okno rámečku.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parametry

uiFullScreenCmd
[v] ID příkazu, který povolí a zakáže režim zobrazení na celé obrazovce.

Poznámky

V režimu zobrazení na celé obrazovce jsou všechny dokovací řídicí panely, panely nástrojů a nabídka skryté a aktivní zobrazení se změní tak, aby zabíraly celou obrazovku.

Když povolíte režim zobrazení na celé obrazovce, musíte zadat ID příkazu, který povolí nebo zakáže režim zobrazení na celé obrazovce. Můžete volat EnableFullScreenMode z funkce hlavního OnCreate rámce. Když se okno rámečku přepne do režimu celé obrazovky, vytvoří architektura plovoucí panel nástrojů s jedním tlačítkem, které má zadané ID příkazu.

Pokud chcete zachovat hlavní nabídku na obrazovce, zavolejte CFrameWndEx::EnableFullScreenMainMenu.

`CFrameWndEx::EnableLoadDockState`

Povolí nebo zakáže načítání stavu ukotvení.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parametry

bEnable
[v] TRUE pokud chcete povolit načítání dokovacího stavu, FALSE zakažte načítání stavu ukotvení.

`CFrameWndEx::EnablePaneMenu`

Povolí nebo zakáže automatické zpracování nabídky podokna.

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

Parametry

bEnable
[v] TRUE povolení automatického zpracování automaticky otevíraných nabídek řídicího panelu; FALSE zakázat automatické zpracování automaticky otevíraných nabídek řídicího panelu.

uiCustomizeCmd
[v] ID příkazu položky nabídky Přizpůsobit

strCustomizeLabel
[v] Popisek, který se má zobrazit pro položku nabídky Přizpůsobit

uiViewToolbarsMenuEntryID
[v] ID položky nabídky panelu nástrojů, která otevře místní nabídku na ovládacím panelu.

bContextMenuShowsToolbarsOnly
[v] Pokud TRUEse v místní nabídce řídicího panelu zobrazí pouze seznam panelů nástrojů. Pokud FALSE, nabídka zobrazí seznam panelů nástrojů a dokovací pruhy.

bViewMenuShowsToolbarsOnly
[v] Pokud TRUEse v nabídce řídicího řádku zobrazí jenom seznam panelů nástrojů. Pokud FALSE, nabídka zobrazí seznam panelů nástrojů a dokovací pruhy.

`CFrameWndEx::GetActivePopup`

Vrátí ukazatel na aktuálně zobrazenou místní nabídku.

CMFCPopupMenu* GetActivePopup() const;

Návratová hodnota

Ukazatel na aktuálně zobrazenou místní nabídku; jinak NULL.

`CFrameWndEx::GetDefaultResId`

Vrátí ID prostředku, které jste zadali při načtení rozhraní okna rámce.

UINT GetDefaultResId() const;

Návratová hodnota

Hodnota ID prostředku, kterou uživatel zadal při načtení okna rámce. Nula, pokud okno rámečku nemá řádek nabídek.

`CFrameWndEx::GetDockingManager`

CDockingManager Načte objekt Třídy pro okno rámečku.

CDockingManager* GetDockingManager();

Návratová hodnota

Ukazatel na CDockingManager třídu.

Poznámky

Okno rámce vytvoří a použije CDockingManager objekt třídy ke správě ukotvení podřízených oken.

`CFrameWndEx::GetMenuBar`

Vrátí ukazatel na objekt řádku nabídek připojený k okně rámečku.

const CMFCMenuBar* GetMenuBar() const;

Návratová hodnota

Ukazatel na objekt řádku nabídek připojený k oknem rámečku.

`CFrameWndEx::GetPane`

Vrátí ukazatel na podokno se zadaným ID.

CBasePane* GetPane(UINT nID);

Parametry

nID
[v] ID ovládacího prvku.

Návratová hodnota

Ukazatel na podokno se zadaným ID. NULL pokud takové podokno neexistuje.

`CFrameWndEx::GetRibbonBar`

Načte ovládací prvek pásu karet pro rámeček.

CMFCRibbonBar* GetRibbonBar();

Návratová hodnota

Ukazatel na CMFCRibbonBar třídu rámce.

Poznámky

`CFrameWndEx::GetTearOffBars`

Vrátí seznam objektů podokna, které jsou ve stavu odtrhání.

const CObList& GetTearOffBars() const;

Návratová hodnota

Odkaz na CObList objekt, který obsahuje kolekci ukazatelů na objekty podokna, které jsou ve stavu odtrhání.

`CFrameWndEx::GetToolbarButtonToolTipText`

Volá se rozhraním, když aplikace zobrazí popis tlačítka panelu nástrojů.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Parametry

pButton
[v] Ukazatel na tlačítko panelu nástrojů

strTTText
[v] Text popisu, který se má zobrazit pro tlačítko.

Návratová hodnota

TRUE pokud byl zobrazen popis. FALSE jinak.

Poznámky

Ve výchozím nastavení tato metoda nedělá nic. Tuto metodu přepište, pokud chcete zobrazit popis tlačítka panelu nástrojů.

`CFrameWndEx::InsertPane`

Vloží podokno do seznamu ovládacích panelů a zaregistruje ho ve správci ukotvení.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter=TRUE);

Parametry

pControlBar
Ukazatel na ovládací panel, který se má vložit do seznamu řídicích pruhů a zaregistrovaný ve správci ukotvení.

pTarget
Ukazatel na ovládací panel před nebo za něj, do kterého chcete vložit podokno.

bAfter
TRUE pokud chcete vložit pControlBar za pTarget, FALSE jinak.

Návratová hodnota

TRUE pokud byl řídicí panel úspěšně vložen a zaregistrován, FALSE jinak.

Poznámky

Každý ovládací panel je nutné zaregistrovat pomocí CDockingManager třídy , abyste se mohli zúčastnit rozložení ukotvení.

`CFrameWndEx::IsFullScreen`

Určuje, zda je okno rámečku v režimu celé obrazovky.

BOOL IsFullScreen() const;

Návratová hodnota

TRUE je-li okno rámečku v režimu celé obrazovky; jinak FALSE.

Poznámky

Režim zobrazení na celé obrazovce můžete nastavit voláním CFrameWndEx::EnableFullScreenMode metody.

`CFrameWndEx::IsMenuBarAvailable`

Určuje, zda je ukazatel na objekt řádku nabídek platný.

BOOL IsMenuBarAvailable() const;

Návratová hodnota

TRUE pokud má okno s rámečkem řádek nabídek; jinak FALSE.

`CFrameWndEx::IsPointNearDockSite`

Určuje, zda je bod umístěn v zóně zarovnání.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parametry

point
[v] Pozice bodu.

dwBarAlignment
[ven] Kde je bod zarovnaný. Možné hodnoty najdete v tabulce v části Poznámky .

bOuterEdge
[ven] TRUE je-li bod umístěn blízko ohraničení rámečku; FALSE pokud se bod nachází v klientské oblasti.

Návratová hodnota

TRUEje-li bod umístěn v zóně zarovnání; v opačném případě . FALSE

Poznámky

Následující tabulka uvádí možné hodnoty parametru dwBarAlignment .

Hodnota	Popis
`CBRS_ALIGN_TOP`	Zarovná se k horní části.
`CBRS_ALIGN_RIGHT`	Zarovnané doprava.
`CBRS_ALIGN_BOTTOM`	Zarovnané do dolní části.
`CBRS_ALIGN_LEFT`	Zarovnané doleva.

`CFrameWndEx::IsPrintPreview`

Určuje, zda je okno rámečku v režimu náhledu tisku.

BOOL IsPrintPreview();

Návratová hodnota

TRUEpokud je okno rámečku v režimu náhledu tisku; v opačném případě . FALSE

Poznámky

`CFrameWndEx::LoadFrame`

Tato metoda se volá po konstrukci, aby se vytvořilo okno rámce a načetly jeho prostředky.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Parametry

nIDResource
[v] ID prostředku, které se používá k načtení všech prostředků rámce.

dwDefaultStyle
[v] Výchozí styl okna rámečku.

pParentWnd
[v] Ukazatel na nadřazené okno rámce.

pContext
[v] Ukazatel na CCreateContext třídu Struktury , která je používána architekturou při vytváření aplikace.

Návratová hodnota

TRUEpokud byla metoda úspěšná; v opačném případě . FALSE

Poznámky

`CFrameWndEx::NegotiateBorderSpace`

Implementuje vyjednávání ohraničení klienta OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parametry

nBorderCmd
[v] Příkaz pro vyjednávání hranic. Možné hodnoty najdete v části Poznámky .

lpRectBorder
[in, out] Rozměry ohraničení.

Návratová hodnota

TRUEje-li nutné přepočítat rozložení; v opačném případě . FALSE

Poznámky

Následující tabulka uvádí možné hodnoty parametru nBorderCmd .

borderGet
Získejte dostupný klientský prostor OLE.

borderRequest
Požádejte o klientský prostor OLE.

borderSet
Nastavte klientský prostor OLE.

`CFrameWndEx::OnActivate`

Architektura volá tuto metodu, když se uživatelský vstup přepne do rámce nebo mimo rámec.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parametry

nState
[v] Bez ohledu na to, jestli je rámec aktivní nebo neaktivní. Možné hodnoty najdete v tabulce v části Poznámky .

pWndOther
[v] Ukazatel na jiné okno, které přepíná uživatelský vstup s aktuálním oknem.

bMinimized
[v] Minimalizovaný stav rámce. TRUEje-li rámec minimalizován; v opačném případě . FALSE

Poznámky

Následující tabulka uvádí možné hodnoty parametru nState .

Hodnota	Popis
`WA_ACTIVE`	Rámeček je vybrán jinou metodou, než je kliknutí myší.
`WA_CLICKACTIVE`	Rámeček je vybrán kliknutím myši.
`WA_INACTIVE`	Rámeček není vybraný.

`CFrameWndEx::OnActivateApp`

Volá se rozhraním, pokud je aplikace vybrána nebo zrušena.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parametry

bActive
[v] TRUE je-li vybrána aplikace; FALSE pokud aplikace není vybraná.

dwThreadID
[v] Tento parametr se nepoužívá.

Poznámky

`CFrameWndEx::OnChangeVisualManager`

Volá se rozhraním, když změna rámce vyžaduje změnu správce vizuálů.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[v] Tento parametr se nepoužívá.

lParam
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu 0.

Poznámky

`CFrameWndEx::OnClose`

Architektura volá tuto metodu pro uzavření rámce.

afx_msg void OnClose();

Poznámky

Pokud je rámeček v režimu náhledu tisku, odešle zprávu systému Windows, která zavře náhled tisku; v opačném případě, pokud rámec hostuje klienta OLE, je klient deaktivován.

`CFrameWndEx::OnCloseDockingPane`

Volá se rozhraním, když uživatel klikne na tlačítko Zavřít v dokovacím podokně.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Návratová hodnota

TRUE pokud lze ukotvit bar. FALSE jinak

Poznámky

Výchozí implementace nic nedělá. Tuto metodu přepište, pokud chcete zpracovat skrytí ukotvení pruhu.

`CFrameWndEx::OnCloseMiniFrame`

Volá se rozhraním, když uživatel klikne na tlačítko Zavřít v plovoucím mini rámečku okna.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Návratová hodnota

TRUE pokud lze zavřít plovoucí minirámeček okna. FALSE jinak.

Poznámky

Výchozí implementace nic nedělá. Tuto metodu přepište, pokud chcete zpracovat skrytí plovoucího mini rámečku okna.

`CFrameWndEx::OnClosePopupMenu`

Volá se rozhraním, když aktivní místní nabídka zpracuje WM_DESTROY zprávu.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parametry

pMenuPopup
Ukazatel na místní nabídku

Poznámky

Rozhraní odešle WM_DESTROY zprávu, když se chystá okno zavřít. Tuto metodu přepište, pokud chcete zpracovat oznámení z CMFCPopupMenu objektů, které patří do okna rámce, když CMFCPopupMenu objekt zpracovává zprávu odesílanou WM_DESTROY architekturou při zavření okna.

`CFrameWndEx::OnCmdMsg`

Odesílá zprávy příkazů.

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parametry

nID
[v] ID příkazu.

nCode
[v] Kategorie zprávy příkazu

pExtra
[in, out] Ukazatel na objekt příkazu.

pHandlerInfo
[in, out] Ukazatel na strukturu obslužné rutiny příkazu

Návratová hodnota

TRUEpokud byla zpracována zpráva příkazu; v opačném případě . FALSE

Poznámky

`CFrameWndEx::OnContextHelp`

Zavolá se rozhraním pro zobrazení nápovědy související s kontextem.

afx_msg void OnContextHelp();

Poznámky

`CFrameWndEx::OnCreate`

Volá se rozhraním po vytvoření rámce.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parametry

lpCreateStruct
[v] Ukazatel na CREATESTRUCT strukturu pro nový rámec.

Návratová hodnota

0 pokračovat vytvořením rámce; -1 zničit rám.

Poznámky

`CFrameWndEx::OnDestroy`

Volané architekturou při zničení rámce.

afx_msg void OnDestroy();

Poznámky

Tabulka akcelerátorů a všechna okna jsou zničena.

`CFrameWndEx::OnDrawMenuImage`

Volá se rozhraním, když aplikace nakreslí obrázek přidružený k položce nabídky.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Parametry

pDC
[v] Ukazatel na kontext zařízení.

pMenuButton
[v] Ukazatel na tlačítko nabídky, jehož obrázek se vykresluje.

rectImage
[v] Ukazatel na Rect strukturu, která určuje umístění a velikost obrazovky obrázku.

Návratová hodnota

TRUE pokud architektura úspěšně vykresluje image; FALSE jinak.

Poznámky

Tuto metodu přepište, pokud chcete přizpůsobit vykreslování obrázků pro položky nabídky, které patří do řádku nabídek vlastněného odvozeným objektem CFrameWndEx .

`CFrameWndEx::OnDrawMenuLogo`

Volá se rozhraním, když CMFCPopupMenu objekt zpracuje WM_PAINT zprávu.

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

Parametry

pDC
[v] Ukazatel na kontext zařízení.

pMenu
[v] Ukazatel na položku nabídky.

rectLogo
[v] Odkaz na konstantní CRect strukturu, která určuje umístění a velikost obrazovky loga nabídky.

Poznámky

Tuto funkci přepište, pokud chcete zobrazit logo v místní nabídce, která patří do řádku nabídek vlastněného odvozeným CFrameWndEx objektem.

`CFrameWndEx::OnDWMCompositionChanged`

Volá se architekturou, když je povolené nebo zakázané složení Správce oken plochy (DWM).

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[v] Tento parametr se nepoužívá.

lp
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu 0.

Poznámky

`CFrameWndEx::OnExitSizeMove`

Volá se architekturou, když se rámec přestane přesouvat nebo přemísťovat.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[v] Tento parametr se nepoužívá.

lp
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu 0.

Poznámky

`CFrameWndEx::OnGetMinMaxInfo`

Volá se rozhraním při změně velikosti rámce, aby se nastavily limity rozměrů okna.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parametry

lpMMI
[v] Ukazatel na MINMAXINFO strukturu

Poznámky

`CFrameWndEx::OnIdleUpdateCmdUI`

Volá se rozhraním pro aktualizaci zobrazení rámce při zpracování příkazu je nečinné.

afx_msg LRESULT OnIdleUpdateCmdUI(
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Parametry

wParam
[v] Tento parametr se nepoužívá.

lParam
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu 0.

Poznámky

`CFrameWndEx::OnLButtonDown`

Architektura volá tuto metodu, když uživatel stiskne levé tlačítko myši.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parametry

nFlags
[v] Určuje, jestli uživatel stiskl modifikační klávesy. Možné hodnoty najdete v WM_LBUTTONDOWN části wParam Notification.

point
[v] Určuje souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.

Poznámky

`CFrameWndEx::OnLButtonUp`

Architektura volá tuto metodu, když uživatel uvolní levé tlačítko myši.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parametry

nFlags
[v] Určuje, jestli uživatel stiskl modifikační klávesy. Možné hodnoty najdete v WM_LBUTTONUP části wParam Notification.

point
[v] Určuje souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.

Poznámky

`CFrameWndEx::OnMenuButtonToolHitTest`

Volá se rozhraním, když CMFCToolBarButton objekt zpracuje WM_NCHITTEST zprávu.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Parametry

pButton
[v] Ukazatel na tlačítko panelu nástrojů.

pTI
[ven] Ukazatel na strukturu informací o nástroji.

Návratová hodnota

TRUE pokud aplikace vyplní pTI parametr. FALSE jinak.

Poznámky

Tuto metodu přepište, pokud chcete zadat informace o konkrétní položce nabídky.

`CFrameWndEx::OnMenuChar`

Volá se rozhraním při zobrazení nabídky a uživatel stiskne klávesu, která neodpovídá příkazu.

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

Parametry

nChar
[v] Znakový kód stisknuté klávesy

nFlags
[v] MF_POPUP Obsahuje příznak, pokud zobrazená nabídka je podnabídka. Obsahuje MF_SYSMENU příznak, pokud je zobrazená nabídka ovládacím panelem.

pMenu
[v] Ukazatel na nabídku.

Návratová hodnota

Slovo s vysokým pořadím musí být jednou z následujících hodnot.

Hodnota	Popis
`0`	Architektura by měla ignorovat stisknutí klávesy.
`1`	Architektura by měla zavřít nabídku.
`2`	Architektura by měla vybrat jednu z položek zobrazených v nabídce. Slovo s nízkým pořadím obsahuje ID příkazu, které chcete vybrat.

`CFrameWndEx::OnMouseMove`

Architektura volá tuto metodu, když se ukazatel přesune.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parametry

nFlags
[v] Určuje, jestli uživatel stiskl modifikační klávesy. Možné hodnoty najdete v WM_MOUSEMOVE části wParam Notification.

point
[v] Určuje x a y souřadnice ukazatele vzhledem k levému hornímu rohu okna.

Poznámky

`CFrameWndEx::OnMoveMiniFrame`

Volá se rozhraním, když se přesune okno podokna.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametry

pFrame
[v] Ukazatel na okno podokna CPaneFrameWnd Třída

Návratová hodnota

TRUE pokud okno podokna nebylo ukotveno; FALSE pokud bylo okno podokna ukotveno.

Poznámky

`CFrameWndEx::OnNcActivate`

Volá se rozhraním, pokud je nutné překreslit oblast rámce, která není klientem, aby bylo možné indikovat změnu v aktivním stavu.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parametry

bActive
[v] TRUE nakreslit aktivní rám; FALSE a nakreslete rámeček neaktivní.

Návratová hodnota

Nenulové pokračovat ve výchozím zpracování; 0, aby se zabránilo deaktivaci nekližní oblasti.

Poznámky

`CFrameWndEx::OnNcCalcSize`

Volané architekturou, když se musí vypočítat velikost a umístění klientské oblasti.

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS FAR* lpncsp);

Parametry

bCalcValidRects
[v] TRUE pokud aplikace musí zadat platnou klientskou oblast; v opačném případě . FALSE

lpncsp
[v] Ukazatel na NCCALCSIZE_PARAMS strukturu, která obsahuje změny rozměru rámce.

Poznámky

`CFrameWndEx::OnNcHitTest`

Volané architekturou, když se ukazatel přesune nebo když je tlačítko myši stisknuto nebo uvolněno.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parametry

point
[v] Umístění ukazatele na souřadnicích obrazovky.

Návratová hodnota

Hodnota výčtu ukazatele Seznam možných hodnot najdete v části WM_NCHITTEST Oznámení.

Poznámky

`CFrameWndEx::OnNcMouseMove`

Volá se architekturou, když se ukazatel přesune do jiné než klientské oblasti.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parametry

nHitTest
[v] Hodnota výčtu ukazatele Seznam možných hodnot najdete v části WM_NCHITTEST Oznámení.

point
[v] Umístění ukazatele na souřadnicích obrazovky.

Poznámky

`CFrameWndEx::OnNcPaint`

Volané architekturou, když se musí vykreslit oblast, která není klientem.

afx_msg void OnNcPaint();

Poznámky

`CFrameWndEx::OnPaneCheck`

Volá se rozhraním pro řízení viditelnosti podokna.

afx_msg BOOL OnPaneCheck(UINT nID);

Parametry

nID
[v] ID ovládacího prvku podokna

Návratová hodnota

TRUE pokud byl příkaz zpracován; FALSE pokračujte v zpracování příkazů.

Poznámky

`CFrameWndEx::OnPostPreviewFrame`

Volá se rozhraním, když uživatel změní režim náhledu tisku.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[v] Tento parametr se nepoužívá.

lParam
[v] TRUE pokud je rámeček v režimu náhledu tisku; FALSE když je režim náhledu tisku vypnutý.

Návratová hodnota

Vždy vrátí hodnotu 0.

Poznámky

`CFrameWndEx::OnPowerBroadcast`

Volá se rozhraním, když dojde k události řízení spotřeby.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[v] Událost řízení spotřeby. Seznam možných hodnot naleznete v tématu WM_POWERBROADCAST Zpráva.

lp
[v] Tento parametr se nepoužívá.

Návratová hodnota

Výsledek volání výchozí procedury okna

Poznámky

`CFrameWndEx::OnSetMenu`

Volá se rozhraním pro nahrazení nabídky okna rámečku.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parametry

wp
[v] Úchyt pro novou nabídku okna s rámečkem

lp
[v] Úchyt pro novou nabídku okna

hmenu
[v] Úchyt pro novou nabídku okna s rámečkem

Návratová hodnota

LRESULT je výsledkem volání výchozí procedury okna.

BoOL je TRUE , pokud byla událost zpracována, FALSEjinak .

Poznámky

`CFrameWndEx::OnSetPreviewMode`

Volal rozhraní pro nastavení režimu náhledu tisku pro rámeček.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parametry

bPreview
[v] TRUE povolení náhledu tisku; FALSE zakázat náhled tisku.

pState
[v] Ukazatel na CPrintPreviewState strukturu stavu rámce

Poznámky

`CFrameWndEx::OnSetText`

Volá se rozhraním pro nastavení textu okna.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[v] Tento parametr se nepoužívá.

lParam
[v] Ukazatel na text okna

Návratová hodnota

Vrátí hodnotu z volání do DefWindowProc.

Poznámky

`CFrameWndEx::OnShowCustomizePane`

Volá se rozhraním při zobrazení .QuickCustomizePane

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Parametry

pMenuPane
[v] Ukazatel na podokno rychlého přizpůsobení

uiToolbarID
[v] ID ovládacího prvku panelu nástrojů, které chcete přizpůsobit.

Návratová hodnota

Tato metoda vždy vrátí TRUE.

Poznámky

Nabídka Rychlé přizpůsobení je místní nabídka, která se zobrazí po kliknutí na tlačítko přizpůsobení panelu nástrojů.

`CFrameWndEx::OnShowPanes`

Volá se rozhraním pro zobrazení nebo skrytí podoken.

virtual BOOL OnShowPanes(BOOL bShow);

Parametry

bShow
[v] TRUE pokud aplikace zobrazí podokna; FALSE jinak.

Návratová hodnota

Tato metoda vždy vrátí FALSE.

Poznámky

Výchozí implementace zobrazuje podokna, pokud bShow je TRUE a podokna jsou skrytá nebo kdy bShow FALSE a podokna jsou viditelná.

Výchozí implementace skryje podokna, pokud bShow jsou TRUE a podokna jsou viditelná nebo kdy bShow FALSE a podokna jsou skrytá.

Přepište tuto metodu v odvozené třídě, aby se spustil vlastní kód, když architektura zobrazí nebo skryje podokna.

`CFrameWndEx::OnShowPopupMenu`

Volá se podle architektury, když zobrazí místní nabídku.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parametry

pMenu
[v] Ukazatel na místní nabídku

Návratová hodnota

TRUE pokud je zobrazena místní nabídka; jinak FALSE.

Poznámky

Tuto metodu v odvozené třídě přepište tak, aby se spustil vlastní kód, když architektura zobrazí místní nabídku. Například přepsat tuto metodu změnit barvu pozadí příkazů v místní nabídce.

`CFrameWndEx::OnSize`

Volá se rozhraním po změně velikosti rámce.

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

Parametry

nType
[v] Typ změny velikosti. Možné hodnoty najdete v WM_SIZE wParam Notification.

cx
[v] Nová šířka rámečku v pixelech

cy
[v] Nová výška rámečku v pixelech

Poznámky

`CFrameWndEx::OnSizing`

Volá se podle architektury, když uživatel změní velikost rámce.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parametry

fwSide
[v] Okraj rámečku, který se přesune. Viz parametr wParam v WM_SIZING Oznámení.

pRect
[in, out] Ukazatel na CRect strukturu nebo RECT strukturu, která obsahuje souřadnice rámce.

Poznámky

`CFrameWndEx::OnSysColorChange`

Volá se rozhraním při změně systémových barev.

void OnSysColorChange();

Poznámky

`CFrameWndEx::OnTearOffMenu`

Volá se rozhraním, když aplikace zobrazí nabídku s odtrženou lištou.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Parametry

pMenuPopup
[v] Ukazatel na místní nabídku

pBar
[v] Ukazatel na odtrženou čáru.

Návratová hodnota

TRUE pokud je povolena místní nabídka s odtrženým pruhem; jinak FALSE.

Poznámky

Tuto metodu v odvozené třídě přepište, aby se při zobrazení řídicího panelu spustil vlastní kód.

Výchozí implementace nedělá nic a vrací TRUE.

`CFrameWndEx::OnToolbarContextMenu`

Volal rozhraní pro vytvoření místní nabídky panelu nástrojů.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[v] Tento parametr se nepoužívá.

lp
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu 1.

Poznámky

`CFrameWndEx::OnToolbarCreateNew`

Architektura volá tuto metodu pro vytvoření nového panelu nástrojů.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[v] Tento parametr se nepoužívá.

lp
[v] Ukazatel na text záhlaví panelu nástrojů

Návratová hodnota

Ukazatel na nový panel nástrojů; nebo NULL pokud nebyl vytvořen panel nástrojů.

Poznámky

`CFrameWndEx::OnToolbarDelete`

Volá se rozhraním při odstranění panelu nástrojů.

afx_msg LRESULT OnToolbarDelete(
    WPARAM /* unused */,
    LPARAM lp);

`CFrameWndEx::PaneFromPoint`

Vyhledá každé podokno pro daný bod.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parametry

point
[v] Souřadnice obrazovky bodu, který chcete zkontrolovat.

nSensitivity
[v] Při hledání bodu rozbalte ohraničující obdélník každého řídicího pruhu o tuto hodnotu.

bExactBar
[v] TRUE ignorovat nSensitivity parametr, jinak . FALSE

pRTCBarType
[v] Pokud ne NULL, metoda hledá pouze ovládací panely zadaného typu.

dwAlignment
[ven] Pokud je tento parametr úspěšný, obsahuje stranu řídicího panelu, která je nejblíže zadanému bodu. Jinak se tento parametr neicializuje.

Návratová hodnota

Ukazatel na ovládací panel, který obsahuje pointovládací prvek ; NULL pokud nebyl nalezen žádný ovládací prvek.

Poznámky

Tato metoda vyhledá všechny řídicí pruhy ve vaší aplikaci .point

Slouží nSensitivity ke zvětšení velikosti vyhledávací oblasti. Slouží pRTCBarType k omezení typů řídicích pruhů, které metoda hledá.

`CFrameWndEx::PreTranslateMessage`

Zpracovává konkrétní zprávy okna před odesláním.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

pMsg
[v] Ukazatel na MSG strukturu, která obsahuje zprávu ke zpracování.

Návratová hodnota

Nenulové, pokud byla zpráva zpracována a neměla by být odeslána; 0, pokud zpráva nebyla zpracována a měla by být odeslána.

Poznámky

`CFrameWndEx::RecalcLayout`

Upraví rozložení rámečku a jeho podřízených oken.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametry

bNotify
[v] Určuje, zda má být položka klienta OLE upozorněna na změnu rozložení.

Poznámky

Tato metoda se volá, když se změnila velikost okna rámečku nebo při zobrazení nebo skrytí ovládacích pruhů.

`CFrameWndEx::RemovePaneFromDockManager`

Zruší registraci podokna a odebere ho ze správce ukotvení.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parametry

pControlBar
[v] Ukazatel na podokno řídicího panelu, které chcete odebrat.

bDestroy
[v] TRUE zničit řídicí panel po jeho odebrání; FALSE jinak.

bAdjustLayout
[v] TRUE upravit rozložení ukotvení; FALSE jinak.

bAutoHide
[v] TRUE pokud je ovládací panel v režimu automatického skrytí; FALSE jinak.

pBarReplacement
[v] Ukazatel na podokno, které nahrazuje odebrané podokno.

Poznámky

Tuto metodu použijte k odebrání ovládacího panelu z ukotveného rozložení okna rámečku.

Třída CDockingManager zpracovává rozložení ovládacích pruhů. Každý ovládací panel je nutné zaregistrovat pomocí správce ukotvení pomocí CFrameWndEx::AddPane metody nebo CFrameWndEx::InsertPane metody.

`CFrameWndEx::SetDockState`

Obnoví dokovací rozložení do stavu ukotvení uloženého v registru.

void SetDockState(const CDockState& state);

Parametry

state
Stav ukotvení. Tento parametr je ignorován.

`CFrameWndEx::SetPrintPreviewFrame`

Nastaví okno rámečku náhledu tisku.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parametry

pWnd
[v] Ukazatel na okno rámečku náhledu tisku

Poznámky

`CFrameWndEx::SetupToolbarMenu`

Vloží uživatelem definované příkazy do nabídky panelu nástrojů.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Parametry

menu
[v] Objekt CMenu , který se má upravit.

uiViewUserToolbarCmdFirst
[v] První uživatelem definovaný příkaz.

uiViewUserToolbarCmdLast
[v] Poslední uživatelem definovaný příkaz.

Poznámky

Architektura ukládá uživatelem definované příkazy do seznamu. Použijte uiViewUserToolbarCmdFirst a uiViewUserToolbarCmdList zadejte indexy příkazů, které chcete vložit.

`CFrameWndEx::ShowFullScreen`

Přepne hlavní rámec mezi režimem zobrazení na celé obrazovce a normálním režimem.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

Zobrazí nebo skryje zadané podokno.

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parametry

pBar
[v] Ukazatel na ovládací panel, který chcete zobrazit nebo skrýt.

bShow
[v] Pokud TRUEaplikace zobrazí ovládací panel. V opačném případě aplikace skryje ovládací panel.

bDelay
[v] Pokud TRUEzpozdí úpravu dokovacího rozložení, dokud architektura nevolá CFrameWndEx::AdjustDockingLayout. V opačném případě přepočítáte rozložení ukotvení okamžitě.

bActivate
[v] Pokud TRUEnastavíte aktivní ovládací panel. V opačném případě zobrazte ovládací panel v neaktivním stavu.

`CFrameWndEx::UpdateCaption`

Volá se rozhraním pro aktualizaci titulku rámečku okna.

void UpdateCaption();

Poznámky

`CFrameWndEx::WinHelp`

Vyvolá buď aplikaci WinHelp, nebo kontext související nápovědu.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Parametry

dwData
Data, která závisí na parametru nCmd . Seznam možných hodnot naleznete v tématu WinHelp.

nCmd
Příkaz nápovědy. Seznam možných hodnot naleznete v tématu WinHelp.

Poznámky

Viz také

Graf hierarchie
Třídy
CFrameWnd

Sdílet prostřednictvím

CFrameWndEx Třída

Syntaxe

Členové

Veřejné metody

Příklad

Hierarchie dědičnosti

Požadavky

CFrameWndEx::ActiveItemRecalcLayout

Poznámky

CFrameWndEx::AddPane

Parametry

Návratová hodnota

CFrameWndEx::AdjustDockingLayout

Parametry

Poznámky

CFrameWndEx::DelayUpdateFrameMenu

Parametry

Poznámky

CFrameWndEx::DockPane

Parametry

Poznámky

CFrameWndEx::DockPaneLeftOf

Parametry

Návratová hodnota

Poznámky

CFrameWndEx::EnableAutoHidePanes

Parametry

Návratová hodnota

Poznámky

CFrameWndEx::EnableDocking

Parametry

Návratová hodnota

Poznámky

CFrameWndEx::EnableFullScreenMainMenu

Parametry

CFrameWndEx::EnableFullScreenMode

Parametry

Poznámky

CFrameWndEx::EnableLoadDockState

Parametry

CFrameWndEx::EnablePaneMenu

Parametry

CFrameWndEx::GetActivePopup

Návratová hodnota

CFrameWndEx::GetDefaultResId

Návratová hodnota

CFrameWndEx::GetDockingManager

Návratová hodnota

Poznámky

CFrameWndEx::GetMenuBar

Návratová hodnota

CFrameWndEx::GetPane

Parametry

Návratová hodnota

CFrameWndEx::GetRibbonBar

Návratová hodnota

Poznámky

CFrameWndEx::GetTearOffBars

Návratová hodnota

CFrameWndEx::GetToolbarButtonToolTipText

Parametry

Návratová hodnota

Poznámky

CFrameWndEx::InsertPane

Parametry

Návratová hodnota

Poznámky

CFrameWndEx::IsFullScreen

Návratová hodnota

Poznámky

CFrameWndEx::IsMenuBarAvailable

Návratová hodnota

CFrameWndEx::IsPointNearDockSite

Parametry

Návratová hodnota

Poznámky

CFrameWndEx::IsPrintPreview

Návratová hodnota

Poznámky

`CFrameWndEx` Třída

`CFrameWndEx::ActiveItemRecalcLayout`

`CFrameWndEx::AddPane`

`CFrameWndEx::AdjustDockingLayout`

`CFrameWndEx::DelayUpdateFrameMenu`

`CFrameWndEx::DockPane`

`CFrameWndEx::DockPaneLeftOf`

`CFrameWndEx::EnableAutoHidePanes`

`CFrameWndEx::EnableDocking`

`CFrameWndEx::EnableFullScreenMainMenu`

`CFrameWndEx::EnableFullScreenMode`

`CFrameWndEx::EnableLoadDockState`

`CFrameWndEx::EnablePaneMenu`

`CFrameWndEx::GetActivePopup`

`CFrameWndEx::GetDefaultResId`

`CFrameWndEx::GetDockingManager`

`CFrameWndEx::GetMenuBar`

`CFrameWndEx::GetPane`

`CFrameWndEx::GetRibbonBar`

`CFrameWndEx::GetTearOffBars`

`CFrameWndEx::GetToolbarButtonToolTipText`

`CFrameWndEx::InsertPane`

`CFrameWndEx::IsFullScreen`

`CFrameWndEx::IsMenuBarAvailable`

`CFrameWndEx::IsPointNearDockSite`

`CFrameWndEx::IsPrintPreview`

`CFrameWndEx::LoadFrame`

`CFrameWndEx::NegotiateBorderSpace`

`CFrameWndEx::OnActivate`

`CFrameWndEx::OnActivateApp`

`CFrameWndEx::OnChangeVisualManager`

`CFrameWndEx::OnClose`

`CFrameWndEx::OnCloseDockingPane`

`CFrameWndEx::OnCloseMiniFrame`

`CFrameWndEx::OnClosePopupMenu`

`CFrameWndEx::OnCmdMsg`

`CFrameWndEx::OnContextHelp`

`CFrameWndEx::OnCreate`

`CFrameWndEx::OnDestroy`

`CFrameWndEx::OnDrawMenuImage`

`CFrameWndEx::OnDrawMenuLogo`

`CFrameWndEx::OnDWMCompositionChanged`

`CFrameWndEx::OnExitSizeMove`

`CFrameWndEx::OnGetMinMaxInfo`

`CFrameWndEx::OnIdleUpdateCmdUI`

`CFrameWndEx::OnLButtonDown`

`CFrameWndEx::OnLButtonUp`