Kelas CMDIChildWndEx
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
Titik
[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
Titik
[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
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::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
Baca juga
Bagan Hierarki
Kelas
Kelas CMDIChildWnd
Kelas CMFCWindowsManagerDialog
Kelas CMDIFrameWndEx
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk