Kelas CMDIChildWndEx

Artikel
06/16/2023

Kelas ini CMDIChildWndEx menyediakan fungsionalitas jendela turunan antarmuka beberapa dokumen (MDI) Windows. Ini memperluas fungsionalitas CMDIChildWnd Class. Kerangka kerja memerlukan kelas ini ketika aplikasi MDI menggunakan kelas MFC tertentu.

Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

Sintaks

class CMDIChildWndEx : public CMDIChildWnd

Anggota

Metode Publik

Nama	Deskripsi
CMDIChildWndEx::ActivateTopLevelFrame	Dipanggil secara internal oleh kerangka kerja untuk mengaktifkan bingkai tingkat atas ketika aplikasi harus diaktifkan dari tab taskbar.
`CMDIChildWndEx::AddDockSite`	Metode ini tidak digunakan atau diimplementasikan.
CMDIChildWndEx::AddPane	Menambahkan panel.
CMDIChildWndEx::AddTabbedPane	Menambahkan panel bertab.
CMDIChildWndEx::AdjustDockingLayout	Menyesuaikan tata letak docking.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Memberi tahu kerangka kerja apakah anak MDI ini dapat ditampilkan pada tab taskbar Windows 7.
CMDIChildWndEx::CanShowOnWindowsList	Mengembalikan TRUE jika nama jendela anak MDI dapat ditampilkan dalam kotak dialog Kelas CMFCWindowsManagerDialog. Jika tidak, mengembalikan FALSE.
`CMDIChildWndEx::CreateObject`	Dipanggil oleh kerangka kerja untuk membuat instans dinamis dari jenis kelas ini.
CMDIChildWndEx::D ockPane	Menambungkan panel.
CMDIChildWndEx::D ockPaneLeftOf	Menamamkan satu panel di sebelah kiri panel lain.
CMDIChildWndEx::EnableAutoHidePanes	Mengaktifkan mode sembunyikan otomatis untuk panel saat ditampar di sisi jendela yang ditentukan.
CMDIChildWndEx::EnableDocking	Memungkinkan docking jendela anak ke bingkai utama.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Mengaktifkan atau menonaktifkan pilihan otomatis sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Mengembalikan nama dokumen yang ditampilkan di jendela anak MDI.
CMDIChildWndEx::GetFrameIcon	Dipanggil oleh kerangka kerja untuk mengambil ikon jendela anak MDI.
CMDIChildWndEx::GetFrameText	Dipanggil oleh kerangka kerja untuk mengambil teks untuk jendela anak MDI.
CMDIChildWndEx::GetPane	Menemukan panel menurut ID kontrol yang ditentukan.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Mengembalikan penunjuk ke panel docking yang disematkan yang dikonversi ke dokumen bertab.
CMDIChildWndEx::GetTabProxyWnd	Mengembalikan jendela proksi tab yang benar-benar terdaftar dengan tab taskbar Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd	Dipanggil oleh kerangka kerja ketika perlu mendapatkan jendela anak (biasanya tampilan atau jendela pemisah) untuk ditampilkan pada gambar mini tab taskbar Windows 7.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	Dipanggil oleh kerangka kerja saat perlu memilih sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.
`CMDIChildWndEx::GetThisClass`	Dipanggil oleh kerangka kerja untuk mendapatkan penunjuk ke objek CRuntimeClass yang terkait dengan jenis kelas ini.
CMDIChildWndEx::GetToolbarButtonToolTipText	Dipanggil oleh kerangka kerja untuk mengambil tipsalat untuk tombol toolbar.
CMDIChildWndEx::InsertPane	Mendaftarkan panel yang ditentukan dengan manajer docking.
CMDIChildWndEx::InvalidateiconicBitmaps	Membatalkan representasi bitmap ikonik dari anak MDI.
CMDIChildWndEx::IsPointNearDockSite	Menentukan apakah titik yang ditentukan berada di dekat situs dok.
CMDIChildWndEx::IsReadOnly	Mengembalikan TRUE jika dokumen yang ditampilkan di jendela anak bersifat baca-saja. Jika tidak, mengembalikan FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Mengembalikan TRUE jika anak MDI berhasil didaftarkan dengan tab taskbar Windows 7.
CMDIChildWndEx::IsTabbedPane	Mengembalikan TRUE jika jendela anak MDI berisi panel docking. Jika tidak, mengembalikan FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Memberi tahu apakah anak MDI dapat muncul pada tab taskbar Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Memberi tahu apakah pemilihan otomatis sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar diaktifkan atau dinonaktifkan.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	Kombinasi bendera, yang diteruskan oleh kerangka kerja ke metode SetTaskbarTabProperties, ketika tab (anak MDI) didaftarkan dengan tab taskbar Windows 7. Kombinasi defaultnya adalah `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	Dipanggil oleh kerangka kerja ketika perlu mendapatkan bitmap untuk pratinjau langsung anak MDI.
CMDIChildWndEx::OnGetIconicThumbnail	Dipanggil oleh kerangka kerja ketika perlu mendapatkan bitmap untuk gambar mini ikonik anak MDI.
CMDIChildWndEx::OnMoveMiniFrame	Dipanggil oleh kerangka kerja untuk memindahkan jendela bingkai mini.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	Dipanggil oleh kerangka kerja saat pengguna menekan tombol tutup pada gambar mini tab Bilah Tugas.
CMDIChildWndEx::OnSetPreviewMode	Dipanggil oleh kerangka kerja untuk memasuki atau keluar dari mode pratinjau cetak.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	Dipanggil oleh kerangka kerja ketika gambar mini tab Taskbar harus memproses pesan WM_ACTIVATE.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	Dipanggil oleh kerangka kerja ketika gambar mini tab Taskbar harus memproses pesan WM_MOUSEACTIVATE.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	Dipanggil oleh kerangka kerja ketika perlu meregangkan bitmap untuk pratinjau gambar mini tab taskbar Windows 7 dari anak MDI.
CMDIChildWndEx::OnUpdateFrameTitle	Dipanggil oleh kerangka kerja untuk memperbarui judul bingkai. (Mengambil alih `CMDIChildWnd::OnUpdateFrameTitle`.)
CMDIChildWndEx::P aneFromPoint	Mengembalikan panel yang berisi titik yang diberikan.
`CMDIChildWndEx::PreTranslateMessage`	Digunakan oleh CWinApp kelas untuk menerjemahkan pesan jendela sebelum dikirim ke fungsi Windows TranslateMessage dan DispatchMessage. (Penimpaan CWnd::P reTranslateMessage.)
CMDIChildWndEx::RecalcLayout	Menghitung ulang tata letak jendela.
CMDIChildWndEx::RegisterTaskbarTab	Mendaftarkan anak MDI dengan tab taskbar Windows 7.
CMDIChildWndEx::RemovePaneFromDockManager	Menghapus panel dari manajer docking.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Mengaktifkan tab bilah tugas Windows 7 yang sesuai.
CMDIChildWndEx::SetTaskbarTabOrder	Menyisipkan anak MDI sebelum jendela yang ditentukan pada tab taskbar Windows 7.
CMDIChildWndEx::SetTaskbarTabProperties	Mengatur properti untuk tab bilah tugas Windows 7.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	Dipanggil secara internal oleh kerangka kerja untuk mengatur kliping persegi untuk memilih sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Menghapus anak MDI dari tab taskbar Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon	Memperbarui ikon tab bilah tugas Windows 7.

Keterangan

Untuk memanfaatkan fitur docking yang diperluas dalam aplikasi MDI, dapatkan kelas jendela anak MDI dari aplikasi Anda, CMDIChildWndEx bukan CMDIChildWnd.

Contoh

Contoh berikut memperoleh kelas dari CMDIChildWndEx. Cuplikan kode ini berasal dari Sampel VisualStudioDemo: Aplikasi MFC Visual Studio.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

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

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

Hierarki Warisan

Persyaratan

Header: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Menambahkan panel.

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

Parameter

pControlBar
[di] Penunjuk ke panel.

bTail
[di] TRUE untuk menambahkan panel ke akhir daftar panel untuk manajer docking; jika tidak, FALSE.

Tampilkan Nilai

TRUE jika panel berhasil didaftarkan dengan manajer docking; jika tidak, FALSE.

CMDIChildWndEx::AddTabbedPane

Menambahkan panel bertab.

void AddTabbedPane(CDockablePane* pControlBar);

Parameter

pControlBar
[di] Penunjuk ke panel.

CMDIChildWndEx::AdjustDockingLayout

Menyesuaikan tata letak docking.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parameter

hdwp
[di] Tangani ke struktur posisi jendela yang ditangguhkan.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Tampilkan Nilai

Keterangan

CMDIChildWndEx::CanShowOnWindowsList

Menentukan apakah nama jendela anak MDI dapat ditampilkan dalam kotak dialog Kelas CMFCWindowsManagerDialog.

virtual BOOL CanShowOnWindowsList();

Tampilkan Nilai

TRUE jika jendela dapat ditampilkan dalam kotak dialog Windows ; jika tidak, FALSE.

Keterangan

Ambil alih metode ini di kelas turunan dan kembaliKAN FALSE jika jendela tidak boleh ditampilkan dalam kotak dialog Windows . Fungsi ini dipanggil dari CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Menambungkan panel.

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

Parameter

pBar
[di] Penunjuk ke panel.

nDockBarID
[di] ID panel.

lpRect
[di] Penunjuk ke persegi panjang.

Keterangan

Parameter lpRect tidak digunakan.

CMDIChildWndEx::D ockPaneLeftOf

Menamamkan satu panel di sebelah kiri panel lain.

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

Parameter

pBar
Penunjuk ke panel yang akan ditampar.

pLeftOf
Penunjuk ke panel yang berfungsi sebagai titik referensi.

Tampilkan Nilai

TRUE pada keberhasilan, FALSE pada kegagalan.

Keterangan

Metode ini mengambil panel yang ditentukan oleh pBar dan menambatkannya di sisi kiri panel yang ditentukan oleh pLeftOf.

Panggil metode ini saat Anda ingin menambatkan beberapa panel dalam urutan yang telah ditentukan sebelumnya.

CMDIChildWndEx::EnableAutoHidePanes

Mengaktifkan mode sembunyikan otomatis untuk panel saat ditampar di sisi jendela yang ditentukan.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameter

dwDockStyle
[di] Menentukan sisi jendela bingkai utama yang diaktifkan. Gunakan satu atau beberapa bendera berikut.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

CMDIChildWndEx::EnableDocking

Memungkinkan docking jendela anak ke bingkai utama.

BOOL EnableDocking(DWORD dwDockStyle);

Parameter

dwDockStyle
[di] Menentukan perataan docking untuk diaktifkan.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

Panggil metode ini untuk mengaktifkan perataan docking ke bingkai utama. Anda dapat meneruskan kombinasi bendera CBRS_ALIGN_ (untuk informasi selengkapnya, lihat CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetDocumentName

Mengembalikan nama dokumen yang ditampilkan di jendela anak MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Tampilkan Nilai

Penunjuk ke string yang berisi nama dokumen.

Keterangan

Dokumen adalah apa yang ditampilkan oleh jendela anak MDI. Umumnya, jendela menampilkan data yang dimuat dari atau disimpan ke file. Oleh karena itu, nama dokumen adalah nama file. Implementasi GetDocumentName default mengembalikan string yang diperoleh dari CDocument::GetPathName.

Jika jendela menampilkan dokumen yang tidak dimuat dari file, ambil alih metode ini di kelas turunan dan kembalikan pengidentifikasi dokumen unik.

GetDocumentName dipanggil oleh kerangka kerja ketika menyimpan status semua dokumen yang dibuka. String yang dikembalikan ditulis ke registri.

Ketika kerangka kerja memulihkan status nanti, nama dokumen dibaca dari registri dan diteruskan ke CMDIFrameWndEx::CreateDocumentWindow. Ambil alih metode ini dalam kelas turunan CMDIFrameWndEx dan buat atau buka dokumen yang memiliki nama ini dan baca dalam file yang memiliki nama ini. Jika dokumen tidak didasarkan pada file, buat dokumen berdasarkan pengidentifikasi dokumen itu sendiri. Anda harus melakukan tindakan sebelumnya hanya jika Anda ingin menyimpan dan memulihkan dokumen.

Contoh

Contoh berikut menunjukkan penggunaan GetDocumentName metode . Cuplikan kode ini berasal dari Sampel VisualStudioDemo: Aplikasi MFC Visual Studio.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx::GetFrameIcon

Dipanggil oleh kerangka kerja untuk mengambil ikon jendela anak MDI.

virtual HICON GetFrameIcon() const;

Tampilkan Nilai

Handel ke ikon jendela.

Keterangan

Metode ini dipanggil oleh kerangka kerja untuk menentukan ikon apa yang akan ditampilkan pada tab MDI yang berisi jendela bingkai anak MDI.

Secara default metode ini mengembalikan ikon jendela. Ambil alih GetFrameIcon di CMDIChildWndExkelas -turunan untuk menyesuaikan perilaku ini.

CMDIChildWndEx::GetFrameText

Dipanggil oleh kerangka kerja untuk mengambil teks untuk jendela anak MDI.

virtual CString GetFrameText() const;

Tampilkan Nilai

String yang berisi teks jendela bingkai.

Keterangan

Metode ini dipanggil oleh kerangka kerja untuk menentukan teks apa yang akan ditampilkan pada tab MDI yang berisi jendela bingkai anak MDI.

Secara default metode ini mengembalikan teks jendela. Ambil alih GetFrameText di CMDIChildWndExkelas -turunan untuk menyesuaikan perilaku ini.

CMDIChildWndEx::GetPane

Menemukan panel menurut ID kontrol yang ditentukan.

CBasePane* GetPane(UINT nID);

Parameter

Nid
[di] ID kontrol panel yang akan ditemukan.

Tampilkan Nilai

Penunjuk ke panel jika ditemukan, jika tidak, NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetTabbedPane

Mengembalikan penunjuk ke panel docking yang merupakan bagian dari grup dokumen bertab MDI.

CDockablePane* GetTabbedPane() const;

Tampilkan Nilai

Penunjuk ke panel docking yang merupakan bagian dari grup dokumen bertab MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

Dipanggil oleh kerangka kerja untuk mengambil tipsalat untuk tombol toolbar.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Tampilkan Nilai

TRUE jika tipsalat telah ditampilkan. Implementasi default mengembalikan FALSE.

Keterangan

Ambil alih metode ini jika Anda ingin menampilkan tips alat kustom untuk tombol toolbar.

CMDIChildWndEx::InsertPane

Mendaftarkan panel yang ditentukan dengan manajer docking.

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

Parameter

pControlBar
[di] Penunjuk ke panel untuk disisipkan.

pTarget
[di] Penunjuk ke panel yang berdekatan.

bAfter
[di] Jika TRUE, pControlBar dimasukkan setelah pTarget. Jika FALSE, pControlBar dimasukkan sebelum pTarget.

Tampilkan Nilai

TRUE jika metode berhasil, FALSE sebaliknya.

CMDIChildWndEx::IsPointNearDockSite

Menentukan apakah titik yang ditentukan berada di dekat situs dok.

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

Parameter

ujung
[di] Titik yang ditentukan.

dwBarAlignment
[di] Menentukan tepi mana yang titiknya dekat. Nilai yang mungkin CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP, dan CBRS_ALIGN_BOTTOM

bOuterEdge
[di] TRUE jika titik berada di dekat batas luar situs dok; FALSE jika tidak.

Tampilkan Nilai

TRUE jika titik berada di dekat situs dok; jika tidak FALSE.

Keterangan

Titik berada di dekat situs dok ketika berada dalam sensitivitas yang ditetapkan di manajer docking. Sensitivitas default adalah 15 piksel.

CMDIChildWndEx::IsReadOnly

Menentukan apakah dokumen yang ditampilkan di jendela anak bersifat baca-saja.

virtual BOOL IsReadOnly();

Tampilkan Nilai

TRUE jika dokumen bersifat baca-saja; jika tidak FALSE.

Keterangan

Fungsi ini digunakan untuk mencegah penyimpanan dokumen baca-saja.

Contoh

Contoh berikut menunjukkan pengesampingan IsReadOnly metode. Cuplikan kode ini berasal dari Sampel VisualStudioDemo: Aplikasi MFC Visual Studio.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx::IsTabbedPane

Menentukan apakah jendela anak MDI berisi panel docking.

BOOL IsTabbedPane() const;

Tampilkan Nilai

TRUE jika jendela anak MDI berisi panel docking yang dikonversi ke dokumen bertab; jika tidak FALSE.

CMDIChildWndEx::OnMoveMiniFrame

Dipanggil oleh kerangka kerja untuk memindahkan jendela bingkai mini.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameter

pFrame
[di] Penunjuk ke jendela bingkai mini.

Tampilkan Nilai

TRUE jika metode berhasil, jika tidak FALSE.

CMDIChildWndEx::OnSetPreviewMode

Dipanggil oleh kerangka kerja untuk memasuki atau keluar dari mode pratinjau cetak.

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

Parameter

bPreview
[di] Jika TRUE, masukkan mode pratinjau cetak. Jika FALSE, keluar dari mode pratinjau cetak.

pState
[di] Penunjuk ke struktur status pratinjau cetak.

CMDIChildWndEx::OnUpdateFrameTitle

Dipanggil oleh kerangka kerja untuk memperbarui judul bingkai.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parameter

bAddToTitle
[di] Jika TRUE, tambahkan nama dokumen ke judul.

CMDIChildWndEx::P aneFromPoint

Mengembalikan panel yang berisi 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

ujung
[di] Menentukan titik, dalam koordinat layar, untuk memeriksa.

nSensitivitas
[di] Tingkatkan area pencarian dengan jumlah ini. Panel memenuhi kriteria pencarian jika titik yang diberikan berada di area yang ditingkatkan.

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

pRTCBarType
[di] Jika bukan NULL, metode hanya mencari panel dari jenis yang ditentukan.

dwAlignment
[di] Jika panel ditemukan pada titik yang ditentukan, parameter ini berisi sisi panel yang paling dekat dengan titik yang ditentukan. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Tampilkan Nilai

Penunjuk ke CBasePaneobjek -turunan yang berisi titik tertentu, atau NULL jika tidak ada panel yang ditemukan.

Keterangan

Panggil metode ini untuk menentukan apakah panel berisi titik yang ditentukan sesuai dengan kondisi yang ditentukan seperti kelas runtime dan visibilitas.

Saat fungsi kembali dan panel ditemukan, dwAlignment berisi perataan titik yang ditentukan. Misalnya, jika titik paling dekat dengan bagian atas panel, dwAlignment diatur ke CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Menghitung ulang tata letak jendela.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameter

bNotify
[di] Jika TRUE, item aktif di tempat untuk jendela menerima pemberitahuan perubahan tata letak.

CMDIChildWndEx::RemovePaneFromDockManager

Menghapus panel dari manajer docking.

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

Parameter

pControlBar
[di] Penunjuk ke panel untuk dihapus.

bDestroy
[di] Jika TRUE, panel yang dihapus akan dihancurkan.

bAdjustLayout
[di] Jika TRUE, segera sesuaikan tata letak docking.

bAutoHide
[di] Jika TRUE, tata letak docking terkait dengan daftar bilah autohide. Jika FALSE, tata letak docking terkait dengan daftar panel reguler.

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

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parameter

[di] p

Keterangan

CMDIChildWndEx::ShowPane

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

Parameter

[di] pBar

[di] bShow

[di] bDelay

[di] bActivate

Keterangan

CMDIChildWndEx::UpdateTaskbarTabIcon

Memperbarui ikon tab bilah tugas Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parameter

hIcon
Handel ke ikon untuk ditampilkan pada tab bilah tugas Windows 7.

Keterangan

CMDIChildWndEx::UnregisterTaskbarTab

Menghapus anak MDI dari tab taskbar Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parameter

bCheckRegisteredMDIChildCount
Menentukan apakah fungsi ini perlu memeriksa jumlah anak MDI yang terdaftar di tab MDI. Jika angka ini adalah 0, maka fungsi ini menghapus persegi panjang kliping dari gambar mini taskbar aplikasi.

Keterangan

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Dipanggil oleh kerangka kerja untuk mengatur persegi panjang kliping untuk memilih sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parameter

rect
Menentukan persegi panjang kliping baru. Jika persegi panjang kosong atau null, kliping akan dihapus.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

CMDIChildWndEx::SetTaskbarTabProperties

Mengatur properti untuk tab bilah tugas Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parameter

dwFlags
Kombinasi nilai STPFLAG. Untuk informasi selengkapnya, lihat ITaskbarList4::SetTabProperties.

Keterangan

CMDIChildWndEx::SetTaskbarTabOrder

Menyisipkan anak MDI sebelum jendela yang ditentukan pada tab taskbar Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parameter

pWndBefore
Penunjuk ke jendela anak MDI yang gambar mininya disisipkan ke kiri. Jendela ini harus sudah didaftarkan melalui RegisterTaskbarTab. Jika nilai ini NULL, gambar mini baru ditambahkan ke akhir daftar.

Keterangan

CMDIChildWndEx::SetTaskbarTabActive

Mengaktifkan tab bilah tugas Windows 7 yang sesuai.

void SetTaskbarTabActive();

Keterangan

CMDIChildWndEx::RegisterTaskbarTab

Mendaftarkan anak MDI dengan tab taskbar Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parameter

Keterangan

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Dipanggil oleh kerangka kerja ketika perlu meregangkan bitmap untuk pratinjau gambar mini tab taskbar Windows 7 dari anak MDI.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

Parameter

hBmpDst
Handel ke bitmap tujuan.

rectDst
Menentukan persegi tujuan.

hBmpSrc
Handel ke bitmap sumber.

rectSrc
Menentukan persegi sumber.

Keterangan

Persyaratan : afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Dipanggil oleh kerangka kerja ketika gambar mini tab Taskbar harus memproses pesan WM_MOUSEACTIVATE.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

Parameter

pDesktopWnd
Menentukan penunjuk ke jendela induk tingkat atas jendela yang diaktifkan. Penunjuk mungkin bersifat sementara dan tidak boleh disimpan.

nHitTest
Menentukan kode area hit-test. Tes hit adalah pengujian yang menentukan lokasi kursor.

message
Menentukan nomor pesan mouse.

Keterangan

Implementasi default mengaktifkan bingkai turunan MDI terkait.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Dipanggil oleh kerangka kerja ketika gambar mini tab Taskbar harus memproses pesan WM_ACTIVATE.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parameter

nState
Menentukan apakah CWnd sedang diaktifkan atau dinonaktifkan.

pWndOther
Penunjuk ke yang CWnd diaktifkan atau dinonaktifkan. Penunjuk bisa NULL, dan mungkin bersifat sementara.

bMinimized
Menentukan status yang diminimalkan dari diaktifkan CWnd atau dinonaktifkan. Nilai TRUE menunjukkan jendela diminimalkan.

Keterangan

Implementasi default mengaktifkan bingkai turunan MDI terkait.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Dipanggil oleh kerangka kerja saat pengguna menekan tombol tutup pada gambar mini tab Bilah Tugas.

virtual void OnPressTaskbarThmbnailCloseButton();

Keterangan

CMDIChildWndEx::OnGetIconicThumbnail

Dipanggil oleh kerangka kerja ketika perlu mendapatkan bitmap untuk gambar mini ikonik anak MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parameter

nWidth
Menentukan lebar bitmap yang diperlukan.

nHeight
Menentukan tinggi bitmap yang diperlukan.

Keterangan

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Dipanggil oleh kerangka kerja ketika perlu mendapatkan bitmap untuk pratinjau langsung anak MDI.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

Parameter

bIsMDIChildActive
Parameter ini TRUE jika bitmap diminta untuk anak MDI, yang saat ini aktif dan jendela utama tidak diminimalkan. Pemrosesan default dalam hal ini mengambil rekam jepret jendela utama.

ptLocation
Menentukan lokasi bitmap dalam koordinat klien jendela utama (tingkat atas). Poin ini harus disediakan oleh penerima panggilan.

Tampilkan Nilai

Jika diproses, mengembalikan handel ke bitmap 32bpp yang valid, jika tidak, NULL.

Keterangan

Ambil alih metode ini di kelas turunan dan kembalikan bitmap 32bpp yang valid untuk pratinjau langsung anak MDI. Metode ini hanya dipanggil ketika anak MDI ditampilkan pada tab taskbar Windows 7. Jika Anda mengembalikan NULL, MFC memanggil handler default dan mendapatkan bitmap menggunakan PrintClient atau PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Kombinasi bendera, yang diteruskan oleh kerangka kerja ke SetTaskbarTabProperties metode , ketika tab (anak MDI) didaftarkan dengan tab taskbar Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Keterangan

Kombinasi defaultnya adalah STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Memberi tahu apakah pemilihan otomatis sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar diaktifkan atau dinonaktifkan.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Tampilkan Nilai

Mengembalikan TRUE jika pemilihan otomatis bagian dari area klien jendela yang akan ditampilkan diaktifkan; jika tidak FALSE.

Keterangan

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Memberi tahu apakah anak MDI dapat muncul pada tab taskbar Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Tampilkan Nilai

TRUE jika anak MDI dapat muncul pada tab taskbar Windows 7; FALSE jika anak MDI tidak dapat muncul pada tab taskbar Windows 7.

Keterangan

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Mengembalikan TRUE jika anak MDI berhasil didaftarkan dengan tab taskbar Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Tampilkan Nilai

TRUE jika anak MDI terdaftar di tab taskbar Windows 7; jika tidak FALSE.

Keterangan

CMDIChildWndEx::InvalidateiconicBitmaps

Membatalkan representasi bitmap ikonik dari anak MDI.

BOOL InvalidateIconicBitmaps();

Tampilkan Nilai

Mengembalikan FALSE jika dukungan taskbar Windows 7 dinonaktifkan atau anak MDI tidak terdaftar di tab taskbar Windows 7; jika tidak, mengembalikan TRUE.

Keterangan

Harus dipanggil ketika konten langsung atau ukuran anak MDI telah berubah.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Dipanggil oleh kerangka kerja saat perlu memilih sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.

virtual CRect GetTaskbarThumbnailClipRect() const;

Tampilkan Nilai

Persegi panjang di koordinat jendela. Persegi panjang ini dipetakan ke area klien dari bingkai tingkat atas. Persegi panjang harus kosong untuk menghapus persegi panjang kliping.

Keterangan

CMDIChildWndEx::GetTaskbarPreviewWnd

Dipanggil oleh kerangka kerja ketika perlu mendapatkan jendela anak (biasanya tampilan atau jendela pemisah) untuk ditampilkan pada gambar mini tab taskbar Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Tampilkan Nilai

Harus mengembalikan penunjuk yang CWnd valid ke objek, yang pratinjaunya harus ditampilkan pada tab taskbar Windows 7 yang terkait dengan anak MDI ini. Implementasi default mengembalikan jendela anak dari anak MDI ini dengan ID kontrol AFX_IDW_PANE_FIRST (yang biasanya merupakan CViewkelas -turunan).

Keterangan

CMDIChildWndEx::GetTabProxyWnd

Mengembalikan jendela proksi tab yang terdaftar dengan tab taskbar Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Tampilkan Nilai

Penunjuk ke CMDITabProxyWnd objek, yang terdaftar dengan tab taskbar Windows 7.

Keterangan

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Mengaktifkan atau menonaktifkan pilihan otomatis sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parameter

bEnable
Menentukan apakah akan mengaktifkan (TRUE), atau menonaktifkan (FALSE) pilihan otomatis dari sebagian area klien jendela yang akan ditampilkan.

Keterangan

CMDIChildWndEx::CanShowOnTaskBarTabs

Memberi tahu kerangka kerja apakah anak MDI ini dapat ditampilkan pada tab taskbar Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Tampilkan Nilai

TRUE jika konten anak MDI dapat ditampilkan pada gambar mini taskbar Windows 7.

Keterangan

Ambil alih metode ini di kelas turunan dan kembaliKAN FALSE untuk menonaktifkan tampilan anak MDI ini pada tab taskbar Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

Dipanggil oleh kerangka kerja untuk mengaktifkan bingkai tingkat atas saat aplikasi diaktifkan dari tab taskbar.

virtual void ActivateTopLevelFrame();

Keterangan

Lihat juga

Bagan Hierarki
Kelas
Kelas CMDIChildWnd
Kelas CMFCWindowsManagerDialog
Kelas CMDIFrameWndEx

Bagikan melalui

Kelas CMDIChildWndEx

Sintaks

Anggota

Metode Publik

Keterangan

Contoh

Hierarki Warisan

Persyaratan

CMDIChildWndEx::AddPane

Parameter

Tampilkan Nilai

CMDIChildWndEx::AddTabbedPane

Parameter

CMDIChildWndEx::AdjustDockingLayout

Parameter

CMDIChildWndEx::CanShowOnMDITabs

Tampilkan Nilai

Keterangan

CMDIChildWndEx::CanShowOnWindowsList

Tampilkan Nilai

Keterangan

CMDIChildWndEx::D ockPane

Parameter

Keterangan

CMDIChildWndEx::D ockPaneLeftOf

Parameter

Tampilkan Nilai

Keterangan

CMDIChildWndEx::EnableAutoHidePanes

Parameter

Tampilkan Nilai

CMDIChildWndEx::EnableDocking

Parameter

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetDockingManager

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetDocumentName

Tampilkan Nilai

Keterangan

Contoh

CMDIChildWndEx::GetFrameIcon

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetFrameText

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetPane

Parameter

Tampilkan Nilai

CMDIChildWndEx::GetRelatedTabGroup

Tampilkan Nilai

Keterangan

CMDIChildWndEx::GetTabbedPane

Tampilkan Nilai

CMDIChildWndEx::GetToolbarButtonToolTipText

Tampilkan Nilai

Keterangan

CMDIChildWndEx::InsertPane

Parameter

Tampilkan Nilai

CMDIChildWndEx::IsPointNearDockSite

Parameter

Tampilkan Nilai

Keterangan

CMDIChildWndEx::IsReadOnly

Tampilkan Nilai

Keterangan

Contoh

CMDIChildWndEx::IsTabbedPane

Tampilkan Nilai

CMDIChildWndEx::OnMoveMiniFrame

Parameter

Tampilkan Nilai

CMDIChildWndEx::OnSetPreviewMode

Parameter

CMDIChildWndEx::OnUpdateFrameTitle

Parameter