`CFrameWndEx` Klasa

Artykuł
10/12/2023

Implementuje funkcjonalność jednokrotnego interfejsu dokumentu systemu Windows (SDI) nakładających się lub wyskakujących okienek oraz zapewnia elementy członkowskie do zarządzania oknem. Rozszerza klasę CFrameWnd .

Składnia

class CFrameWndEx : public CFrameWnd

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
`CFrameWndEx::ActiveItemRecalcLayout`	Dostosowuje układ elementu klienta OLE i obszar klienta ramki.
`CFrameWndEx::AddDockSite`	Ta metoda nie jest używana.
`CFrameWndEx::AddPane`	Rejestruje pasek sterowania za pomocą menedżera dokowania.
`CFrameWndEx::AdjustDockingLayout`	Ponownie oblicza układ wszystkich okienek, które są zadokowane do okna ramki.
`CFrameWndEx::DelayUpdateFrameMenu`	Ustawia menu ramek, a następnie aktualizuje je, gdy przetwarzanie poleceń jest bezczynne.
`CFrameWndEx::DockPane`	Zadokuje określone okienko do okna ramki.
`CFrameWndEx::DockPaneLeftOf`	Zadokuje jedno okienko po lewej stronie innego okienka.
`CFrameWndEx::EnableAutoHidePanes`	Włącza tryb automatycznego ukrywania okienek, gdy są one zadokowane do określonych stron okna głównej ramki.
`CFrameWndEx::EnableDocking`	Umożliwia zadokowanie okienek należących do okna ramki.
`CFrameWndEx::EnableFullScreenMainMenu`	Wyświetla lub ukrywa menu główne w trybie pełnoekranowym.
`CFrameWndEx::EnableFullScreenMode`	Włącza tryb pełnoekranowy dla okna ramki.
`CFrameWndEx::EnableLoadDockState`	Włącza lub wyłącza ładowanie stanu dokowania.
`CFrameWndEx::EnablePaneMenu`	Włącza lub wyłącza automatyczną obsługę menu okienka.
`CFrameWndEx::GetActivePopup`	Zwraca wskaźnik do aktualnie wyświetlanego menu podręcznego.
`CFrameWndEx::GetDefaultResId`	Zwraca identyfikator zasobu określony podczas ładowania okna ramki przez platformę.
`CFrameWndEx::GetDockingManager`	`CDockingManager` Pobiera obiekt Class dla okna ramki.
`CFrameWndEx::GetMenuBar`	Zwraca wskaźnik do obiektu paska menu dołączonego do okna ramki.
`CFrameWndEx::GetPane`	Zwraca wskaźnik do okienka z określonym identyfikatorem.
`CFrameWndEx::GetRibbonBar`	Pobiera kontrolkę paska wstążki dla ramki.
`CFrameWndEx::GetTearOffBars`	Zwraca listę obiektów okienka, które są w stanie odrywania.
`CFrameWndEx::GetToolbarButtonToolTipText`	Wywoływana przez platformę, gdy aplikacja wyświetla etykietkę narzędzia dla przycisku paska narzędzi.
`CFrameWndEx::InsertPane`	Rejestruje okienko za pomocą menedżera dokowania.
`CFrameWndEx::IsFullScreen`	Określa, czy okno ramki jest w trybie pełnoekranowym.
`CFrameWndEx::IsMenuBarAvailable`	Określa, czy wskaźnik do obiektu paska menu jest prawidłowy.
`CFrameWndEx::IsPointNearDockSite`	Wskazuje, czy punkt znajduje się w strefie wyrównania.
`CFrameWndEx::IsPrintPreview`	Wskazuje, czy okno ramki jest w trybie podglądu wydruku.
`CFrameWndEx::LoadFrame`	Ta metoda jest wywoływana po konstrukcji w celu utworzenia okna ramowego i załadowania jej zasobów.
`CFrameWndEx::NegotiateBorderSpace`	Implementuje negocjacje graniczne klienta OLE.
`CFrameWndEx::OnActivate`	Struktura wywołuje tę metodę, gdy dane wejściowe użytkownika są przełączane do ramki lub z dala od tej ramki.
`CFrameWndEx::OnActivateApp`	Wywoływana przez platformę, gdy aplikacja jest wybrana lub anulowana.
`CFrameWndEx::OnChangeVisualManager`	Wywoływana przez platformę, gdy zmiana ramki wymaga zmiany w menedżerze wizualizacji.
`CFrameWndEx::OnClose`	Struktura wywołuje tę metodę, aby zamknąć ramkę.
`CFrameWndEx::OnCloseDockingPane`	Wywoływana przez platformę, gdy użytkownik kliknie przycisk Zamknij w okienku dokowania.
`CFrameWndEx::OnCloseMiniFrame`	Wywoływana przez platformę, gdy użytkownik kliknie przycisk Zamknij w przestawnym oknie miniramki.
`CFrameWndEx::OnClosePopupMenu`	Wywoływana przez platformę, gdy aktywne menu podręczne przetwarza `WM_DESTROY` komunikat.
`CFrameWndEx::OnCmdMsg`	Wysyła komunikaty poleceń.
`CFrameWndEx::OnContextHelp`	Wywoływana przez platformę w celu wyświetlenia pomocy związanej z kontekstem.
`CFrameWndEx::OnCreate`	Wywoływana przez strukturę po utworzeniu ramki.
`CFrameWndEx::OnDestroy`	Wywoływana przez platformę, gdy ramka zostanie zniszczona.
`CFrameWndEx::OnDrawMenuImage`	Wywoływana przez platformę, gdy aplikacja rysuje obraz skojarzony z elementem menu.
`CFrameWndEx::OnDrawMenuLogo`	Wywoływana przez platformę, gdy `CMFCPopupMenu` obiekt przetwarza `WM_PAINT` komunikat.
`CFrameWndEx::OnDWMCompositionChanged`	Wywoływana przez platformę, gdy kompozycja programu Desktop Window Manager (DWM) została włączona lub wyłączona.
`CFrameWndEx::OnExitSizeMove`	Wywoływana przez strukturę, gdy ramka przestaje przenosić lub zmieniać rozmiar.
`CFrameWndEx::OnGetMinMaxInfo`	Wywoływana przez platformę, gdy rozmiar ramki zostanie zmieniony, aby ustawić limity wymiarów okna.
`CFrameWndEx::OnIdleUpdateCmdUI`	Wywoływana przez platformę w celu zaktualizowania wyświetlania ramki podczas przetwarzania poleceń jest bezczynna.
`CFrameWndEx::OnLButtonDown`	Struktura wywołuje tę metodę, gdy użytkownik naciska lewy przycisk myszy.
`CFrameWndEx::OnLButtonUp`	Platforma wywołuje tę metodę, gdy użytkownik zwolni lewy przycisk myszy.
`CFrameWndEx::OnMenuButtonToolHitTest`	Wywoływana przez platformę, gdy `CMFCToolBarButton` obiekt przetwarza `WM_NCHITTEST` komunikat.
`CFrameWndEx::OnMenuChar`	Wywoływana przez platformę, gdy menu jest wyświetlane, a użytkownik naciska, który nie odpowiada poleceniu.
`CFrameWndEx::OnMouseMove`	Struktura wywołuje tę metodę, gdy wskaźnik zostanie przeniesiony.
`CFrameWndEx::OnMoveMiniFrame`	Wywoływana przez platformę po przesunięciu okna okienka.
`CFrameWndEx::OnNcActivate`	Wywoływana przez platformę, gdy obszar niekliencki ramki musi zostać ponownie wyrysowany, aby wskazać zmianę stanu aktywnego.
`CFrameWndEx::OnNcCalcSize`	Wywoływana przez platformę, gdy należy obliczyć rozmiar i położenie obszaru klienta.
`CFrameWndEx::OnNcHitTest`	Wywoływana przez platformę, gdy wskaźnik porusza się lub gdy przycisk myszy jest naciskany lub zwalniany.
`CFrameWndEx::OnNcMouseMove`	Wywoływana przez platformę, gdy wskaźnik przechodzi w obszarze niekliencki.
`CFrameWndEx::OnNcPaint`	Wywoływana przez platformę, gdy obszar niekliencki musi być malowany.
`CFrameWndEx::OnPaneCheck`	Wywoływana przez platformę w celu kontrolowania widoczności okienka.
`CFrameWndEx::OnPostPreviewFrame`	Wywoływana przez platformę, gdy użytkownik zmienił tryb podglądu wydruku.
`CFrameWndEx::OnPowerBroadcast`	Wywoływana przez platformę w przypadku wystąpienia zdarzenia zarządzania energią.
`CFrameWndEx::OnSetMenu`	Wywoływana przez platformę w celu zastąpienia menu okna ramki.
`CFrameWndEx::OnSetPreviewMode`	Wywoływana przez strukturę w celu ustawienia trybu podglądu wydruku dla ramki.
`CFrameWndEx::OnSetText`	Wywoływana przez strukturę w celu ustawienia tekstu okna.
`CFrameWndEx::OnShowCustomizePane`	Wywoływana przez platformę po włączeniu okienka szybkiego dostosowywania.
`CFrameWndEx::OnShowPanes`	Wywoływana przez platformę w celu wyświetlania lub ukrywania okienek.
`CFrameWndEx::OnShowPopupMenu`	Wywoływana przez platformę po włączeniu menu podręcznego.
`CFrameWndEx::OnSize`	Struktura wywołuje tę metodę po zmianie rozmiaru ramki.
`CFrameWndEx::OnSizing`	Struktura wywołuje tę metodę, gdy użytkownik zmienia rozmiar ramki.
`CFrameWndEx::OnSysColorChange`	Wywoływana przez platformę, gdy kolory systemowe się zmieniają.
`CFrameWndEx::OnTearOffMenu`	Wywoływana przez platformę, gdy jest włączone menu z paskiem odrętywania.
`CFrameWndEx::OnToolbarContextMenu`	Wywoływana przez platformę w celu utworzenia menu kontekstowego paska narzędzi.
`CFrameWndEx::OnToolbarCreateNew`	Struktura wywołuje tę metodę, aby utworzyć nowy pasek narzędzi.
`CFrameWndEx::OnToolbarDelete`	Wywoływana przez strukturę po usunięciu paska narzędzi.
`CFrameWndEx::OnUpdateFrameMenu`	Wywoływana przez platformę, aby ustawić menu ramek.
`CFrameWndEx::OnUpdateFrameTitle`	Struktura wywołuje tę metodę, aby zaktualizować pasek tytułu okna ramki.
`CFrameWndEx::OnUpdatePaneMenu`	Wywoływana przez platformę w celu zaktualizowania menu okienka.
`CFrameWndEx::OnWindowPosChanged`	Wywoływana przez platformę, gdy rozmiar ramki, położenie lub kolejność z uległ zmianie z powodu wywołania metody zarządzania oknami.
`CFrameWndEx::PaneFromPoint`	Zwraca okienko dockowania zawierające określony punkt.
`CFrameWndEx::PreTranslateMessage`	Obsługuje określone komunikaty okna przed ich wysłaniem.
`CFrameWndEx::RecalcLayout`	Dostosowuje układ ramki i jego okien podrzędnych.
`CFrameWndEx::RemovePaneFromDockManager`	Wyrejestrowuje okienko i usuwa je z listy wewnętrznej w menedżerze dokowania.
`CFrameWndEx::SetDockState`	Przywraca układ dokowania do stanu dokowania przechowywany w rejestrze.
`CFrameWndEx::SetPrintPreviewFrame`	Ustawia okno ramki podglądu wydruku.
`CFrameWndEx::SetupToolbarMenu`	Wstawia polecenia zdefiniowane przez użytkownika do menu paska narzędzi.
`CFrameWndEx::ShowFullScreen`	Przełącza ramkę główną między trybami pełnoekranowymi i zwykłymi.
`CFrameWndEx::ShowPane`	Wyświetla lub ukrywa określone okienko.
`CFrameWndEx::UpdateCaption`	Wywoływana przez platformę w celu zaktualizowania podpisu ramki okna.
`CFrameWndEx::WinHelp`	`WinHelp` Wywołuje pomoc dotyczącą aplikacji lub kontekstu.

