Bagikan melalui

CFrameWndEx Kelas

  • Artikel

Menerapkan fungsionalitas antarmuka dokumen tunggal (SDI) Windows yang tumpang tindih atau jendela bingkai popup, dan menyediakan anggota untuk mengelola jendela. Ini memperluas CFrameWnd kelas.

Sintaks

class CFrameWndEx : public CFrameWnd

Anggota

Metode Publik

Nama Deskripsi
CFrameWndEx::ActiveItemRecalcLayout Menyesuaikan tata letak item klien OLE dan area klien bingkai.
CFrameWndEx::AddDockSite Metode ini tidak digunakan.
CFrameWndEx::AddPane Mendaftarkan bilah kontrol dengan manajer docking.
CFrameWndEx::AdjustDockingLayout Menghitung ulang tata letak semua panel yang ditambatkan ke jendela bingkai.
CFrameWndEx::DelayUpdateFrameMenu Mengatur menu bingkai lalu memperbaruinya saat pemrosesan perintah diam.
CFrameWndEx::DockPane Menambak panel yang ditentukan ke jendela bingkai.
CFrameWndEx::DockPaneLeftOf Menamamkan satu panel di sebelah kiri panel lain.
CFrameWndEx::EnableAutoHidePanes Mengaktifkan mode sembunyikan otomatis untuk panel saat ditambatkan ke sisi yang ditentukan dari jendela bingkai utama.
CFrameWndEx::EnableDocking Mengaktifkan docking panel yang termasuk dalam jendela bingkai.
CFrameWndEx::EnableFullScreenMainMenu Menampilkan atau menyembunyikan menu utama dalam mode layar penuh.
CFrameWndEx::EnableFullScreenMode Mengaktifkan mode layar penuh untuk jendela bingkai.
CFrameWndEx::EnableLoadDockState Mengaktifkan atau menonaktifkan pemuatan status docking.
CFrameWndEx::EnablePaneMenu Mengaktifkan atau menonaktifkan penanganan otomatis menu panel.
CFrameWndEx::GetActivePopup Mengembalikan penunjuk ke menu pop-up yang saat ini ditampilkan.
CFrameWndEx::GetDefaultResId Mengembalikan ID sumber daya yang Anda tentukan saat kerangka kerja memuat jendela bingkai.
CFrameWndEx::GetDockingManager Mengambil CDockingManager objek Kelas untuk jendela bingkai.
CFrameWndEx::GetMenuBar Mengembalikan penunjuk ke objek bilah menu yang dilampirkan ke jendela bingkai.
CFrameWndEx::GetPane Mengembalikan penunjuk ke panel yang memiliki ID yang ditentukan.
CFrameWndEx::GetRibbonBar Mengambil kontrol bilah pita untuk bingkai.
CFrameWndEx::GetTearOffBars Mengembalikan daftar objek panel yang dalam status robek.
CFrameWndEx::GetToolbarButtonToolTipText Dipanggil oleh kerangka kerja ketika aplikasi menampilkan tipsalat untuk tombol toolbar.
CFrameWndEx::InsertPane Mendaftarkan panel dengan manajer docking.
CFrameWndEx::IsFullScreen Menentukan apakah jendela bingkai dalam mode layar penuh.
CFrameWndEx::IsMenuBarAvailable Menentukan apakah penunjuk ke objek bilah menu valid.
CFrameWndEx::IsPointNearDockSite Menunjukkan apakah titik terletak di zona perataan.
CFrameWndEx::IsPrintPreview Menunjukkan apakah jendela bingkai berada dalam mode pratinjau cetak.
CFrameWndEx::LoadFrame Metode ini dipanggil setelah konstruksi untuk membuat jendela bingkai dan memuat sumber dayanya.
CFrameWndEx::NegotiateBorderSpace Menerapkan negosiasi perbatasan klien OLE.
CFrameWndEx::OnActivate Kerangka kerja memanggil metode ini ketika input pengguna dialihkan ke atau menjauh dari bingkai.
CFrameWndEx::OnActivateApp Dipanggil oleh kerangka kerja ketika aplikasi dipilih atau tidak dipilih.
CFrameWndEx::OnChangeVisualManager Dipanggil oleh kerangka kerja saat perubahan pada bingkai memerlukan perubahan pada manajer visual.
CFrameWndEx::OnClose Kerangka kerja memanggil metode ini untuk menutup bingkai.
CFrameWndEx::OnCloseDockingPane Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Tutup pada panel docking.
CFrameWndEx::OnCloseMiniFrame Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol Tutup pada jendela bingkai mini mengambang.
CFrameWndEx::OnClosePopupMenu Dipanggil oleh kerangka kerja saat menu pop-up aktif memproses WM_DESTROY pesan.
CFrameWndEx::OnCmdMsg Mengirim pesan perintah.
CFrameWndEx::OnContextHelp Dipanggil oleh kerangka kerja untuk menampilkan bantuan terkait konteks.
CFrameWndEx::OnCreate Dipanggil oleh kerangka kerja setelah bingkai dibuat.
CFrameWndEx::OnDestroy Dipanggil oleh kerangka kerja ketika bingkai dihancurkan.
CFrameWndEx::OnDrawMenuImage Dipanggil oleh kerangka kerja saat aplikasi menggambar gambar yang terkait dengan item menu.
CFrameWndEx::OnDrawMenuLogo Dipanggil oleh kerangka kerja saat CMFCPopupMenu objek memproses pesan WM_PAINT .
CFrameWndEx::OnDWMCompositionChanged Dipanggil oleh kerangka kerja ketika komposisi Desktop Window Manager (DWM) telah diaktifkan atau dinonaktifkan.
CFrameWndEx::OnExitSizeMove Dipanggil oleh kerangka kerja ketika bingkai berhenti bergerak atau mengubah ukuran.
CFrameWndEx::OnGetMinMaxInfo Dipanggil oleh kerangka kerja saat bingkai diubah ukurannya untuk mengatur batas dimensi jendela.
CFrameWndEx::OnIdleUpdateCmdUI Dipanggil oleh kerangka kerja untuk memperbarui tampilan bingkai saat pemrosesan perintah diam.
CFrameWndEx::OnLButtonDown Kerangka kerja memanggil metode ini ketika pengguna menekan tombol mouse kiri.
CFrameWndEx::OnLButtonUp Kerangka kerja memanggil metode ini ketika pengguna merilis tombol mouse kiri.
CFrameWndEx::OnMenuButtonToolHitTest Dipanggil oleh kerangka kerja saat CMFCToolBarButton objek memproses pesan WM_NCHITTEST .
CFrameWndEx::OnMenuChar Dipanggil oleh kerangka kerja saat menu ditampilkan dan pengguna menekan tombol yang tidak sesuai dengan perintah.
CFrameWndEx::OnMouseMove Kerangka kerja memanggil metode ini ketika penunjuk bergerak.
CFrameWndEx::OnMoveMiniFrame Dipanggil oleh kerangka kerja saat jendela panel bergerak.
CFrameWndEx::OnNcActivate Dipanggil oleh kerangka kerja ketika area non-klien bingkai harus digambar ulang untuk menunjukkan perubahan dalam status aktif.
CFrameWndEx::OnNcCalcSize Dipanggil oleh kerangka kerja ketika ukuran dan posisi area klien harus dihitung.
CFrameWndEx::OnNcHitTest Dipanggil oleh kerangka kerja saat penunjuk bergerak atau ketika tombol mouse ditekan atau dilepaskan.
CFrameWndEx::OnNcMouseMove Dipanggil oleh kerangka kerja saat penunjuk bergerak di area non-klien.
CFrameWndEx::OnNcPaint Dipanggil oleh kerangka kerja ketika area non-klien harus dicat.
CFrameWndEx::OnPaneCheck Dipanggil oleh kerangka kerja untuk mengontrol visibilitas panel.
CFrameWndEx::OnPostPreviewFrame Dipanggil oleh kerangka kerja ketika pengguna telah mengubah mode pratinjau cetak.
CFrameWndEx::OnPowerBroadcast Dipanggil oleh kerangka kerja ketika peristiwa manajemen daya terjadi.
CFrameWndEx::OnSetMenu Dipanggil oleh kerangka kerja untuk mengganti menu jendela bingkai.
CFrameWndEx::OnSetPreviewMode Dipanggil oleh kerangka kerja untuk mengatur mode pratinjau cetak untuk bingkai.
CFrameWndEx::OnSetText Dipanggil oleh kerangka kerja untuk mengatur teks jendela.
CFrameWndEx::OnShowCustomizePane Dipanggil oleh kerangka kerja saat panel kustomisasi cepat diaktifkan.
CFrameWndEx::OnShowPanes Dipanggil oleh kerangka kerja untuk memperlihatkan atau menyembunyikan panel.
CFrameWndEx::OnShowPopupMenu Dipanggil oleh kerangka kerja saat menu pop-up diaktifkan.
CFrameWndEx::OnSize Kerangka kerja memanggil metode ini setelah ukuran bingkai berubah.
CFrameWndEx::OnSizing Kerangka kerja memanggil metode ini ketika pengguna mengubah ukuran bingkai.
CFrameWndEx::OnSysColorChange Dipanggil oleh kerangka kerja ketika warna sistem berubah.
CFrameWndEx::OnTearOffMenu Dipanggil oleh kerangka kerja saat menu yang memiliki bilah robek diaktifkan.
CFrameWndEx::OnToolbarContextMenu Dipanggil oleh kerangka kerja untuk membangun menu konteks toolbar.
CFrameWndEx::OnToolbarCreateNew Kerangka kerja memanggil metode ini untuk membuat toolbar baru.
CFrameWndEx::OnToolbarDelete Dipanggil oleh kerangka kerja saat toolbar dihapus.
CFrameWndEx::OnUpdateFrameMenu Dipanggil oleh kerangka kerja untuk mengatur menu bingkai.
CFrameWndEx::OnUpdateFrameTitle Kerangka kerja memanggil metode ini untuk memperbarui bilah judul jendela bingkai.
CFrameWndEx::OnUpdatePaneMenu Dipanggil oleh kerangka kerja untuk memperbarui menu panel.
CFrameWndEx::OnWindowPosChanged Dipanggil oleh kerangka kerja ketika ukuran bingkai, posisi, atau z-order telah berubah karena panggilan ke metode manajemen jendela.
CFrameWndEx::PaneFromPoint Mengembalikan panel docking yang berisi titik yang ditentukan.
CFrameWndEx::PreTranslateMessage Menangani pesan jendela tertentu sebelum dikirim.
CFrameWndEx::RecalcLayout Menyesuaikan tata letak bingkai dan jendela anaknya.
CFrameWndEx::RemovePaneFromDockManager Membatalkan pendaftaran panel dan menghapusnya dari daftar internal di manajer docking.
CFrameWndEx::SetDockState Memulihkan tata letak docking ke status docking yang disimpan dalam registri.
CFrameWndEx::SetPrintPreviewFrame Mengatur jendela bingkai pratinjau cetak.
CFrameWndEx::SetupToolbarMenu Menyisipkan perintah yang ditentukan pengguna ke dalam menu bilah alat.
CFrameWndEx::ShowFullScreen Mengalihkan bingkai utama antara layar penuh dan mode reguler.
CFrameWndEx::ShowPane Memperlihatkan atau menyembunyikan panel yang ditentukan.
CFrameWndEx::UpdateCaption Dipanggil oleh kerangka kerja untuk memperbarui keterangan bingkai jendela.
CFrameWndEx::WinHelp WinHelp Memanggil bantuan terkait aplikasi atau konteks.