Przykład

W poniższym przykładzie pokazano, jak dziedziczyć klasę z CFrameWndEx klasy. W przykładzie przedstawiono podpisy metody w podklasie i sposób zastępowania OnShowPopupMenu metody. Ten fragment kodu jest częścią przykładu okienka word.

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;
}

Hierarchia dziedziczenia

Wymagania

Nagłówek: afxframewndex.h

`CFrameWndEx::ActiveItemRecalcLayout`

Dostosowuje układ elementu klienta OLE i obszar klienta ramki.

void ActiveItemRecalcLayout();

Uwagi

`CFrameWndEx::AddPane`

Rejestruje pasek sterowania za pomocą menedżera dokowania.

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

Parametry

pControlBar
[in] Okienko paska sterowania do zarejestrowania.

bTail
[in] TRUE jeśli chcesz dodać okienko paska sterowania na końcu listy; FALSE inaczej.

Wartość zwracana

TRUE jeśli pasek kontrolny został pomyślnie zarejestrowany; FALSE inaczej.

`CFrameWndEx::AdjustDockingLayout`

Ponownie oblicza układ wszystkich okienek, które są zadokowane do okna ramki.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parametry

hdwp
Uchwyt do struktury zawierającej pozycje wielu okien. .

Uwagi

Struktura hdwp jest inicjowana przez metodę BeginDeferWindowPos .

`CFrameWndEx::DelayUpdateFrameMenu`

Ustawia menu ramek, a następnie aktualizuje je, gdy przetwarzanie poleceń jest bezczynne.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parametry

hMenuAlt
[in] Dojście do alternatywnego menu.

Uwagi

`CFrameWndEx::DockPane`

Zadokuje określone okienko do okna ramki.

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

Parametry

pBar
[in] Wskaźnik do paska sterowania, który ma zostać zadokowany.

nDockBarID
[in] Identyfikator boku okna ramowego do zadokowania.

lpRect
[in] Wskaźnik do stałej Rect struktury, która określa położenie i rozmiar ekranu okna.

Uwagi

Parametr nDockBarID może mieć jedną z następujących wartości:

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

Zadokuje określone okienko po lewej stronie innego okienka.

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

Parametry

pBar
[in] Wskaźnik do obiektu okienka do zadokowania.

pLeftOf
[in] Wskaźnik do okienka z lewej strony, aby zadokować okienko określone przez pBar.

Wartość zwracana

TRUE jeśli pBar zostanie pomyślnie zadokowany. FALSE inaczej.

Uwagi

Metoda pobiera pasek narzędzi określony przez pBar parametr i zadokuje go po lewej stronie paska narzędzi określonego przez pLeftOf parametr.

`CFrameWndEx::EnableAutoHidePanes`

Włącza tryb automatycznego ukrywania okienka, gdy jest zadokowany do określonej strony okna głównej ramki.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametry

dwDockStyle
[in] Określa stronę głównego okna ramki, do którego ma być zadokowany okienko.

Wartość zwracana

TRUE jeśli okienko paska zostało pomyślnie zadokowane do strony okna ramowego określonego przez dwDockStyle, FALSE w przeciwnym razie.

Uwagi

dwDockStyle może mieć jedną z następujących wartości:

CBRS_ALIGN_TOP: umożliwia zadokowanie paska sterowania do góry obszaru klienta okna ramowego.
CBRS_ALIGN_BOTTOM: umożliwia zadokowanie paska sterowania do dołu obszaru klienta okna ramowego.
CBRS_ALIGN_LEFT: umożliwia zadokowanie paska sterowania po lewej stronie obszaru klienta okna ramowego.
CBRS_ALIGN_RIGHT: umożliwia zadokowanie paska sterowania po prawej stronie obszaru klienta okna ramowego.

`CFrameWndEx::EnableDocking`

Włącza dokowanie okienek okna ramki.

BOOL EnableDocking(DWORD dwDockStyle);

Parametry

dwDockStyle
[in] Określa stronę głównego okna ramki, w którym pasek okienka dokuje.

Wartość zwracana

TRUE jeśli okienko paska można pomyślnie zadokować po określonej stronie. FALSE inaczej.

Uwagi

Parametr dwDockStyle może mieć jedną z następujących wartości:

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

Wyświetla lub ukrywa menu główne w trybie pełnoekranowym.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parametry

bEnableMenu
[in] TRUE aby wyświetlić menu główne w trybie pełnoekranowym, FALSE w przeciwnym razie.

`CFrameWndEx::EnableFullScreenMode`

Włącza tryb pełnoekranowy dla okna ramki.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parametry

uiFullScreenCmd
[in] Identyfikator polecenia, który włącza i wyłącza tryb pełnoekranowy.

Uwagi

W trybie pełnoekranowym wszystkie paski sterowania dokowania, paski narzędzi i menu są ukryte, a aktywny widok ma rozmiar tak, aby zajmował pełny ekran.

Po włączeniu trybu pełnoekranowego należy określić identyfikator polecenia, który włącza lub wyłącza tryb pełnoekranowy. Funkcję ramki OnCreate głównej można wywołaćEnableFullScreenMode. Gdy okno ramki jest przełączane do trybu pełnoekranowego, platforma tworzy przestawny pasek narzędzi z jednym przyciskiem, który ma określony identyfikator polecenia.

Jeśli chcesz zachować menu główne na ekranie, wywołaj metodę CFrameWndEx::EnableFullScreenMainMenu.

`CFrameWndEx::EnableLoadDockState`

Włącza lub wyłącza ładowanie stanu dokowania.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parametry

bEnable
[in] TRUE aby umożliwić ładowanie stanu dokowania, FALSE aby wyłączyć ładowanie stanu dokowania.

`CFrameWndEx::EnablePaneMenu`

Włącza lub wyłącza automatyczną obsługę menu okienka.

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

Parametry

bEnable
[in] TRUE aby włączyć automatyczną obsługę wyskakujących menu paska sterowania; FALSE aby wyłączyć automatyczną obsługę wyskakujących menu paska sterowania.

uiCustomizeCmd
[in] Identyfikator polecenia elementu menu Dostosowywanie .

strCustomizeLabel
[in] Etykieta, która ma być wyświetlana dla elementu menu Dostosowywanie

uiViewToolbarsMenuEntryID
[in] Identyfikator elementu menu paska narzędzi, który otwiera menu podręczne na pasku sterowania.

bContextMenuShowsToolbarsOnly
[in] Jeśli TRUEmenu kontekstowe paska sterowania wyświetla tylko listę pasków narzędzi. Jeśli FALSEw menu zostanie wyświetlona lista pasków narzędzi i pasków dokowania.

bViewMenuShowsToolbarsOnly
[in] Jeśli TRUEmenu paska sterowania wyświetla tylko listę pasków narzędzi. Jeśli FALSEw menu zostanie wyświetlona lista pasków narzędzi i pasków dokowania.

`CFrameWndEx::GetActivePopup`

Zwraca wskaźnik do aktualnie wyświetlanego menu podręcznego.

CMFCPopupMenu* GetActivePopup() const;

Wartość zwracana

Wskaźnik do aktualnie wyświetlanego menu podręcznego; w przeciwnym razie NULL.

`CFrameWndEx::GetDefaultResId`

Zwraca identyfikator zasobu określony podczas ładowania okna ramki przez platformę.

UINT GetDefaultResId() const;

Wartość zwracana

Wartość identyfikatora zasobu określona przez użytkownika podczas ładowania okna ramki przez platformę. Zero, jeśli okno ramki nie ma paska menu.

`CFrameWndEx::GetDockingManager`

CDockingManager Pobiera obiekt Class dla okna ramki.

CDockingManager* GetDockingManager();

Wartość zwracana

Wskaźnik do CDockingManager klasy.

Uwagi

Okno ramki tworzy obiekt Klasy i używa CDockingManager go do zarządzania zadokowaniem okien podrzędnych.

`CFrameWndEx::GetMenuBar`

Zwraca wskaźnik do obiektu paska menu dołączonego do okna ramki.

const CMFCMenuBar* GetMenuBar() const;

Wartość zwracana

Wskaźnik do obiektu paska menu dołączony do okna ramki.

`CFrameWndEx::GetPane`

Zwraca wskaźnik do okienka z określonym identyfikatorem.

CBasePane* GetPane(UINT nID);

Parametry

nID
[in] Identyfikator kontrolki.

Wartość zwracana

Wskaźnik do okienka z określonym identyfikatorem. NULL jeśli takie okienko nie istnieje.

`CFrameWndEx::GetRibbonBar`

Pobiera kontrolkę paska wstążki dla ramki.

CMFCRibbonBar* GetRibbonBar();

Wartość zwracana

Wskaźnik do CMFCRibbonBar klasy dla ramki.

Uwagi

`CFrameWndEx::GetTearOffBars`

Zwraca listę obiektów okienka, które są w stanie odrywania.

const CObList& GetTearOffBars() const;

Wartość zwracana

Odwołanie do CObList obiektu zawierającego kolekcję wskaźników do obiektów okienka, które znajdują się w stanie odrywania.

`CFrameWndEx::GetToolbarButtonToolTipText`

Wywoływana przez platformę, gdy aplikacja wyświetla etykietkę narzędzia dla przycisku paska narzędzi.

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

Parametry

pButton
[in] Wskaźnik do przycisku paska narzędzi.

strTTText
[in] Tekst etykietki narzędzia do wyświetlenia dla przycisku.

Wartość zwracana

TRUE jeśli etykietka narzędzia została wyświetlona. FALSE inaczej.

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpi tę metodę, jeśli chcesz wyświetlić etykietkę narzędzia dla przycisku paska narzędzi.

`CFrameWndEx::InsertPane`

Wstawia okienko do listy pasków sterowania i rejestruje je za pomocą menedżera dokowania.

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

Parametry

pControlBar
Wskaźnik do paska sterowania, który ma zostać wstawiony do listy pasków sterowania i zarejestrowany w menedżerze dokowania.

pTarget
Wskaźnik do paska sterowania przed lub po którym należy wstawić okienko.

bAfter
TRUE jeśli chcesz wstawić pControlBar po pTarget, FALSE w przeciwnym razie.

Wartość zwracana

TRUE jeśli pasek sterowania został pomyślnie wstawiony i zarejestrowany, FALSE w przeciwnym razie.

Uwagi

Aby wziąć udział w układzie dokowania, należy zarejestrować każdy pasek sterowania przy użyciu CDockingManager klasy .

`CFrameWndEx::IsFullScreen`

Określa, czy okno ramki jest w trybie pełnoekranowym.

BOOL IsFullScreen() const;

Wartość zwracana

TRUE jeśli okno ramki jest w trybie pełnoekranowym; w przeciwnym razie FALSE.

Uwagi

Tryb pełnoekranowy można ustawić, wywołując metodę CFrameWndEx::EnableFullScreenMode .

`CFrameWndEx::IsMenuBarAvailable`

Określa, czy wskaźnik do obiektu paska menu jest prawidłowy.

BOOL IsMenuBarAvailable() const;

Wartość zwracana

TRUE jeśli okno ramki ma pasek menu; w przeciwnym razie FALSE.

`CFrameWndEx::IsPointNearDockSite`

Określa, czy punkt znajduje się w strefie wyrównania.

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

Parametry

point
[in] Położenie punktu.

dwBarAlignment
[out] Gdzie punkt jest wyrównany. Aby uzyskać możliwe wartości, zobacz tabelę w sekcji Uwagi .

bOuterEdge
[out] TRUE jeśli punkt znajduje się blisko obramowania ramki; FALSE jeśli punkt znajduje się w obszarze klienta.

Wartość zwracana

TRUE jeśli punkt znajduje się w strefie wyrównania; w przeciwnym razie, FALSE.

Uwagi

W poniższej tabeli wymieniono możliwe wartości parametru dwBarAlignment .

Wartość	Opis
`CBRS_ALIGN_TOP`	Wyrównane do góry.
`CBRS_ALIGN_RIGHT`	Wyrównane do prawej strony.
`CBRS_ALIGN_BOTTOM`	Wyrównane do dołu.
`CBRS_ALIGN_LEFT`	Wyrównane do lewej.

`CFrameWndEx::IsPrintPreview`

Określa, czy okno ramki jest w trybie podglądu wydruku.

BOOL IsPrintPreview();

Wartość zwracana

TRUE jeśli okno ramki jest w trybie podglądu wydruku; w przeciwnym razie, FALSE.

Uwagi

`CFrameWndEx::LoadFrame`

Ta metoda jest wywoływana po konstrukcji w celu utworzenia okna ramowego i załadowania jej zasobów.

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

Parametry

nIDResource
[in] Identyfikator zasobu używany do ładowania wszystkich zasobów ramek.

dwDefaultStyle
[in] Domyślny styl okna ramek.

pParentWnd
[in] Wskaźnik do okna nadrzędnego ramki.

pContext
[in] Wskaźnik do klasy Struktury używanej przez platformę CCreateContext podczas tworzenia aplikacji.

Wartość zwracana

TRUE jeśli metoda zakończyła się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

`CFrameWndEx::NegotiateBorderSpace`

Implementuje negocjacje graniczne klienta OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parametry

nBorderCmd
[in] Polecenie negocjacji granicznych. Zobacz sekcję Uwagi, aby uzyskać możliwe wartości.

lpRectBorder
[in, out] Wymiary obramowania.

Wartość zwracana

TRUE jeśli układ musi zostać ponownie obliczony; w przeciwnym razie, FALSE.

Uwagi

W poniższej tabeli wymieniono możliwe wartości parametru nBorderCmd .

borderGet
Uzyskaj dostępną przestrzeń klienta OLE.

borderRequest
Żądanie miejsca klienta OLE.

borderSet
Ustaw przestrzeń klienta OLE.

`CFrameWndEx::OnActivate`

Struktura wywołuje tę metodę, gdy dane wejściowe użytkownika są przełączane do ramki lub z dala od tej ramki.

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

Parametry

nState
[in] Określa, czy ramka jest aktywna, czy nieaktywna. Aby uzyskać możliwe wartości, zobacz tabelę w sekcji Uwagi .

pWndOther
[in] Wskaźnik do innego okna, które przełącza dane wejściowe użytkownika przy użyciu bieżącego.

bMinimized
[in] Zminimalizowany stan ramki. TRUE jeżeli ramka jest zminimalizowana; w przeciwnym razie, FALSE.

Uwagi

W poniższej tabeli wymieniono możliwe wartości parametru nState .

Wartość	Opis
`WA_ACTIVE`	Ramka jest wybierana przez metodę inną niż kliknięcie myszą.
`WA_CLICKACTIVE`	Ramka jest zaznaczona kliknięciem myszy.
`WA_INACTIVE`	Ramka nie jest zaznaczona.

`CFrameWndEx::OnActivateApp`

Wywoływana przez platformę, gdy aplikacja jest wybrana lub anulowana.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parametry

bActive
[in] TRUE jeśli aplikacja jest zaznaczona; FALSE jeśli aplikacja nie jest zaznaczona.

dwThreadID
[in] Ten parametr nie jest używany.

Uwagi

`CFrameWndEx::OnChangeVisualManager`

Wywoływana przez platformę, gdy zmiana ramki wymaga zmiany w menedżerze wizualizacji.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[in] Ten parametr nie jest używany.

lParam
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość 0.

Uwagi

`CFrameWndEx::OnClose`

Struktura wywołuje tę metodę, aby zamknąć ramkę.

afx_msg void OnClose();

Uwagi

Jeśli ramka jest w trybie podglądu wydruku, wysyła komunikat systemu Windows, aby zamknąć podgląd wydruku; w przeciwnym razie, jeśli ramka hostuje klienta OLE, klient jest dezaktywowany.

`CFrameWndEx::OnCloseDockingPane`

Wywoływana przez platformę, gdy użytkownik kliknie przycisk Zamknij w okienku dokowania.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Wartość zwracana

TRUE jeśli można zamknąć pasek dokowania. FALSE inaczej

Uwagi

Domyślna implementacja nic nie robi. Zastąpi tę metodę, jeśli chcesz obsłużyć ukrywanie paska dokowania.

`CFrameWndEx::OnCloseMiniFrame`

Wywoływana przez platformę, gdy użytkownik kliknie przycisk Zamknij w przestawnym oknie miniramki.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Wartość zwracana

TRUE jeśli można zamknąć przestawne okno mini ramowe. FALSE inaczej.

Uwagi

Domyślna implementacja nic nie robi. Zastąpi tę metodę, jeśli chcesz przetworzyć ukrywanie przestawnego mini okna ramowego.

`CFrameWndEx::OnClosePopupMenu`

Wywoływana przez platformę, gdy aktywne menu podręczne przetwarza WM_DESTROY komunikat.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parametry

pMenuPopup
Wskaźnik do menu podręcznego.

Uwagi

Platforma wysyła WM_DESTROY komunikat, gdy zostanie zamknięty okno. Zastąpi tę metodę, jeśli chcesz obsługiwać powiadomienia z CMFCPopupMenu obiektów należących do okna ramki, gdy CMFCPopupMenu obiekt przetwarza WM_DESTROY komunikat wysyłany przez strukturę po zamknięciu okna.

`CFrameWndEx::OnCmdMsg`

Wysyła komunikaty poleceń.

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

Parametry

nID
[in] Identyfikator polecenia.

nCode
[in] Kategoria komunikatów polecenia.

pExtra
[in, out] Wskaźnik do obiektu polecenia.

pHandlerInfo
[in, out] Wskaźnik do struktury obsługi poleceń.

Wartość zwracana

TRUE jeśli komunikat polecenia został obsłużony; w przeciwnym razie, FALSE.

Uwagi

`CFrameWndEx::OnContextHelp`

Wywoływana przez platformę w celu wyświetlenia pomocy związanej z kontekstem.

afx_msg void OnContextHelp();

Uwagi

`CFrameWndEx::OnCreate`

Wywoływana przez strukturę po utworzeniu ramki.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parametry

lpCreateStruct
[in] Wskaźnik do struktury CREATESTRUCT dla nowej ramki.

Wartość zwracana

0, aby kontynuować tworzenie ramki; -1, aby zniszczyć ramkę.

Uwagi

`CFrameWndEx::OnDestroy`

Wywoływana przez platformę, gdy ramka zostanie zniszczona.

afx_msg void OnDestroy();

Uwagi

Tabela akceleratora i wszystkie okna są niszczone.

`CFrameWndEx::OnDrawMenuImage`

Wywoływana przez platformę, gdy aplikacja rysuje obraz skojarzony z elementem menu.

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

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

pMenuButton
[in] Wskaźnik do przycisku menu, którego obraz jest renderowany.

rectImage
[in] Wskaźnik do Rect struktury, która określa położenie i rozmiar ekranu obrazu.

Wartość zwracana

TRUE jeśli struktura pomyślnie renderuje obraz; FALSE inaczej.

Uwagi

Zastąp tę metodę, jeśli chcesz dostosować renderowanie obrazu dla elementów menu należących do paska menu należącego do obiektu pochodnego CFrameWndEx .

`CFrameWndEx::OnDrawMenuLogo`

Wywoływana przez platformę, gdy CMFCPopupMenu obiekt przetwarza WM_PAINT komunikat.

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

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

pMenu
[in] Wskaźnik do elementu menu.

rectLogo
[in] Odwołanie do stałej CRect struktury, która określa położenie ekranu i rozmiar logo menu.

Uwagi

Zastąp tę funkcję, jeśli chcesz wyświetlić logo w menu podręcznym należącym do paska menu należącego do obiektu pochodnego CFrameWndEx .

`CFrameWndEx::OnDWMCompositionChanged`

Wywoływana przez platformę, gdy kompozycja programu Desktop Window Manager (DWM) została włączona lub wyłączona.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[in] Ten parametr nie jest używany.

lp
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość 0.

Uwagi

`CFrameWndEx::OnExitSizeMove`

Wywoływana przez strukturę, gdy ramka przestaje przenosić lub zmieniać rozmiar.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[in] Ten parametr nie jest używany.

lp
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość 0.

Uwagi

`CFrameWndEx::OnGetMinMaxInfo`

Wywoływana przez platformę, gdy rozmiar ramki zostanie zmieniony, aby ustawić limity wymiarów okna.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parametry

lpMMI
[in] Wskaźnik do MINMAXINFO struktury.

Uwagi

`CFrameWndEx::OnIdleUpdateCmdUI`

Wywoływana przez platformę w celu zaktualizowania wyświetlania ramki podczas przetwarzania poleceń jest bezczynna.

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

Parametry

wParam
[in] Ten parametr nie jest używany.

lParam
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość 0.