Contoh

Contoh berikut menunjukkan cara mewarisi kelas dari CFrameWndEx kelas. Contoh ini mengilustrasikan tanda tangan metode di subkelas, dan cara mengambil OnShowPopupMenu alih metode . Cuplikan kode ini adalah bagian dari sampel Word Pad.

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

Hierarki Warisan

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Persyaratan

Header: afxframewndex.h

CFrameWndEx::ActiveItemRecalcLayout

Menyesuaikan tata letak item klien OLE dan area klien bingkai.

void ActiveItemRecalcLayout();

Keterangan

CFrameWndEx::AddPane

Mendaftarkan bilah kontrol dengan manajer docking.

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

Parameter

pControlBar
[di] Panel bilah kontrol untuk mendaftar.

bTail
[di] TRUE jika Anda ingin menambahkan panel bilah kontrol ke akhir daftar; FALSE Sebaliknya.

Tampilkan Nilai

TRUE jika bilah kontrol berhasil didaftarkan; FALSE Sebaliknya.

CFrameWndEx::AdjustDockingLayout

Menghitung ulang tata letak semua panel yang ditambatkan ke jendela bingkai.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameter

hdwp
Handel ke struktur yang berisi posisi beberapa jendela. .

Keterangan

Struktur hdwp diinisialisasi oleh BeginDeferWindowPos metode .

CFrameWndEx::DelayUpdateFrameMenu

Mengatur menu bingkai lalu memperbaruinya saat pemrosesan perintah diam.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parameter

hMenuAlt
[di] Tangani ke menu alternatif.

Keterangan

CFrameWndEx::DockPane

Menambak panel yang ditentukan ke jendela bingkai.

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

Parameter

pBar
[di] Penunjuk ke bilah kontrol yang akan ditampar.

nDockBarID
[di] ID sisi jendela bingkai yang akan ditambat.

lpRect
[di] Penunjuk ke struktur konstanta Rect yang menentukan posisi dan ukuran layar jendela.

Keterangan

Parameter nDockBarID dapat memiliki salah satu nilai berikut:

  • AFX_IDW_DOCKBAR_TOP

  • AFX_IDW_DOCKBAR_BOTTOM

  • AFX_IDW_DOCKBAR_LEFT

  • AFX_IDW_DOCKBAR_RIGHT

CFrameWndEx::DockPaneLeftOf

Menambungkan panel yang ditentukan di sebelah kiri panel lain.

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

Parameter

pBar
[di] Penunjuk ke objek panel yang akan ditampar.

pLeftOf
[di] Penunjuk ke panel di sebelah kiri untuk menambungkan panel yang ditentukan oleh pBar.

Tampilkan Nilai

TRUE jika pBar berhasil di-dock. FALSE sebaiknya.

Keterangan

Metode mengambil toolbar yang ditentukan oleh pBar parameter dan menambungkannya di sisi kiri toolbar yang ditentukan oleh pLeftOf parameter.

CFrameWndEx::EnableAutoHidePanes

Mengaktifkan mode sembunyikan otomatis untuk panel saat ditambatkan ke sisi yang ditentukan dari jendela bingkai utama.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameter

dwDockStyle
[di] Menentukan sisi jendela bingkai utama yang akan ditambat panel.

Tampilkan Nilai

TRUE jika panel bilah berhasil ditambatkan ke sisi jendela bingkai yang ditentukan oleh dwDockStyle, FALSE jika tidak.

Keterangan

dwDockStyle bisa memiliki salah satu nilai berikut:

  • CBRS_ALIGN_TOP: memungkinkan bilah kontrol ditambatkan ke bagian atas area klien dari jendela bingkai.

  • CBRS_ALIGN_BOTTOM: memungkinkan bilah kontrol ditambatkan ke bagian bawah area klien jendela bingkai.

  • CBRS_ALIGN_LEFT: memungkinkan bilah kontrol ditambatkan ke sisi kiri area klien dari jendela bingkai.

  • CBRS_ALIGN_RIGHT: memungkinkan bilah kontrol ditambatkan ke sisi kanan area klien dari jendela bingkai.

CFrameWndEx::EnableDocking

Mengaktifkan docking panel jendela bingkai.

BOOL EnableDocking(DWORD dwDockStyle);

Parameter

dwDockStyle
[di] Menentukan sisi jendela bingkai utama tempat bilah panel bertambatan.

Tampilkan Nilai

TRUE jika panel bilah dapat berhasil ditampung di sisi yang ditentukan. FALSE sebaiknya.

Keterangan

Parameter dwDockStyle dapat memiliki salah satu nilai berikut:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

Menampilkan atau menyembunyikan menu utama dalam mode layar penuh.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parameter

bEnableMenu
[di] TRUE untuk menampilkan menu utama dalam mode layar penuh, FALSE jika tidak.

CFrameWndEx::EnableFullScreenMode

Mengaktifkan mode layar penuh untuk jendela bingkai.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parameter

uiFullScreenCmd
[di] ID perintah yang mengaktifkan dan menonaktifkan mode layar penuh.

Keterangan

Dalam mode layar penuh, semua bilah kontrol docking, toolbar, dan menu disembunyikan dan tampilan aktif diubah ukurannya untuk menempati layar penuh.

Saat mengaktifkan mode layar penuh, Anda harus menentukan ID perintah yang mengaktifkan atau menonaktifkan mode layar penuh. Anda dapat memanggil EnableFullScreenMode dari fungsi bingkai OnCreate utama. Saat jendela bingkai dialihkan ke mode layar penuh, kerangka kerja membuat toolbar mengambang dengan satu tombol yang memiliki ID perintah yang ditentukan.

Jika Anda ingin menyimpan menu utama di layar, panggil CFrameWndEx::EnableFullScreenMainMenu.

CFrameWndEx::EnableLoadDockState

Mengaktifkan atau menonaktifkan pemuatan status docking.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan pemuatan status docking, FALSE untuk menonaktifkan pemuatan status docking.

CFrameWndEx::EnablePaneMenu

Mengaktifkan atau menonaktifkan penanganan otomatis menu panel.

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

Parameter

bEnable
[di] TRUE untuk mengaktifkan penanganan otomatis menu pop-up bilah kontrol; FALSE untuk menonaktifkan penanganan otomatis menu pop-up bilah kontrol.

uiCustomizeCmd
[di] ID perintah item menu Kustomisasi .

strCustomizeLabel
[di] Label yang akan ditampilkan untuk item menu Kustomisasi

uiViewToolbarsMenuEntryID
[di] ID item menu toolbar yang membuka menu pop-up di bilah kontrol.

bContextMenuShowsToolbarsOnly
[di] Jika TRUE, menu konteks bilah kontrol hanya menampilkan daftar toolbar. Jika FALSE, menu menampilkan daftar bilah alat dan bilah dok.

bViewMenuShowsToolbarsOnly
[di] Jika TRUE, menu bilah kontrol hanya menampilkan daftar toolbar. Jika FALSE, menu menampilkan daftar bilah alat dan bilah dok.

CFrameWndEx::GetActivePopup

Mengembalikan penunjuk ke menu pop-up yang saat ini ditampilkan.

CMFCPopupMenu* GetActivePopup() const;

Tampilkan Nilai

Penunjuk ke menu pop-up yang saat ini ditampilkan; jika tidak NULL.