Uwagi

`CFrameWndEx::OnLButtonDown`

Struktura wywołuje tę metodę, gdy użytkownik naciska lewy przycisk myszy.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parametry

nFlags
[in] Wskazuje, czy użytkownik naciskał modyfikujące. Aby uzyskać informacje o możliwych wartościach, zobacz parametr wParam w obszarze WM_LBUTTONDOWN Powiadomienie.

point
[in] Określa współrzędne x i y wskaźnika względem lewego górnego rogu okna.

Uwagi

`CFrameWndEx::OnLButtonUp`

Platforma wywołuje tę metodę, gdy użytkownik zwolni lewy przycisk myszy.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parametry

nFlags
[in] Wskazuje, czy użytkownik naciskał modyfikujące. Aby uzyskać informacje o możliwych wartościach, zobacz parametr wParam w obszarze WM_LBUTTONUP Powiadomienie.

point
[in] Określa współrzędne x i y wskaźnika względem lewego górnego rogu okna.

Uwagi

`CFrameWndEx::OnMenuButtonToolHitTest`

Wywoływana przez platformę, gdy CMFCToolBarButton obiekt przetwarza WM_NCHITTEST komunikat.

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

Parametry

pButton
[in] Wskaźnik do przycisku paska narzędzi.

pTI
[out] Wskaźnik do struktury informacji o narzędziu.

Wartość zwracana

TRUE jeśli aplikacja wypełni pTI parametr . FALSE inaczej.

Uwagi

Zastąpi tę metodę, jeśli chcesz podać informacje o etykietce narzędzia dotyczące określonego elementu menu.

`CFrameWndEx::OnMenuChar`

Wywoływana przez platformę, gdy menu jest wyświetlane, a użytkownik naciska, który nie odpowiada poleceniu.

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

Parametry

nChar
[in] Kod znaku naciśnięcia.

nFlags
[in] Zawiera flagę MF_POPUP , jeśli wyświetlane menu jest podmenu; zawiera flagę MF_SYSMENU , jeśli wyświetlane menu jest menu sterowania.

pMenu
[in] Wskaźnik do menu.

Wartość zwracana

Wyraz o wysokiej kolejności musi być jedną z następujących wartości.

Wartość	Opis
`0`	Struktura powinna ignorować naciśnięcie.
`1`	Struktura powinna zamknąć menu.
`2`	Struktura powinna wybrać jeden z elementów wyświetlanych w menu. Wyraz o niskiej kolejności zawiera identyfikator polecenia do wybrania.

`CFrameWndEx::OnMouseMove`

Struktura wywołuje tę metodę, gdy wskaźnik zostanie przeniesiony.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parametry

nFlags
[in] Wskazuje, czy użytkownik naciskał modyfikujące. Aby uzyskać informacje o możliwych wartościach, zobacz parametr wParam w obszarze WM_MOUSEMOVE Powiadomienie.

point
[in] Określa x współrzędne i y wskaźnika względem lewego górnego rogu okna.

Uwagi

`CFrameWndEx::OnMoveMiniFrame`

Wywoływana przez platformę po przesunięciu okna okienka.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametry

pFrame
[in] Wskaźnik do okna okienka CPaneFrameWnd Klasa .

Wartość zwracana

TRUE jeśli okno okienka nie zostało zadokowane; FALSE jeśli okno okienka zostało zadokowane.

Uwagi

`CFrameWndEx::OnNcActivate`

Wywoływana przez platformę, gdy obszar niekliencki ramki musi zostać ponownie wyrysowany, aby wskazać zmianę stanu aktywnego.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parametry

bActive
[in] TRUE aby narysować ramkę aktywną; FALSE aby narysować ramkę nieaktywną.

Wartość zwracana

Niezerowe, aby kontynuować przetwarzanie domyślne; 0, aby zapobiec dezaktywowaniu obszaru innego niż klient.

Uwagi

`CFrameWndEx::OnNcCalcSize`

Wywoływana przez platformę, gdy należy obliczyć rozmiar i położenie obszaru klienta.

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

Parametry

bCalcValidRects
[in] TRUE gdy aplikacja musi określić prawidłowy obszar klienta; w przeciwnym razie, FALSE.

lpncsp
[in] Wskaźnik do struktury zawierającej NCCALCSIZE_PARAMS zmiany wymiarów ramek.

Uwagi

`CFrameWndEx::OnNcHitTest`

Wywoływana przez platformę, gdy wskaźnik porusza się lub gdy przycisk myszy jest naciskany lub zwalniany.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parametry

point
[in] Lokalizacja wskaźnika we współrzędnych ekranu.

Wartość zwracana

Wskaźnik osiągnął wyliczonej wartości. Aby uzyskać listę możliwych wartości, zobacz WM_NCHITTEST Powiadomienie.

Uwagi

`CFrameWndEx::OnNcMouseMove`

Wywoływana przez platformę, gdy wskaźnik przechodzi w obszarze niekliencki.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parametry

nHitTest
[in] Wskaźnik osiągnął wyliczonej wartości. Aby uzyskać listę możliwych wartości, zobacz WM_NCHITTEST Powiadomienie.

point
[in] Lokalizacja wskaźnika we współrzędnych ekranu.

Uwagi

`CFrameWndEx::OnNcPaint`

Wywoływana przez platformę, gdy obszar niekliencki musi być malowany.

afx_msg void OnNcPaint();

Uwagi

`CFrameWndEx::OnPaneCheck`

Wywoływana przez platformę w celu kontrolowania widoczności okienka.

afx_msg BOOL OnPaneCheck(UINT nID);

Parametry

nID
[in] Identyfikator kontrolki okienka.

Wartość zwracana

TRUE jeśli polecenie zostało obsłużone; FALSE aby kontynuować przetwarzanie poleceń.

Uwagi

`CFrameWndEx::OnPostPreviewFrame`

Wywoływana przez platformę, gdy użytkownik zmieni tryb podglądu wydruku.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[in] Ten parametr nie jest używany.

lParam
[in] TRUE gdy ramka jest w trybie podglądu wydruku; FALSE gdy tryb podglądu wydruku jest wyłączony.

Wartość zwracana

Zawsze zwraca wartość 0.

Uwagi

`CFrameWndEx::OnPowerBroadcast`

Wywoływana przez platformę w przypadku wystąpienia zdarzenia zarządzania energią.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[in] Zdarzenie zarządzania energią. Aby uzyskać listę możliwych wartości, zobacz WM_POWERBROADCAST Komunikat.

lp
[in] Ten parametr nie jest używany.

Wartość zwracana

Wynik wywołania domyślnej procedury okna.

Uwagi

`CFrameWndEx::OnSetMenu`

Wywoływana przez platformę w celu zastąpienia menu okna ramki.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parametry

wp
[in] Dojmij do nowego menu okna ramki.

lp
[in] Dojmij do nowego menu okna.

hmenu
[in] Dojmij do nowego menu okna ramki.

Wartość zwracana

LRESULT jest wynikiem wywoływania domyślnej procedury okna.

Wartość LOGICZNA to TRUE , czy zdarzenie zostało obsłużone; w przeciwnym razie FALSE.

Uwagi

`CFrameWndEx::OnSetPreviewMode`

Wywoływana przez strukturę w celu ustawienia trybu podglądu wydruku dla ramki.

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

Parametry

bPreview
[in] TRUE aby włączyć podgląd wydruku; FALSE aby wyłączyć podgląd wydruku.

pState
[in] Wskaźnik do CPrintPreviewState struktury stanu ramki.

Uwagi

`CFrameWndEx::OnSetText`

Wywoływana przez strukturę w celu ustawienia tekstu okna.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[in] Ten parametr nie jest używany.

lParam
[in] Wskaźnik do tekstu okna.

Wartość zwracana

Zwraca wartość z wywołania do DefWindowProc.

Uwagi

`CFrameWndEx::OnShowCustomizePane`

Wywoływana przez platformę, gdy wyświetla element QuickCustomizePane.

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

Parametry

pMenuPane
[in] Wskaźnik do okienka szybkiego dostosowywania.

uiToolbarID
[in] Identyfikator kontrolki paska narzędzi do dostosowania.

Wartość zwracana

Ta metoda zawsze zwraca wartość TRUE.

Uwagi

Szybkie menu dostosowywania to menu podręczne, które jest wyświetlane po kliknięciu przycisku dostosowywania paska narzędzi

`CFrameWndEx::OnShowPanes`

Wywoływana przez platformę w celu wyświetlania lub ukrywania okienek.

virtual BOOL OnShowPanes(BOOL bShow);

Parametry

bShow
[in] TRUE jeśli aplikacja wyświetla okienka; FALSE inaczej.

Wartość zwracana

Ta metoda zawsze zwraca wartość FALSE.

Uwagi

Domyślna implementacja pokazuje okienka, jeśli bShow jest TRUE , a okienka są ukryte lub gdy bShow jest FALSE i okienka są widoczne.

Domyślna implementacja ukrywa okienka, jeśli bShow jest TRUE , a okienka są widoczne lub gdy bShow jest FALSE i okienka są ukryte.

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy platforma wyświetla lub ukrywa okienka.

`CFrameWndEx::OnShowPopupMenu`

Wywoływana przez platformę po wyświetleniu wyskakującego menu.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parametry

pMenu
[in] Wskaźnik do menu podręcznego.

Wartość zwracana

TRUE jeśli menu podręczne jest widoczne; w przeciwnym razie FALSE.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy platforma wyświetli menu podręczne. Na przykład przesłoń tę metodę, aby zmienić kolor tła poleceń w menu podręcznym.

`CFrameWndEx::OnSize`

Wywoływana przez strukturę po zmianie rozmiaru ramki.

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

Parametry

nType
[in] Typ zmiany rozmiaru. Aby uzyskać informacje o możliwych wartościach, zobacz parametr wParam w WM_SIZE Notification.

cx
[in] Nowa szerokość ramki w pikselach.

cy
[in] Nowa wysokość ramki w pikselach.

Uwagi

`CFrameWndEx::OnSizing`

Wywoływana przez platformę, gdy użytkownik zmienia rozmiar ramki.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parametry

fwSide
[in] Krawędź ramki, która jest przenoszona. Zobacz parametr wParam w obszarze WM_SIZING Powiadomienie.

pRect
[in, out] Wskaźnik do CRect struktury lub RECT zawierającej współrzędne ramki.

Uwagi

`CFrameWndEx::OnSysColorChange`

Wywoływana przez platformę, gdy kolory systemowe się zmieniają.

void OnSysColorChange();

Uwagi

`CFrameWndEx::OnTearOffMenu`

Wywoływana przez platformę, gdy aplikacja wyświetla menu z paskiem odrywania.

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

Parametry

pMenuPopup
[in] Wskaźnik do menu podręcznego.

pBar
[in] Wskaźnik do paska odrętego.

Wartość zwracana

TRUE jeśli jest włączone menu podręczne z paskiem odrywania; w przeciwnym razie FALSE.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy platforma wyświetla pasek sterowania.

Domyślna implementacja nie wykonuje niczego i zwraca wartość TRUE.

`CFrameWndEx::OnToolbarContextMenu`

Wywoływana przez platformę w celu utworzenia menu podręcznego paska narzędzi.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[in] Ten parametr nie jest używany.

lp
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość 1.

Uwagi

`CFrameWndEx::OnToolbarCreateNew`

Struktura wywołuje tę metodę, aby utworzyć nowy pasek narzędzi.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parametry

wp
[in] Ten parametr nie jest używany.

lp
[in] Wskaźnik do tekstu paska tytułu paska narzędzi.

Wartość zwracana

Wskaźnik do nowego paska narzędzi; lub NULL jeśli pasek narzędzi nie został utworzony.

Uwagi

`CFrameWndEx::OnToolbarDelete`

Wywoływana przez strukturę po usunięciu paska narzędzi.

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

`CFrameWndEx::PaneFromPoint`

Wyszukuje każde okienko dla danego punktu.

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

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

Parametry

point
[in] Współrzędne ekranu punktu do sprawdzenia.

nSensitivity
[in] Rozwiń prostokąt ograniczenia każdego paska sterowania o tę ilość podczas wyszukiwania punktu.

bExactBar
[in] TRUE aby zignorować nSensitivity parametr ; w przeciwnym razie FALSE.

pRTCBarType
[in] Jeśli nie NULL, metoda wyszukuje tylko paski kontrolek określonego typu.

dwAlignment
[out] Jeśli ten parametr zakończy się powodzeniem, ten parametr zawiera bok paska sterowania, który znajduje się najbliżej określonego punktu. W przeciwnym razie ten parametr nie jest inicjowany.

Wartość zwracana

Wskaźnik do paska sterującego, który zawiera kontrolkę point; NULL jeśli nie zostanie znaleziona żadna kontrolka.

Uwagi

Ta metoda wyszukuje wszystkie paski kontrolek w aplikacji dla elementu point.

Użyj nSensitivity polecenia , aby zwiększyć rozmiar obszaru wyszukiwania. Użyj pRTCBarType polecenia , aby ograniczyć typy pasków kontrolek wyszukiwanych przez metodę.

`CFrameWndEx::PreTranslateMessage`