CFrameWndEx::GetDefaultResId

Mengembalikan ID sumber daya yang Anda tentukan saat kerangka kerja memuat jendela bingkai.

UINT GetDefaultResId() const;

Tampilkan Nilai

Nilai ID sumber daya yang ditentukan pengguna saat kerangka kerja memuat jendela bingkai. Nol jika jendela bingkai tidak memiliki bilah menu.

CFrameWndEx::GetDockingManager

Mengambil CDockingManager objek Kelas untuk jendela bingkai.

CDockingManager* GetDockingManager();

Tampilkan Nilai

Penunjuk ke CDockingManager Kelas.

Keterangan

Jendela bingkai membuat dan menggunakan CDockingManager objek Kelas untuk mengelola docking jendela anak.

CFrameWndEx::GetMenuBar

Mengembalikan penunjuk ke objek bilah menu yang dilampirkan ke jendela bingkai.

const CMFCMenuBar* GetMenuBar() const;

Tampilkan Nilai

Penunjuk ke objek bilah menu yang dilampirkan ke jendela bingkai.

CFrameWndEx::GetPane

Mengembalikan penunjuk ke panel yang memiliki ID yang ditentukan.

CBasePane* GetPane(UINT nID);

Parameter

nID
[di] ID kontrol.

Tampilkan Nilai

Penunjuk ke panel yang memiliki ID yang ditentukan. NULL jika tidak ada panel tersebut.

CFrameWndEx::GetRibbonBar

Mengambil kontrol bilah pita untuk bingkai.

CMFCRibbonBar* GetRibbonBar();

Tampilkan Nilai

Penunjuk ke CMFCRibbonBar Kelas untuk bingkai.

Keterangan

CFrameWndEx::GetTearOffBars

Mengembalikan daftar objek panel yang dalam status robek.

const CObList& GetTearOffBars() const;

Tampilkan Nilai

Referensi ke CObList objek yang berisi kumpulan penunjuk ke objek panel yang dalam status robek.

CFrameWndEx::GetToolbarButtonToolTipText

Dipanggil oleh kerangka kerja ketika aplikasi menampilkan tipsalat untuk tombol toolbar.

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

Parameter

pButton
[di] Penunjuk ke tombol toolbar.

strTTText
[di] Teks tipsalat yang ditampilkan untuk tombol .

Tampilkan Nilai

TRUE jika tipsalat telah ditampilkan. FALSE sebaiknya.

Keterangan

Secara default, metode ini tidak melakukan apa pun. Ambil alih metode ini jika Anda ingin menampilkan tipsalat untuk tombol toolbar.

CFrameWndEx::InsertPane

Menyisipkan panel ke dalam daftar bilah kontrol dan mendaftarkannya dengan manajer docking.

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

Parameter

pControlBar
Penunjuk ke bilah kontrol untuk dimasukkan ke dalam daftar bilah kontrol dan terdaftar di manajer docking.

pTarget
Penunjuk ke bilah kontrol sebelum atau sesudahnya untuk menyisipkan panel.

bAfter
TRUE jika Anda ingin menyisipkan pControlBar setelah pTarget, FALSE jika tidak.

Tampilkan Nilai

TRUE jika bilah kontrol berhasil dimasukkan dan didaftarkan, FALSE jika tidak.

Keterangan

Anda harus mendaftarkan setiap bilah kontrol dengan menggunakan CDockingManager Kelas untuk mengambil bagian dalam tata letak docking.

CFrameWndEx::IsFullScreen

Menentukan apakah jendela bingkai dalam mode layar penuh.

BOOL IsFullScreen() const;

Tampilkan Nilai

TRUE jika jendela bingkai dalam mode layar penuh; jika tidak FALSE.

Keterangan

Anda dapat mengatur mode layar penuh dengan memanggil CFrameWndEx::EnableFullScreenMode metode .

CFrameWndEx::IsMenuBarAvailable

Menentukan apakah penunjuk ke objek bilah menu valid.

BOOL IsMenuBarAvailable() const;

Tampilkan Nilai

TRUE jika jendela bingkai memiliki bilah menu; jika tidak FALSE.

CFrameWndEx::IsPointNearDockSite

Menentukan apakah titik terletak di zona perataan.

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

Parameter

point
[di] Posisi titik.

dwBarAlignment
[out] Di mana titik diratakan. Lihat tabel di bagian Keterangan untuk nilai yang mungkin.

bOuterEdge
[out] TRUE jika titik terletak dekat dengan batas bingkai; FALSE jika titik tersebut terletak di area klien.

Tampilkan Nilai

TRUE jika titik terletak di zona perataan; jika tidak, FALSE.

Keterangan

Tabel berikut mencantumkan nilai yang mungkin untuk dwBarAlignment parameter .

Nilai Deskripsi
CBRS_ALIGN_TOP Diratakan ke bagian atas.
CBRS_ALIGN_RIGHT Diratakan ke kanan.
CBRS_ALIGN_BOTTOM Diratakan ke bagian bawah.
CBRS_ALIGN_LEFT Diratakan ke kiri.

CFrameWndEx::IsPrintPreview

Menentukan apakah jendela bingkai dalam mode pratinjau cetak.

BOOL IsPrintPreview();

Tampilkan Nilai

TRUE jika jendela bingkai dalam mode pratinjau cetak; jika tidak, FALSE.

Keterangan

CFrameWndEx::LoadFrame

Metode ini dipanggil setelah konstruksi untuk membuat jendela bingkai dan memuat sumber dayanya.

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

Parameter

nIDResource
[di] ID sumber daya yang digunakan untuk memuat semua sumber daya bingkai.

dwDefaultStyle
[di] Gaya jendela bingkai default.

pParentWnd
[di] Penunjuk ke jendela induk bingkai.

pContext
[di] Penunjuk CCreateContext ke kelas Struktur yang digunakan oleh kerangka kerja selama pembuatan aplikasi.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak, FALSE.

Keterangan

CFrameWndEx::NegotiateBorderSpace

Menerapkan negosiasi perbatasan klien OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parameter

nBorderCmd
[di] Perintah negosiasi perbatasan. Lihat bagian Keterangan untuk nilai yang mungkin.

lpRectBorder
[masuk, keluar] Dimensi batas.

Tampilkan Nilai

TRUE jika tata letak harus dihitung ulang; jika tidak, FALSE.

Keterangan

Tabel berikut mencantumkan nilai yang mungkin untuk nBorderCmd parameter .

borderGet
Dapatkan ruang klien OLE yang tersedia.

borderRequest
Meminta ruang klien OLE.

borderSet
Atur ruang klien OLE.

CFrameWndEx::OnActivate

Kerangka kerja memanggil metode ini ketika input pengguna dialihkan ke atau menjauh dari bingkai.

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

Parameter

nState
[di] Apakah bingkai aktif atau tidak aktif. Lihat tabel di bagian Keterangan untuk nilai yang mungkin.

pWndOther
[di] Penunjuk ke jendela lain yang mengalihkan input pengguna dengan yang saat ini.

bMinimized
[di] Status bingkai yang diminimalkan. TRUE jika bingkai diminimalkan; jika tidak, FALSE.

Keterangan

Tabel berikut mencantumkan nilai yang mungkin untuk nState parameter .

Nilai Deskripsi
WA_ACTIVE Bingkai dipilih oleh metode selain klik mouse.
WA_CLICKACTIVE Bingkai dipilih oleh klik mouse.
WA_INACTIVE Bingkai tidak dipilih.

CFrameWndEx::OnActivateApp

Dipanggil oleh kerangka kerja ketika aplikasi dipilih atau tidak dipilih.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parameter

bActive
[di] TRUE jika aplikasi dipilih; FALSE jika aplikasi tidak dipilih.

dwThreadID
[di] Parameter ini tidak digunakan.

Keterangan

CFrameWndEx::OnChangeVisualManager

Dipanggil oleh kerangka kerja saat perubahan pada bingkai memerlukan perubahan pada manajer visual.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[di] Parameter ini tidak digunakan.

lParam
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan 0.

Keterangan

CFrameWndEx::OnClose

Kerangka kerja memanggil metode ini untuk menutup bingkai.

afx_msg void OnClose();

Keterangan

Jika bingkai dalam mode pratinjau cetak, bingkai akan mengirim pesan Windows untuk menutup pratinjau cetak; jika tidak, jika bingkai menghosting klien OLE, klien dinonaktifkan.

CFrameWndEx::OnCloseDockingPane

Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Tutup pada panel docking.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Tampilkan Nilai

TRUE jika bilah docking dapat ditutup. FALSE Sebaliknya

Keterangan

Implementasi default tidak melakukan apa pun. Ambil alih metode ini jika Anda ingin menangani persembunyian bilah dok.

CFrameWndEx::OnCloseMiniFrame

Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol Tutup pada jendela bingkai mini mengambang.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Tampilkan Nilai

TRUE jika jendela bingkai mini mengambang dapat ditutup. FALSE sebaiknya.

Keterangan

Implementasi default tidak melakukan apa pun. Ambil alih metode ini jika Anda ingin memproses persembunyian jendela bingkai mini mengambang.

CFrameWndEx::OnClosePopupMenu

Dipanggil oleh kerangka kerja saat menu pop-up aktif memproses WM_DESTROY pesan.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parameter

pMenuPopup
Penunjuk ke menu pop-up.

Keterangan

Kerangka kerja mengirim WM_DESTROY pesan saat akan menutup jendela. Ambil alih metode ini jika Anda ingin menangani pemberitahuan dari CMFCPopupMenu objek milik jendela bingkai saat CMFCPopupMenu objek memproses pesan yang WM_DESTROY dikirim oleh kerangka kerja saat jendela sedang ditutup.

CFrameWndEx::OnCmdMsg

Mengirim pesan perintah.

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

Parameter

nID
[di] ID perintah.

nCode
[di] Kategori pesan perintah.

pExtra
[masuk, keluar] Penunjuk ke objek perintah.

pHandlerInfo
[masuk, keluar] Penunjuk ke struktur handler perintah.

Tampilkan Nilai

TRUE jika pesan perintah ditangani; jika tidak, FALSE.

Keterangan

CFrameWndEx::OnContextHelp

Dipanggil oleh kerangka kerja untuk menampilkan bantuan terkait konteks.

afx_msg void OnContextHelp();

Keterangan

CFrameWndEx::OnCreate

Dipanggil oleh kerangka kerja setelah bingkai dibuat.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parameter

lpCreateStruct
[di] Penunjuk ke CREATESTRUCT Struktur untuk bingkai baru.

Tampilkan Nilai

0 untuk melanjutkan pembuatan bingkai; -1 untuk menghancurkan bingkai.

Keterangan

CFrameWndEx::OnDestroy

Dipanggil oleh kerangka kerja ketika bingkai dihancurkan.

afx_msg void OnDestroy();

Keterangan

Tabel akselerator dan semua jendela dihancurkan.

CFrameWndEx::OnDrawMenuImage

Dipanggil oleh kerangka kerja saat aplikasi menggambar gambar yang terkait dengan item menu.

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

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

pMenuButton
[di] Penunjuk ke tombol menu yang gambarnya sedang dirender.

rectImage
[di] Penunjuk ke Rect struktur yang menentukan posisi layar dan ukuran gambar.

Tampilkan Nilai

TRUE jika kerangka kerja berhasil merender gambar; FALSE Sebaliknya.

Keterangan

Ambil alih metode ini jika Anda ingin menyesuaikan penyajian gambar untuk item menu milik bilah menu yang dimiliki oleh CFrameWndEx objek turunan.

Dipanggil oleh kerangka kerja saat CMFCPopupMenu objek memproses pesan WM_PAINT .

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

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

pMenu
[di] Penunjuk ke item menu.

rectLogo
[di] Referensi ke struktur konstanta CRect yang menentukan posisi layar dan ukuran logo menu.

Keterangan

Ambil alih fungsi ini jika Anda ingin menampilkan logo pada menu pop-up milik bilah menu yang dimiliki oleh CFrameWndEx objek turunan.

CFrameWndEx::OnDWMCompositionChanged

Dipanggil oleh kerangka kerja ketika komposisi Desktop Window Manager (DWM) telah diaktifkan atau dinonaktifkan.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[di] Parameter ini tidak digunakan.

lp
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan 0.

Keterangan

CFrameWndEx::OnExitSizeMove

Dipanggil oleh kerangka kerja ketika bingkai berhenti bergerak atau mengubah ukuran.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[di] Parameter ini tidak digunakan.

lp
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan 0.

Keterangan

CFrameWndEx::OnGetMinMaxInfo