Obsługuje określone komunikaty okna przed ich wysłaniem.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

pMsg
[in] Wskaźnik do struktury zawierającej MSG komunikat do przetworzenia.

Wartość zwracana

Bez zera, jeśli wiadomość została obsłużona i nie powinna być wysyłana; 0, jeśli wiadomość nie została obsłużona i powinna zostać wysłana.

Uwagi

`CFrameWndEx::RecalcLayout`

Dostosowuje układ ramki i jego okien podrzędnych.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametry

bNotify
[in] Określa, czy należy powiadomić element klienta OLE o zmianie układu.

Uwagi

Ta metoda jest wywoływana, gdy rozmiar okna ramki uległ zmianie lub gdy paski sterowania są wyświetlane lub ukryte.

`CFrameWndEx::RemovePaneFromDockManager`

Wyrejestrowuje okienko i usuwa je z menedżera dokowania.

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

Parametry

pControlBar
[in] Wskaźnik do okienka paska sterowania w celu usunięcia.

bDestroy
[in] TRUE aby zniszczyć pasek sterowania po jego usunięciu; FALSE inaczej.

bAdjustLayout
[in] TRUE aby dostosować układ dokowania; FALSE inaczej.

bAutoHide
[in] TRUE jeśli pasek sterowania jest w trybie automatycznego ukrywania; FALSE inaczej.

pBarReplacement
[in] Wskaźnik do okienka, który zastępuje usunięte okienko.

Uwagi

Użyj tej metody, aby usunąć pasek sterowania z układu dokowania okna ramki.

Klasa CDockingManager obsługuje układ pasków sterowania. Należy zarejestrować każdy pasek sterowania za pomocą menedżera dokowania przy użyciu CFrameWndEx::AddPane metody lub CFrameWndEx::InsertPane metody.

`CFrameWndEx::SetDockState`

Przywraca układ dokowania do stanu dokowania przechowywany w rejestrze.

void SetDockState(const CDockState& state);

Parametry

state
Stan dokowania. Ten parametr jest ignorowany.

`CFrameWndEx::SetPrintPreviewFrame`

Ustawia okno ramki podglądu wydruku.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parametry

pWnd
[in] Wskaźnik do okna ramki podglądu wydruku.

Uwagi

`CFrameWndEx::SetupToolbarMenu`

Wstawia polecenia zdefiniowane przez użytkownika do menu paska narzędzi.

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

Parametry

menu
[in] CMenu Obiekt, który ma zostać zmodyfikowany.

uiViewUserToolbarCmdFirst
[in] Pierwsze polecenie zdefiniowane przez użytkownika.

uiViewUserToolbarCmdLast
[in] Ostatnie polecenie zdefiniowane przez użytkownika.

Uwagi

Platforma przechowuje polecenia zdefiniowane przez użytkownika na liście. Użyj polecenia uiViewUserToolbarCmdFirst i uiViewUserToolbarCmdList , aby określić indeksy poleceń do wstawienia.

`CFrameWndEx::ShowFullScreen`

Przełącza ramkę główną między trybem pełnoekranowym a trybem regularnym.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

Wyświetla lub ukrywa określone okienko.

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

Parametry

pBar
[in] Wskaźnik do paska sterowania, aby pokazać lub ukryć.

bShow
[in] Jeśli TRUEaplikacja wyświetli pasek sterowania. W przeciwnym razie aplikacja ukrywa pasek sterowania.

bDelay
[in] W przypadku TRUEpolecenia opóźnij dostosowanie układu dokowania do momentu wywołania CFrameWndEx::AdjustDockingLayoutstruktury . W przeciwnym razie należy natychmiast ponownie obliczyć układ dokowania.

bActivate
[in] Jeśli TRUE, ustaw pasek sterowania jako aktywny. W przeciwnym razie wyświetl pasek sterowania w stanie nieaktywnym.

`CFrameWndEx::UpdateCaption`

Wywoływana przez platformę w celu zaktualizowania podpisu ramki okna.

void UpdateCaption();

Uwagi

`CFrameWndEx::WinHelp`

Wywołuje pomoc dotyczącą aplikacji WinHelp lub kontekstu.

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

Parametry

dwData
Dane, które zależą od parametru nCmd . Aby uzyskać listę możliwych wartości, zobacz WinHelp.

nCmd
Polecenie pomocy. Aby uzyskać listę możliwych wartości, zobacz WinHelp.

Uwagi

Zobacz też

Wykres hierarchii
Klasy
CFrameWnd

Udostępnij za pośrednictwem

CFrameWndEx Klasa

Składnia

Elementy członkowskie

Metody publiczne

Przykład

Hierarchia dziedziczenia

Wymagania

CFrameWndEx::ActiveItemRecalcLayout

Uwagi

CFrameWndEx::AddPane

Parametry

Wartość zwracana

CFrameWndEx::AdjustDockingLayout

Parametry

Uwagi

CFrameWndEx::DelayUpdateFrameMenu

Parametry

Uwagi

CFrameWndEx::DockPane

Parametry

Uwagi

CFrameWndEx::DockPaneLeftOf

Parametry

Wartość zwracana

Uwagi

CFrameWndEx::EnableAutoHidePanes

Parametry

Wartość zwracana

Uwagi

CFrameWndEx::EnableDocking

Parametry

Wartość zwracana

Uwagi

CFrameWndEx::EnableFullScreenMainMenu

Parametry

CFrameWndEx::EnableFullScreenMode

Parametry

Uwagi

CFrameWndEx::EnableLoadDockState

Parametry

CFrameWndEx::EnablePaneMenu

Parametry

CFrameWndEx::GetActivePopup

Wartość zwracana

CFrameWndEx::GetDefaultResId

Wartość zwracana

CFrameWndEx::GetDockingManager

Wartość zwracana

Uwagi

CFrameWndEx::GetMenuBar

Wartość zwracana

CFrameWndEx::GetPane

Parametry

Wartość zwracana

CFrameWndEx::GetRibbonBar

Wartość zwracana

Uwagi

CFrameWndEx::GetTearOffBars

Wartość zwracana

CFrameWndEx::GetToolbarButtonToolTipText

Parametry

Wartość zwracana

Uwagi

CFrameWndEx::InsertPane

Parametry

Wartość zwracana

Uwagi

CFrameWndEx::IsFullScreen

Wartość zwracana

Uwagi

CFrameWndEx::IsMenuBarAvailable

Wartość zwracana

CFrameWndEx::IsPointNearDockSite

Parametry

Wartość zwracana

Uwagi

CFrameWndEx::IsPrintPreview

Wartość zwracana

Uwagi

`CFrameWndEx` Klasa

`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`