Dipanggil oleh kerangka kerja saat bingkai diubah ukurannya untuk mengatur batas dimensi jendela.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parameter

lpMMI
[di] Penunjuk MINMAXINFO ke struktur.

Keterangan

CFrameWndEx::OnIdleUpdateCmdUI

Dipanggil oleh kerangka kerja untuk memperbarui tampilan bingkai saat pemrosesan perintah diam.

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

Parameter

wParam
[di] Parameter ini tidak digunakan.

lParam
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan 0.

Keterangan

CFrameWndEx::OnLButtonDown

Kerangka kerja memanggil metode ini ketika pengguna menekan tombol mouse kiri.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parameter

nFlags
[di] Menunjukkan apakah pengguna menekan tombol pengubah. Untuk nilai yang mungkin, lihat parameter wParam di WM_LBUTTONDOWN Pemberitahuan.

point
[di] Menentukan koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.

Keterangan

CFrameWndEx::OnLButtonUp

Kerangka kerja memanggil metode ini ketika pengguna merilis tombol mouse kiri.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parameter

nFlags
[di] Menunjukkan apakah pengguna menekan tombol pengubah. Untuk nilai yang mungkin, lihat parameter wParam di WM_LBUTTONUP Pemberitahuan.

point
[di] Menentukan koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.

Keterangan

CFrameWndEx::OnMenuButtonToolHitTest

Dipanggil oleh kerangka kerja saat CMFCToolBarButton objek memproses pesan WM_NCHITTEST .

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

Parameter

pButton
[di] Penunjuk ke tombol bilah alat.

pTI
[out] Penunjuk ke struktur informasi alat.

Tampilkan Nilai

TRUE jika aplikasi mengisi pTI parameter . FALSE sebaiknya.

Keterangan

Ambil alih metode ini jika Anda ingin memberikan informasi tipsalat tentang item menu tertentu.

CFrameWndEx::OnMenuChar

Dipanggil oleh kerangka kerja saat menu ditampilkan dan pengguna menekan tombol yang tidak sesuai dengan perintah.

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

Parameter

nChar
[di] Kode karakter tombol yang ditekan.

nFlags
[di] MF_POPUP Berisi bendera jika menu yang ditampilkan adalah submenu; berisi MF_SYSMENU bendera jika menu yang ditampilkan adalah menu kontrol.

pMenu
[di] Penunjuk ke menu.

Tampilkan Nilai

Kata berurutan tinggi harus salah satu nilai berikut.

Nilai Deskripsi
0 Kerangka kerja harus mengabaikan penekanan kunci.
1 Kerangka kerja harus menutup menu.
2 Kerangka kerja harus memilih salah satu item yang ditampilkan di menu. Kata berurutan rendah berisi ID perintah yang akan dipilih.

CFrameWndEx::OnMouseMove

Kerangka kerja memanggil metode ini ketika penunjuk bergerak.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parameter

nFlags
[di] Menunjukkan apakah pengguna menekan tombol pengubah. Untuk nilai yang mungkin, lihat parameter wParam di WM_MOUSEMOVE Pemberitahuan.

point
[di] Menentukan koordinat x dan y penunjuk relatif terhadap sudut kiri atas jendela.

Keterangan

CFrameWndEx::OnMoveMiniFrame

Dipanggil oleh kerangka kerja saat jendela panel bergerak.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameter

pFrame
[di] Penunjuk ke CPaneFrameWnd jendela panel Kelas .

Tampilkan Nilai

TRUE jika jendela panel tidak ditampung; FALSE jika jendela panel ditampung.

Keterangan

CFrameWndEx::OnNcActivate

Dipanggil oleh kerangka kerja ketika area non-klien bingkai harus digambar ulang untuk menunjukkan perubahan dalam status aktif.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parameter

bActive
[di] TRUE untuk menggambar bingkai aktif; FALSE untuk menggambar bingkai tidak aktif.

Tampilkan Nilai

Nonzero untuk melanjutkan pemrosesan default; 0 untuk mencegah area non-klien dinonaktifkan.

Keterangan

CFrameWndEx::OnNcCalcSize

Dipanggil oleh kerangka kerja ketika ukuran dan posisi area klien harus dihitung.

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

Parameter

bCalcValidRects
[di] TRUE ketika aplikasi harus menentukan area klien yang valid; jika tidak, FALSE.

lpncsp
[di] Penunjuk NCCALCSIZE_PARAMS ke struktur yang berisi perubahan dimensi bingkai.

Keterangan

CFrameWndEx::OnNcHitTest

Dipanggil oleh kerangka kerja saat penunjuk bergerak atau ketika tombol mouse ditekan atau dilepaskan.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parameter

point
[di] Lokasi pointer dalam koordinat layar.

Tampilkan Nilai

Pointer mencapai nilai enumerasi. Untuk daftar nilai yang mungkin, lihat WM_NCHITTEST Pemberitahuan.

Keterangan

CFrameWndEx::OnNcMouseMove

Dipanggil oleh kerangka kerja saat penunjuk bergerak di area non-klien.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parameter

nHitTest
[di] Pointer mencapai nilai enumerasi. Untuk daftar nilai yang mungkin, lihat WM_NCHITTEST Pemberitahuan.

point
[di] Lokasi pointer dalam koordinat layar.

Keterangan

CFrameWndEx::OnNcPaint

Dipanggil oleh kerangka kerja ketika area non-klien harus dicat.

afx_msg void OnNcPaint();

Keterangan

CFrameWndEx::OnPaneCheck

Dipanggil oleh kerangka kerja untuk mengontrol visibilitas panel.

afx_msg BOOL OnPaneCheck(UINT nID);

Parameter

nID
[di] ID kontrol panel.

Tampilkan Nilai

TRUE jika perintah ditangani; FALSE untuk melanjutkan pemrosesan perintah.

Keterangan

CFrameWndEx::OnPostPreviewFrame

Dipanggil oleh kerangka kerja saat pengguna mengubah mode pratinjau cetak.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[di] Parameter ini tidak digunakan.

lParam
[di] TRUE ketika bingkai dalam mode pratinjau cetak; FALSE saat mode pratinjau cetak nonaktif.

Tampilkan Nilai

Selalu mengembalikan 0.

Keterangan

CFrameWndEx::OnPowerBroadcast

Dipanggil oleh kerangka kerja ketika peristiwa manajemen daya terjadi.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[di] Peristiwa manajemen daya. Untuk daftar nilai yang mungkin, lihat WM_POWERBROADCAST Pesan.

lp
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Hasil dari memanggil prosedur jendela default.

Keterangan

CFrameWndEx::OnSetMenu

Dipanggil oleh kerangka kerja untuk mengganti menu jendela bingkai.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parameter

wp
[di] Tangani ke menu jendela bingkai baru.

lp
[di] Tangani ke menu jendela baru.

hmenu
[di] Tangani ke menu jendela bingkai baru.

Tampilkan Nilai

LRESULT adalah hasil dari memanggil prosedur jendela default.

BOOL adalah TRUE jika peristiwa ditangani; jika tidak, FALSE.

Keterangan

CFrameWndEx::OnSetPreviewMode

Dipanggil oleh kerangka kerja untuk mengatur mode pratinjau cetak untuk bingkai.

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

Parameter

bPreview
[di] TRUE untuk mengaktifkan pratinjau cetak; FALSE untuk menonaktifkan pratinjau cetak.

pState
[di] Penunjuk ke CPrintPreviewState struktur status bingkai.

Keterangan

CFrameWndEx::OnSetText

Dipanggil oleh kerangka kerja untuk mengatur teks jendela.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[di] Parameter ini tidak digunakan.

lParam
[di] Arahkan ke teks untuk jendela.

Tampilkan Nilai

Mengembalikan nilai dari panggilan ke DefWindowProc.

Keterangan

CFrameWndEx::OnShowCustomizePane

Dipanggil oleh kerangka kerja saat menampilkan QuickCustomizePane.

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

Parameter

pMenuPane
[di] Penunjuk ke panel kustomisasi cepat.

uiToolbarID
[di] ID kontrol bilah alat yang akan dikustomisasi.

Tampilkan Nilai

Metode ini selalu mengembalikan TRUE.

Keterangan

Menu kustomisasi cepat adalah menu pop-up yang muncul saat Anda mengklik tombol kustomisasi toolbar

CFrameWndEx::OnShowPanes

Dipanggil oleh kerangka kerja untuk memperlihatkan atau menyembunyikan panel.

virtual BOOL OnShowPanes(BOOL bShow);

Parameter

bShow
[di] TRUE jika aplikasi memperlihatkan panel; FALSE Sebaliknya.

Tampilkan Nilai

Metode ini selalu mengembalikan FALSE.

Keterangan

Implementasi default memperlihatkan panel jika bShow adalah TRUE dan panel disembunyikan atau kapan bShow dan FALSE panel terlihat.

Implementasi default menyembunyikan panel jika bShow adalah TRUE dan panel terlihat atau kapan bShow dan FALSE panel disembunyikan.

Ambil alih metode ini dalam kelas turunan untuk menjalankan kode kustom saat kerangka kerja memperlihatkan atau menyembunyikan panel.

CFrameWndEx::OnShowPopupMenu

Dipanggil oleh kerangka kerja saat menampilkan menu pop-up.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parameter

pMenu
[di] Penunjuk ke menu pop-up.

Tampilkan Nilai

TRUE jika menu pop-up terlihat; jika tidak FALSE.

Keterangan

Ambil alih metode ini di kelas turunan untuk menjalankan kode kustom saat kerangka kerja menampilkan menu pop-up. Misalnya, ambil alih metode ini untuk mengubah warna latar belakang perintah di menu pop-up.

CFrameWndEx::OnSize

Dipanggil oleh kerangka kerja setelah ukuran bingkai berubah.

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

Parameter

nType
[di] Jenis mengubah ukuran. Untuk kemungkinan nilai, lihat parameter wParam di Pemberitahuan WM_SIZE.

cx
[di] Lebar bingkai baru dalam piksel.

cy
[di] Tinggi bingkai baru dalam piksel.

Keterangan

CFrameWndEx::OnSizing

Dipanggil oleh kerangka kerja saat pengguna mengubah ukuran bingkai.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parameter

fwSide
[di] Tepi bingkai yang dipindahkan. Lihat parameter wParam di WM_SIZING Pemberitahuan.

pRect
[masuk, keluar] Penunjuk CRect ke struktur atau RECT yang berisi koordinat bingkai.

Keterangan

CFrameWndEx::OnSysColorChange

Dipanggil oleh kerangka kerja ketika warna sistem berubah.

void OnSysColorChange();

Keterangan

CFrameWndEx::OnTearOffMenu

Dipanggil oleh kerangka kerja ketika aplikasi menampilkan menu yang memiliki bilah robek.

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

Parameter

pMenuPopup
[di] Penunjuk ke menu pop-up.

pBar
[di] Penunjuk ke bar air mata.

Tampilkan Nilai

TRUE jika menu pop-up dengan bilah robek diaktifkan; jika tidak FALSE.

Keterangan

Ambil alih metode ini di kelas turunan untuk menjalankan kode kustom saat kerangka kerja menampilkan bilah kontrol.

Implementasi default tidak melakukan apa pun dan mengembalikan TRUE.

CFrameWndEx::OnToolbarContextMenu

Dipanggil oleh kerangka kerja untuk membuat menu pop-up toolbar.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[di] Parameter ini tidak digunakan.

lp
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan 1.

Keterangan

CFrameWndEx::OnToolbarCreateNew

Kerangka kerja memanggil metode ini untuk membuat toolbar baru.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[di] Parameter ini tidak digunakan.

lp
[di] Arahkan ke teks untuk bilah judul toolbar.

Tampilkan Nilai

Penunjuk ke toolbar baru; atau NULL jika toolbar tidak dibuat.

Keterangan

CFrameWndEx::OnToolbarDelete

Dipanggil oleh kerangka kerja saat toolbar dihapus.

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

Parameter

unused
[di] Parameter ini tidak digunakan.

lp
[di] Penunjuk ke toolbar.

Tampilkan Nilai

TRUE jika toolbar dihapus; jika tidak, FALSE.

Keterangan

CFrameWndEx::OnUpdateFrameMenu

Dipanggil oleh kerangka kerja untuk mengatur menu bingkai.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parameter

hMenuAlt
[di] Tangani ke menu alternatif.

Keterangan

CFrameWndEx::OnUpdateFrameTitle

Kerangka kerja memanggil metode ini untuk memperbarui bilah judul jendela bingkai.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parameter

bAddToTitle
[di] TRUE untuk menambahkan judul dokumen aktif ke bilah judul jendela bingkai; jika tidak FALSE.

Keterangan

CFrameWndEx::OnUpdatePaneMenu

Dipanggil oleh kerangka kerja untuk memperbarui menu panel.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parameter

pCmdUI
[di] Penunjuk ke objek antarmuka pengguna panel.

Keterangan

CFrameWndEx::OnWindowPosChanged

Dipanggil oleh kerangka kerja ketika ukuran bingkai, posisi, atau z-order telah berubah karena panggilan ke metode manajemen jendela.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parameter

lpwndpos
[di] Penunjuk WINDOWPOS ke struktur yang berisi ukuran dan posisi baru.

Keterangan

CFrameWndEx::PaneFromPoint

Mencari setiap panel untuk titik yang diberikan.

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

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

Parameter

point
[di] Koordinat layar titik untuk diperiksa.

nSensitivity
[di] Perluas persegi panjang pembatas setiap bilah kontrol dengan jumlah ini saat mencari titik.

bExactBar
[di] TRUE untuk mengabaikan nSensitivity parameter; jika tidak, FALSE.

pRTCBarType
[di] Jika tidak NULL, metode hanya mencari bilah kontrol dari jenis yang ditentukan.

dwAlignment
[out] Jika berhasil, parameter ini berisi sisi bilah kontrol yang paling dekat dengan titik yang ditentukan. Jika tidak, parameter ini tidak diinisialisasi.

Tampilkan Nilai

Penunjuk ke bilah kontrol yang berisi point; NULL jika tidak ada kontrol yang ditemukan.

Keterangan

Metode ini mencari semua bilah kontrol di aplikasi Anda untuk .point

Gunakan nSensitivity untuk meningkatkan ukuran area pencarian. Gunakan pRTCBarType untuk membatasi jenis bilah kontrol yang dicari metode.

CFrameWndEx::PreTranslateMessage

Menangani pesan jendela tertentu sebelum dikirim.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

pMsg
[di] Penunjuk ke MSG struktur yang berisi pesan untuk diproses.

Tampilkan Nilai

Bukan nol jika pesan ditangani dan tidak boleh dikirim; 0 jika pesan tidak ditangani dan harus dikirim.

Keterangan

CFrameWndEx::RecalcLayout

Menyesuaikan tata letak bingkai dan jendela anaknya.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameter

bNotify
[di] Menentukan apakah akan memberi tahu item klien OLE tentang perubahan tata letak.

Keterangan

Metode ini dipanggil ketika ukuran jendela bingkai telah berubah atau ketika bilah kontrol ditampilkan atau disembunyikan.

CFrameWndEx::RemovePaneFromDockManager

Membatalkan pendaftaran panel dan menghapusnya dari manajer docking.

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

Parameter

pControlBar
[di] Penunjuk ke panel bilah kontrol untuk dihapus.

bDestroy
[di] TRUE untuk menghancurkan bilah kontrol setelah menghapusnya; FALSE Sebaliknya.

bAdjustLayout
[di] TRUE untuk menyesuaikan tata letak docking; FALSE Sebaliknya.

bAutoHide
[di] TRUE jika bilah kontrol dalam mode sembunyikan otomatis; FALSE Sebaliknya.

pBarReplacement
[di] Penunjuk ke panel yang menggantikan panel yang dihapus.

Keterangan

Gunakan metode ini untuk menghapus bilah kontrol dari tata letak dok jendela bingkai.

Kelas CDockingManager menangani tata letak bilah kontrol. Anda harus mendaftarkan setiap bilah kontrol dengan manajer docking dengan menggunakan CFrameWndEx::AddPane metode atau CFrameWndEx::InsertPane metode .

CFrameWndEx::SetDockState

Memulihkan tata letak docking ke status docking yang disimpan dalam registri.

void SetDockState(const CDockState& state);

Parameter

state
Status docking. Parameter diabaikan

CFrameWndEx::SetPrintPreviewFrame

Mengatur jendela bingkai pratinjau cetak.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parameter

pWnd
[di] Penunjuk ke jendela bingkai pratinjau cetak.

Keterangan

CFrameWndEx::SetupToolbarMenu

Menyisipkan perintah yang ditentukan pengguna ke dalam menu bilah alat.

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

Parameter

menu
[di] Objek CMenu yang akan dimodifikasi.

uiViewUserToolbarCmdFirst
[di] Perintah pertama yang ditentukan pengguna.

uiViewUserToolbarCmdLast
[di] Perintah terakhir yang ditentukan pengguna.

Keterangan

Kerangka kerja menyimpan perintah yang ditentukan pengguna dalam daftar. Gunakan uiViewUserToolbarCmdFirst dan uiViewUserToolbarCmdList untuk menentukan indeks perintah yang akan disisipkan.

CFrameWndEx::ShowFullScreen

Mengalihkan bingkai utama antara mode layar penuh dan mode reguler.

void ShowFullScreen();

CFrameWndEx::ShowPane

Memperlihatkan atau menyembunyikan panel yang ditentukan.

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

Parameter

pBar
[di] Penunjuk ke bilah kontrol untuk ditampilkan atau disembunyikan.

bShow
[di] Jika TRUE, aplikasi menunjukkan bilah kontrol. Jika tidak, aplikasi menyembunyikan bilah kontrol.

bDelay
[di] Jika TRUE, tunda penyesuaian tata letak docking hingga kerangka kerja memanggil CFrameWndEx::AdjustDockingLayout. Jika tidak, segera hitung ulang tata letak docking.

bActivate
[di] Jika TRUE, aktifkan bilah kontrol. Jika tidak, tampilkan bilah kontrol dalam status tidak aktif.

CFrameWndEx::UpdateCaption

Dipanggil oleh kerangka kerja untuk memperbarui keterangan bingkai jendela.

void UpdateCaption();

Keterangan

CFrameWndEx::WinHelp

Memanggil aplikasi WinHelp atau bantuan terkait konteks.

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

Parameter

dwData
Data yang bergantung pada nCmd parameter . Untuk daftar nilai yang mungkin, lihat WinHelp.

nCmd
Perintah bantuan. Untuk daftar nilai yang mungkin, lihat WinHelp.

Keterangan

Lihat juga

Bagan Hierarki
Kelas
CFrameWnd