CFrameWnd
Kelas
Menyediakan fungsionalitas antarmuka dokumen tunggal (SDI) Windows yang tumpang tindih atau jendela bingkai pop-up, bersama dengan anggota untuk mengelola jendela.
Sintaks
class CFrameWnd : public CWnd
Anggota
Konstruktor Publik
Nama | Deskripsi |
---|---|
CFrameWnd::CFrameWnd |
Membuat CFrameWnd objek. |
Metode Publik
Nama | Deskripsi |
---|---|
CFrameWnd::ActivateFrame |
Membuat bingkai terlihat dan tersedia untuk pengguna. |
CFrameWnd::BeginModalState |
Mengatur jendela bingkai ke modal. |
CFrameWnd::Create |
Panggil untuk membuat dan menginisialisasi jendela bingkai Windows yang CFrameWnd terkait dengan objek. |
CFrameWnd::CreateView |
Membuat tampilan dalam bingkai yang tidak berasal dari CView . |
CFrameWnd::DockControlBar |
Menambungkan bilah kontrol. |
CFrameWnd::EnableDocking |
Memungkinkan bilah kontrol ditampung. |
CFrameWnd::EndModalState |
Mengakhiri status modal jendela bingkai. Mengaktifkan semua jendela yang dinonaktifkan oleh BeginModalState . |
CFrameWnd::FloatControlBar |
Mengapungkan bar kontrol. |
CFrameWnd::GetActiveDocument |
Mengembalikan objek aktif CDocument . |
CFrameWnd::GetActiveFrame |
Mengembalikan objek aktif CFrameWnd . |
CFrameWnd::GetActiveView |
Mengembalikan objek aktif CView . |
CFrameWnd::GetControlBar |
Mengambil bilah kontrol. |
CFrameWnd::GetDockState |
Mengambil status dok jendela bingkai. |
CFrameWnd::GetMenuBarState |
Mengambil status tampilan menu di aplikasi MFC saat ini. |
CFrameWnd::GetMenuBarVisibility |
Menunjukkan apakah perilaku default menu di aplikasi MFC saat ini tersembunyi atau terlihat. |
CFrameWnd::GetMessageBar |
Mengembalikan penunjuk ke bilah status milik jendela bingkai. |
CFrameWnd::GetMessageString |
Mengambil pesan yang sesuai dengan ID perintah. |
CFrameWnd::GetTitle |
Mengambil judul bilah kontrol terkait. |
CFrameWnd::InitialUpdateFrame |
OnInitialUpdate Menyebabkan fungsi anggota milik semua tampilan di jendela bingkai dipanggil. |
CFrameWnd::InModalState |
Mengembalikan nilai yang menunjukkan apakah jendela bingkai dalam keadaan modal atau tidak. |
CFrameWnd::IsTracking |
Menentukan apakah bilah pemisah saat ini sedang dipindahkan. |
CFrameWnd::LoadAccelTable |
Panggil untuk memuat tabel akselerator. |
CFrameWnd::LoadBarState |
Panggil untuk memulihkan pengaturan bilah kontrol. |
CFrameWnd::LoadFrame |
Panggil untuk membuat jendela bingkai secara dinamis dari informasi sumber daya. |
CFrameWnd::NegotiateBorderSpace |
Menegosiasikan ruang batas di jendela bingkai. |
CFrameWnd::OnBarCheck |
Dipanggil setiap kali tindakan dilakukan pada bilah kontrol yang ditentukan. |
CFrameWnd::OnContextHelp |
Menangani Bantuan SHIFT+F1 untuk item di tempat. |
CFrameWnd::OnSetPreviewMode |
Mengatur jendela bingkai utama aplikasi ke dalam dan kehabisan mode pratinjau cetak. |
CFrameWnd::OnUpdateControlBarMenu |
Dipanggil oleh kerangka kerja saat menu terkait diperbarui. |
CFrameWnd::RecalcLayout |
Memposisikan ulang bilah CFrameWnd kontrol objek. |
CFrameWnd::SaveBarState |
Panggil untuk menyimpan pengaturan bilah kontrol. |
CFrameWnd::SetActivePreviewView |
Menunjuk tampilan yang ditentukan untuk menjadi tampilan aktif untuk Pratinjau Kaya. |
CFrameWnd::SetActiveView |
Mengatur objek aktif CView . |
CFrameWnd::SetDockState |
Panggil untuk menambatkan jendela bingkai di jendela utama. |
CFrameWnd::SetMenuBarState |
Mengatur status tampilan menu di aplikasi MFC saat ini ke tersembunyi atau ditampilkan. |
CFrameWnd::SetMenuBarVisibility |
Mengatur perilaku default menu di aplikasi MFC saat ini menjadi tersembunyi atau terlihat. |
CFrameWnd::SetMessageText |
Mengatur teks bilah status standar. |
CFrameWnd::SetProgressBarPosition |
Mengatur posisi saat ini untuk bilah kemajuan Windows 7 yang ditampilkan pada bilah tugas. |
CFrameWnd::SetProgressBarRange |
Mengatur rentang untuk bilah kemajuan Windows 7 yang ditampilkan pada taskbar. |
CFrameWnd::SetProgressBarState |
Mengatur tipe dan status indikator kemajuan yang ditampilkan pada tombol bilah tugas. |
CFrameWnd::SetTaskbarOverlayIcon |
Kelebihan beban. Menerapkan overlay ke tombol taskbar untuk menunjukkan status aplikasi atau pemberitahuan kepada pengguna. |
CFrameWnd::SetTitle |
Mengatur judul bilah kontrol terkait. |
CFrameWnd::ShowControlBar |
Panggil untuk menampilkan bilah kontrol. |
CFrameWnd::ShowOwnedWindows |
Menampilkan semua jendela yang merupakan turunan objek CFrameWnd . |
Metode yang Dilindungi
Nama | Deskripsi |
---|---|
CFrameWnd::OnCreateClient |
Membuat jendela klien untuk bingkai. |
CFrameWnd::OnHideMenuBar |
Dipanggil sebelum menu di aplikasi MFC saat ini disembunyikan. |
CFrameWnd::OnShowMenuBar |
Dipanggil sebelum menu di aplikasi MFC saat ini ditampilkan. |
Anggota Data Publik
Nama | Deskripsi |
---|---|
CFrameWnd::m_bAutoMenuEnable |
Mengontrol fungsionalitas aktifkan dan nonaktifkan otomatis untuk item menu. |
CFrameWnd::rectDefault |
Teruskan statis CRect ini sebagai parameter saat membuat CFrameWnd objek untuk memungkinkan Windows memilih ukuran dan posisi awal jendela. |
Keterangan
Untuk membuat jendela bingkai yang berguna untuk aplikasi Anda, dapatkan kelas dari CFrameWnd
. Tambahkan variabel anggota ke kelas turunan untuk menyimpan data khusus untuk aplikasi Anda. Terapkan fungsi anggota penangan pesan dan peta pesan di kelas turunan untuk menentukan apa yang terjadi ketika pesan diarahkan ke jendela.
Ada tiga cara untuk membuat jendela bingkai:
Langsung membangunnya menggunakan
Create
.Langsung membangunnya menggunakan
LoadFrame
.Secara tidak langsung membangunnya menggunakan templat dokumen.
Sebelum memanggil atau Create
LoadFrame
, Anda harus membuat objek jendela bingkai pada tumpukan menggunakan operator C++ new
. Sebelum memanggil Create
, Anda juga dapat mendaftarkan kelas jendela dengan AfxRegisterWndClass
fungsi global untuk mengatur ikon dan gaya kelas untuk bingkai.
Create
Gunakan fungsi anggota untuk meneruskan parameter pembuatan bingkai sebagai argumen langsung.
LoadFrame
membutuhkan lebih sedikit argumen daripada Create
, dan sebaliknya mengambil sebagian besar nilai defaultnya dari sumber daya, termasuk keterangan bingkai, ikon, tabel akselerator, dan menu. Agar dapat diakses oleh LoadFrame
, semua sumber daya ini harus memiliki ID sumber daya yang sama (misalnya, IDR_MAINFRAME
).
Saat objek CFrameWnd
berisi tampilan dan dokumen, objek dibuat secara tidak langsung oleh kerangka kerja alih-alih langsung oleh programmer. Objek CDocTemplate
mengatur pembuatan bingkai, pembuatan tampilan yang berisi, dan koneksi tampilan ke dokumen yang sesuai. Parameter CDocTemplate
konstruktor menentukan CRuntimeClass
dari tiga kelas yang terlibat (dokumen, bingkai, dan tampilan). Objek CRuntimeClass
digunakan oleh kerangka kerja untuk membuat bingkai baru secara dinamis ketika ditentukan oleh pengguna (misalnya, dengan menggunakan perintah File Baru atau beberapa antarmuka dokumen (MDI) perintah Window New).
Kelas jendela bingkai yang berasal harus CFrameWnd
dideklarasikan agar DECLARE_DYNCREATE
mekanisme di atas RUNTIME_CLASS
berfungsi dengan benar.
CFrameWnd
berisi implementasi default untuk melakukan fungsi berikut dari jendela utama dalam aplikasi umum untuk Windows:
Jendela
CFrameWnd
bingkai melacak tampilan aktif saat ini yang independen dari jendela aktif Windows atau fokus input saat ini. Ketika bingkai diaktifkan kembali, tampilan aktif akan diberi tahu dengan memanggilCView::OnActivateView
.Pesan perintah dan banyak pesan pemberitahuan bingkai umum, termasuk yang ditangani
OnSetFocus
oleh fungsiCWnd
,OnHScroll
, danOnVScroll
, didelegasikan olehCFrameWnd
jendela bingkai ke tampilan yang saat ini aktif.Tampilan aktif saat ini (atau jendela bingkai anak MDI yang saat ini aktif dalam kasus bingkai MDI) dapat menentukan keterangan jendela bingkai. Fitur ini dapat dinonaktifkan dengan mematikan
FWS_ADDTOTITLE
bit gaya jendela bingkai.Jendela
CFrameWnd
bingkai mengelola posisi bilah kontrol, tampilan, dan jendela anak lainnya di dalam area klien jendela bingkai. Jendela bingkai juga melakukan pembaruan toolbar diam-waktu dan tombol bilah kontrol lainnya. JendelaCFrameWnd
bingkai juga memiliki implementasi perintah default untuk mengaktifkan dan menonaktifkan bilah alat dan status.Jendela
CFrameWnd
bingkai mengelola bilah menu utama. Saat menu pop-up ditampilkan, jendela bingkai menggunakanUPDATE_COMMAND_UI
mekanisme untuk menentukan item menu mana yang harus diaktifkan, dinonaktifkan, atau dicentang. Saat pengguna memilih item menu, jendela bingkai memperbarui bilah status dengan string pesan untuk perintah tersebut.CFrameWnd
Jendela bingkai memiliki tabel akselerator opsional yang secara otomatis menerjemahkan akselerator keyboard.Jendela
CFrameWnd
bingkai memiliki ID bantuan opsional yang diatur denganLoadFrame
yang digunakan untuk bantuan sensitif konteks. Jendela bingkai adalah orkestrator utama status semimodal seperti bantuan peka konteks (SHIFT+F1) dan mode pratinjau cetak.Jendela
CFrameWnd
bingkai akan membuka file yang diseret dari Manajer File dan dihilangkan pada jendela bingkai. Jika ekstensi file terdaftar dan terkait dengan aplikasi, jendela bingkai merespons permintaan terbuka pertukaran data dinamis (DDE) yang terjadi ketika pengguna membuka file data di File Manager atau ketikaShellExecute
fungsi Windows dipanggil.Jika jendela bingkai adalah jendela aplikasi utama (yaitu,
CWinThread::m_pMainWnd
), ketika pengguna menutup aplikasi, jendela bingkai meminta pengguna untuk menyimpan dokumen yang dimodifikasi (untukOnClose
danOnQueryEndSession
).Jika jendela bingkai adalah jendela aplikasi utama, jendela bingkai adalah konteks untuk menjalankan WinHelp. Menutup jendela bingkai akan dimatikan
WINHELP.EXE
jika diluncurkan untuk bantuan untuk aplikasi ini.
Jangan gunakan operator C++ delete
untuk menghancurkan jendela bingkai. Gunakan CWnd::DestroyWindow
sebagai gantinya. Implementasi CFrameWnd
PostNcDestroy
akan menghapus objek C++ saat jendela dihancurkan. Ketika pengguna menutup jendela bingkai, handler default OnClose
akan memanggil DestroyWindow
.
Untuk informasi selengkapnya tentang CFrameWnd
, lihat Bingkai Windows.
Hierarki Warisan
CFrameWnd
Persyaratan
Header: afxwin.h
CFrameWnd::ActivateFrame
Panggil fungsi anggota ini untuk mengaktifkan dan memulihkan jendela bingkai sehingga terlihat dan tersedia untuk pengguna.
virtual void ActivateFrame(int nCmdShow = -1);
Parameter
nCmdShow
Menentukan parameter yang akan diteruskan ke CWnd::ShowWindow
. Secara default, bingkai ditampilkan dan dipulihkan dengan benar.
Keterangan
Fungsi anggota ini biasanya dipanggil setelah peristiwa antarmuka non-pengguna seperti DDE, OLE, atau peristiwa lain yang mungkin menampilkan jendela bingkai atau kontennya kepada pengguna.
Implementasi default mengaktifkan bingkai dan membawanya ke bagian atas urutan Z dan, jika perlu, melakukan langkah-langkah yang sama untuk jendela bingkai utama aplikasi.
Ambil alih fungsi anggota ini untuk mengubah cara bingkai diaktifkan. Misalnya, Anda dapat memaksa jendela anak MDI untuk dimaksimalkan. Tambahkan fungsionalitas yang sesuai, lalu panggil versi kelas dasar dengan eksplisit nCmdShow
.
Contoh
void CChildFrame::ActivateFrame(int nCmdShow)
{
// Create the child frame window maximized
nCmdShow = SW_MAXIMIZE;
CMDIChildWnd::ActivateFrame(nCmdShow);
}
CFrameWnd::BeginModalState
Panggil fungsi anggota ini untuk melakukan modal jendela bingkai.
virtual void BeginModalState();
CFrameWnd::CFrameWnd
Membuat CFrameWnd
objek, tetapi tidak membuat jendela bingkai yang terlihat.
CFrameWnd();
Keterangan
Panggil Create
untuk membuat jendela yang terlihat.
CFrameWnd::Create
Panggil untuk membuat dan menginisialisasi jendela bingkai Windows yang CFrameWnd
terkait dengan objek.
virtual BOOL Create(
LPCTSTR lpszClassName,
LPCTSTR lpszWindowName,
DWORD dwStyle = WS_OVERLAPPEDWINDOW,
const RECT& rect = rectDefault,
CWnd* pParentWnd = NULL,
LPCTSTR lpszMenuName = NULL,
DWORD dwExStyle = 0,
CCreateContext* pContext = NULL);
Parameter
lpszClassName
Menunjuk ke string karakter null-terminated yang memberi nama kelas Windows. Nama kelas dapat berupa nama apa pun yang terdaftar dengan AfxRegisterWndClass
fungsi global atau RegisterClass
fungsi Windows. Jika NULL
, menggunakan atribut default CFrameWnd
yang telah ditentukan sebelumnya.
lpszWindowName
Menunjuk ke string karakter null-terminated yang mewakili nama jendela. Digunakan sebagai teks untuk bilah judul.
dwStyle
Menentukan atribut gaya jendela. Sertakan FWS_ADDTOTITLE
gaya jika Anda ingin bilah judul secara otomatis menampilkan nama dokumen yang diwakili di jendela.
rect
Menentukan ukuran dan posisi jendela. Nilai memungkinkan rectDefault
Windows menentukan ukuran dan posisi jendela baru.
pParentWnd
Menentukan jendela induk dari jendela bingkai ini. Parameter ini harus NULL
untuk jendela bingkai tingkat atas.
lpszMenuName
Mengidentifikasi nama sumber daya menu yang akan digunakan dengan jendela. Gunakan MAKEINTRESOURCE
jika menu memiliki ID bilangan bulat, bukan string. Parameter ini dapat berupa NULL
.
dwExStyle
Menentukan atribut gaya yang diperluas jendela.
pContext
Menentukan penunjuk ke CCreateContext
struktur. Parameter ini dapat berupa NULL
.
Tampilkan Nilai
Bukan nol jika inisialisasi berhasil; jika tidak, 0.
Keterangan
Buat CFrameWnd
objek dalam dua langkah. Pertama, panggil konstruktor, yang membangun CFrameWnd
objek, lalu panggil Create
, yang membuat jendela bingkai Windows dan melampirkannya ke CFrameWnd
objek. Create
menginisialisasi nama kelas dan nama jendela jendela dan mendaftarkan nilai default untuk menu gaya, induk, dan terkait.
Gunakan LoadFrame
daripada Create
memuat jendela bingkai dari sumber daya alih-alih menentukan argumennya.
CFrameWnd::CreateView
Panggil CreateView
untuk membuat tampilan dalam bingkai.
CWnd* CreateView(
CCreateContext* pContext,
UINT nID = AFX_IDW_PANE_FIRST);
Parameter
pContext
Menentukan tipe tampilan dan dokumen.
nID
Nomor ID tampilan.
Tampilkan Nilai
Penunjuk CWnd
ke objek jika berhasil; jika tidak NULL
.
Keterangan
Gunakan fungsi anggota ini untuk membuat "tampilan" yang tidak CView
diturunkan dalam bingkai. Setelah memanggil CreateView
, Anda harus mengatur tampilan secara manual ke aktif dan mengaturnya agar terlihat; tugas-tugas ini tidak secara otomatis dilakukan oleh CreateView
.
CFrameWnd::DockControlBar
Menyebabkan bilah kontrol ditambatkan ke jendela bingkai.
void DockControlBar(
CControlBar* pBar,
UINT nDockBarID = 0,
LPCRECT lpRect = NULL);
Parameter
pBar
Menunjuk ke bilah kontrol yang akan ditampar.
nDockBarID
Menentukan sisi jendela bingkai mana yang perlu dipertimbangkan untuk docking. Bisa 0, atau satu atau beberapa hal berikut:
AFX_IDW_DOCKBAR_TOP
Dock ke sisi atas jendela bingkai.AFX_IDW_DOCKBAR_BOTTOM
Dock ke sisi bawah jendela bingkai.AFX_IDW_DOCKBAR_LEFT
Dok ke sisi kiri jendela bingkai.AFX_IDW_DOCKBAR_RIGHT
Dok ke sisi kanan jendela bingkai.
Jika 0, bilah kontrol dapat ditambatkan ke sisi mana pun yang diaktifkan untuk docking di jendela bingkai tujuan.
lpRect
Menentukan, dalam koordinat layar, di mana bilah kontrol akan ditambatkan di area nonkelola jendela bingkai tujuan.
Keterangan
Bilah kontrol akan ditambatkan ke salah satu sisi jendela bingkai yang ditentukan dalam panggilan ke dan CControlBar::EnableDocking
CFrameWnd::EnableDocking
. Sisi yang dipilih ditentukan oleh nDockBarID
.
CFrameWnd::EnableDocking
Panggil fungsi ini untuk mengaktifkan bilah kontrol yang dapat di-dok di jendela bingkai.
void EnableDocking(DWORD dwDockStyle);
Parameter
dwDockStyle
Menentukan sisi mana dari jendela bingkai yang dapat berfungsi sebagai situs docking untuk bilah kontrol. Ini bisa berupa satu atau beberapa hal berikut:
CBRS_ALIGN_TOP
Memungkinkan docking di bagian atas area klien.CBRS_ALIGN_BOTTOM
Memungkinkan docking di bagian bawah area klien.CBRS_ALIGN_LEFT
Memungkinkan docking di sisi kiri area klien.CBRS_ALIGN_RIGHT
Memungkinkan docking di sisi kanan area klien.CBRS_ALIGN_ANY
Memungkinkan docking di sisi mana pun dari area klien.
Keterangan
Secara default, bilah kontrol akan ditambatkan ke sisi jendela bingkai dalam urutan berikut: atas, bawah, kiri, kanan.
Contoh
Lihat contoh untuk CToolBar::Create
.
CFrameWnd::EndModalState
Panggil fungsi anggota ini untuk mengubah jendela bingkai dari modal ke modeless.
virtual void EndModalState();
Keterangan
EndModalState
mengaktifkan semua jendela yang dinonaktifkan oleh BeginModalState
.
CFrameWnd::FloatControlBar
Panggil fungsi ini untuk menyebabkan bilah kontrol tidak ditambatkan ke jendela bingkai.
void FloatControlBar(
CControlBar* pBar,
CPoint point,
DWORD dwStyle = CBRS_ALIGN_TOP);
Parameter
pBar
Menunjuk ke bilah kontrol yang akan diambang.
point
Lokasi, dalam koordinat layar, tempat sudut kiri atas bilah kontrol akan ditempatkan.
dwStyle
Menentukan apakah akan meratakan bilah kontrol secara horizontal atau vertikal dalam jendela bingkai barunya. Ini bisa salah satu dari yang berikut:
CBRS_ALIGN_TOP
Mengorientasi bilah kontrol secara vertikal.CBRS_ALIGN_BOTTOM
Mengorientasi bilah kontrol secara vertikal.CBRS_ALIGN_LEFT
Mengorientasi bilah kontrol secara horizontal.CBRS_ALIGN_RIGHT
Mengorientasi bilah kontrol secara horizontal.
Jika gaya diteruskan menentukan orientasi horizontal dan vertikal, toolbar akan berorientasi horizontal.
Keterangan
Biasanya, ini dilakukan pada startup aplikasi ketika program memulihkan pengaturan dari eksekusi sebelumnya.
Fungsi ini dipanggil oleh kerangka kerja ketika pengguna menyebabkan operasi penurunan dengan melepaskan tombol mouse kiri sambil menyeret bilah kontrol di atas lokasi yang tidak tersedia untuk docking.
CFrameWnd::GetActiveDocument
Panggil fungsi anggota ini untuk mendapatkan penunjuk ke yang saat ini CDocument
dilampirkan ke tampilan aktif saat ini.
virtual CDocument* GetActiveDocument();
Tampilkan Nilai
Penunjuk ke .CDocument
Jika tidak ada dokumen saat ini, mengembalikan NULL
.
CFrameWnd::GetActiveFrame
Panggil fungsi anggota ini untuk mendapatkan penunjuk ke jendela anak antarmuka beberapa dokumen (MDI) aktif dari jendela bingkai MDI.
virtual CFrameWnd* GetActiveFrame();
Tampilkan Nilai
Penunjuk ke jendela anak MDI aktif. Jika aplikasi adalah aplikasi SDI, atau jendela bingkai MDI tidak memiliki dokumen aktif, penunjuk implisit this
akan dikembalikan.
Keterangan
Jika tidak ada anak MDI aktif atau aplikasi adalah antarmuka dokumen tunggal (SDI), penunjuk implisit this
dikembalikan.
CFrameWnd::GetActiveView
Panggil fungsi anggota ini untuk mendapatkan penunjuk ke tampilan aktif (jika ada) yang dilampirkan ke jendela bingkai ( CFrameWnd
).
CView* GetActiveView() const;
Tampilkan Nilai
Penunjuk ke .CView
Jika tidak ada tampilan saat ini, mengembalikan NULL
.
Keterangan
Fungsi ini mengembalikan NULL
ketika dipanggil untuk jendela bingkai utama MDI ( CMDIFrameWnd
). Dalam aplikasi MDI, jendela bingkai utama MDI tidak memiliki tampilan yang terkait dengannya. Sebagai gantinya, setiap jendela anak individu ( CMDIChildWnd
) memiliki satu atau beberapa tampilan terkait. Tampilan aktif dalam aplikasi MDI dapat diperoleh dengan terlebih dahulu menemukan jendela anak MDI aktif lalu menemukan tampilan aktif untuk jendela anak tersebut. Jendela anak MDI aktif dapat ditemukan dengan memanggil fungsi MDIGetActive
atau GetActiveFrame
seperti yang ditunjukkan dalam hal berikut:
CMDIFrameWnd *pFrame = (CMDIFrameWnd*)AfxGetApp()->GetMainWnd();
// Get the active MDI child window.
CMDIChildWnd *pChild = (CMDIChildWnd*)pFrame->GetActiveFrame();
// or CMDIChildWnd *pChild = pFrame->MDIGetActive();
// Get the active view attached to the active MDI child window.
CMyView *pView = (CMyView*)pChild->GetActiveView();
CFrameWnd::GetControlBar
Panggil GetControlBar
untuk mendapatkan akses ke bilah kontrol yang terkait dengan ID.
CControlBar* GetControlBar(UINT nID);
Parameter
nID
Nomor ID dari bilah kontrol.
Tampilkan Nilai
Penunjuk ke bilah kontrol yang terkait dengan ID.
Keterangan
Parameter nID
mengacu pada pengidentifikasi unik yang diteruskan ke Create
metode bilah kontrol. Untuk informasi selengkapnya tentang bilah kontrol, lihat topik berjudul Bilah Kontrol.
GetControlBar
akan mengembalikan bilah kontrol meskipun mengambang dan dengan demikian bukan jendela anak dari bingkai.
CFrameWnd::GetDockState
Panggil fungsi anggota ini untuk menyimpan informasi status tentang bilah kontrol jendela bingkai dalam objek CDockState
.
void GetDockState(CDockState& state) const;
Parameter
state
Berisi status bilah kontrol jendela bingkai saat ini saat kembali.
Keterangan
Anda kemudian dapat menulis konten CDockState
ke penyimpanan menggunakan CDockState::SaveState
atau Serialize
. Jika nanti Anda ingin memulihkan bilah kontrol ke status sebelumnya, muat status dengan CDockState::LoadState
atau Serialize
, lalu panggil SetDockState
untuk menerapkan status sebelumnya ke bilah kontrol jendela bingkai.
CFrameWnd::GetMenuBarState
Mengambil status tampilan menu di aplikasi MFC saat ini.
virtual DWORD GetMenuBarState();
Tampilkan Nilai
Nilai yang dikembalikan dapat memiliki nilai berikut:
AFX_MBS_VISIBLE
(0x01) - Menu terlihat.AFX_MBS_HIDDEN
(0x02) - Menu tersembunyi.
Keterangan
Jika terjadi kesalahan runtime, metode ini menegaskan dalam mode Debug dan menimbulkan pengecualian yang berasal dari CException
kelas .
CFrameWnd::GetMenuBarVisibility
Menunjukkan apakah status default menu di aplikasi MFC saat ini tersembunyi atau terlihat.
virtual DWORD CFrameWnd::GetMenuBarVisibility();
Tampilkan Nilai
Metode ini mengembalikan salah satu nilai berikut:
AFX_MBV_KEEPVISIBLE
(0x01) - Menu ditampilkan setiap saat, dan secara default tidak memiliki fokus.AFX_MBV_DISPLAYONFOCUS
(0x02) - Menu disembunyikan secara default. Jika menu disembunyikan, tekan tombol ALT untuk menampilkan menu dan memfokuskannya. Jika menu ditampilkan, tekan tombol ALT atau ESC untuk menyembunyikannya.AFX_MBV_ DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10
(0x06) - Menu disembunyikan secara default. Jika menu disembunyikan, tekan tombol F10 untuk menampilkan menu dan memfokuskannya. Jika menu ditampilkan, tekan tombol F10 untuk mengalihkan fokus pada atau menonaktifkan menu. Menu ditampilkan hingga Anda menekan tombol ALT atau ESC untuk menyembunyikannya.
Keterangan
Jika terjadi kesalahan runtime, metode ini menegaskan dalam mode Debug dan menimbulkan pengecualian yang berasal dari CException
kelas .
CFrameWnd::GetMessageBar
Panggil fungsi anggota ini untuk mendapatkan penunjuk ke bilah status.
virtual CWnd* GetMessageBar();
Tampilkan Nilai
Penunjuk ke jendela bilah status.
CFrameWnd::GetMessageString
Ambil alih fungsi ini untuk menyediakan string kustom untuk ID perintah.
virtual void GetMessageString(
UINT nID,
CString& rMessage) const;
Parameter
nID
ID sumber daya dari pesan yang diinginkan.
rMessage
CString
objek tempat menempatkan pesan.
Keterangan
Implementasi default hanya memuat string yang ditentukan oleh nID
dari file sumber daya. Fungsi ini dipanggil oleh kerangka kerja ketika string pesan di bilah status perlu diperbarui.
CFrameWnd::GetTitle
Mengambil judul objek jendela.
CString GetTitle() const;
Tampilkan Nilai
Objek CString
yang berisi judul objek jendela saat ini.
CFrameWnd::InitialUpdateFrame
Panggil IntitialUpdateFrame
setelah membuat bingkai baru dengan Create
.
void InitialUpdateFrame(
CDocument* pDoc,
BOOL bMakeVisible);
Parameter
pDoc
Arahkan ke dokumen tempat jendela bingkai dikaitkan. Bisa jadi NULL
.
bMakeVisible
Jika TRUE
, menunjukkan bahwa bingkai harus terlihat dan aktif. Jika FALSE
, tidak ada turunan yang dibuat terlihat.
Keterangan
Ini menyebabkan semua tampilan di jendela bingkai tersebut menerima panggilan mereka OnInitialUpdate
.
Selain itu, jika sebelumnya tidak ada tampilan aktif, tampilan utama jendela bingkai dibuat aktif. Tampilan utama adalah tampilan dengan ID anak .AFX_IDW_PANE_FIRST
Akhirnya, jendela bingkai dibuat terlihat jika bMakeVisible
bukan nol. Jika bMakeVisible
adalah 0, fokus saat ini dan status jendela bingkai yang terlihat akan tetap tidak berubah. Tidak perlu memanggil fungsi ini saat menggunakan implementasi kerangka kerja File Baru dan Buka File.
CFrameWnd::InModalState
Panggil fungsi anggota ini untuk memeriksa apakah jendela bingkai modal atau tidak mode.
BOOL InModalState() const;
Tampilkan Nilai
Bukan nol jika ya; jika tidak, 0.
CFrameWnd::IsTracking
Panggil fungsi anggota ini untuk menentukan apakah bilah pemisah di jendela saat ini sedang dipindahkan.
BOOL IsTracking() const;
Tampilkan Nilai
Bukan nol jika operasi pemisah sedang berlangsung; jika tidak, 0.
CFrameWnd::LoadAccelTable
Panggil untuk memuat tabel akselerator yang ditentukan.
BOOL LoadAccelTable(LPCTSTR lpszResourceName);
Parameter
lpszResourceName
Mengidentifikasi nama sumber daya akselerator. Gunakan MAKEINTRESOURCE
jika sumber daya diidentifikasi dengan ID bilangan bulat.
Tampilkan Nilai
Bukan nol jika tabel akselerator berhasil dimuat; jika tidak, 0.
Keterangan
Hanya satu tabel yang dapat dimuat pada satu waktu.
Tabel akselerator yang dimuat dari sumber daya dibebaskan secara otomatis ketika aplikasi berakhir.
Jika Anda memanggil LoadFrame
untuk membuat jendela bingkai, kerangka kerja memuat tabel akselerator bersama dengan menu dan sumber daya ikon, dan panggilan berikutnya ke fungsi anggota ini kemudian tidak perlu.
CFrameWnd::LoadBarState
Panggil fungsi ini untuk memulihkan pengaturan setiap bilah kontrol yang dimiliki oleh jendela bingkai.
void LoadBarState(LPCTSTR lpszProfileName);
Parameter
lpszProfileName
Nama bagian dalam file inisialisasi (INI) atau kunci di registri Windows tempat informasi status disimpan.
Keterangan
Informasi yang dipulihkan mencakup visibilitas, orientasi horizontal/vertikal, status docking, dan posisi bilah kontrol.
Pengaturan yang ingin Anda pulihkan harus ditulis ke registri sebelum Anda memanggil LoadBarState
. Tulis informasi ke registri dengan memanggil CWinApp::SetRegistryKey
. Tulis informasi ke file INI dengan memanggil SaveBarState
.
CFrameWnd::LoadFrame
Panggil untuk membuat jendela bingkai secara dinamis dari informasi sumber daya.
virtual BOOL LoadFrame(
UINT nIDResource,
DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
CWnd* pParentWnd = NULL,
CCreateContext* pContext = NULL);
Parameter
nIDResource
ID sumber daya bersama yang terkait dengan jendela bingkai.
dwDefaultStyle
Gaya bingkai. Sertakan FWS_ADDTOTITLE
gaya jika Anda ingin bilah judul secara otomatis menampilkan nama dokumen yang diwakili di jendela.
pParentWnd
Penunjuk ke induk bingkai.
pContext
Penunjuk ke CCreateContext
struktur. Parameter ini dapat berupa NULL
.
Keterangan
Buat CFrameWnd
objek dalam dua langkah. Pertama, panggil konstruktor, yang membangun CFrameWnd
objek, lalu panggil LoadFrame
, yang memuat jendela bingkai Windows dan sumber daya terkait dan melampirkan jendela bingkai ke CFrameWnd
objek. Parameter nIDResource
menentukan menu, tabel akselerator, ikon, dan sumber daya string judul untuk jendela bingkai.
Create
Gunakan fungsi anggota daripada LoadFrame
saat Anda ingin menentukan semua parameter pembuatan jendela bingkai.
Kerangka kerja memanggil LoadFrame
saat membuat jendela bingkai menggunakan objek templat dokumen.
Kerangka kerja menggunakan pContext
argumen untuk menentukan objek yang akan disambungkan ke jendela bingkai, termasuk objek tampilan yang terkandung. Anda dapat mengatur argumen ke pContext
NULL
saat memanggil LoadFrame
.
CFrameWnd::m_bAutoMenuEnable
Ketika anggota data ini diaktifkan (yang merupakan default), item menu yang tidak memiliki ON_UPDATE_COMMAND_UI
atau ON_COMMAND
handler akan dinonaktifkan secara otomatis saat pengguna menarik menu.
BOOL m_bAutoMenuEnable;
Keterangan
Item menu yang memiliki ON_COMMAND
handler tetapi tidak ada ON_UPDATE_COMMAND_UI
handler yang akan diaktifkan secara otomatis.
Ketika anggota data ini diatur, item menu secara otomatis diaktifkan dengan cara yang sama seperti tombol toolbar diaktifkan.
Catatan
m_bAutoMenuEnable
tidak berpengaruh pada item menu tingkat atas.
Anggota data ini menyederhanakan implementasi perintah opsional berdasarkan pilihan saat ini dan mengurangi kebutuhan untuk menulis ON_UPDATE_COMMAND_UI
handler untuk mengaktifkan dan menonaktifkan item menu.
Contoh
// CMainFrame is application-defined object of type CFrameWnd
CMainFrame::CMainFrame()
: m_hDrawMenu(NULL), m_hDrawAccel(NULL), m_bCheck(false), m_nWindowTimer(0), m_nCallbackTimer(0)
{
// Set to FALSE so no ON_UPDATE_COMMAND_UI
// or ON_COMMAND handlers are needed, and
// CMenu::EnableMenuItem() will work as expected.
m_bAutoMenuEnable = FALSE;
}
CFrameWnd::NegotiateBorderSpace
Panggil fungsi anggota ini untuk menegosiasikan ruang batas di jendela bingkai selama aktivasi inplace OLE.
virtual BOOL NegotiateBorderSpace(
UINT nBorderCmd,
LPRECT lpRectBorder);
Parameter
nBorderCmd
Berisi salah satu nilai berikut dari enum BorderCmd
:
borderGet
= 1borderRequest
= 2borderSet
= 3
lpRectBorder
Penunjuk ke RECT
struktur atau CRect
objek yang menentukan koordinat batas.
Tampilkan Nilai
Bukan nol jika berhasil; jika tidak, 0.
Keterangan
Fungsi anggota ini adalah CFrameWnd
implementasi negosiasi ruang perbatasan OLE.
CFrameWnd::OnBarCheck
Dipanggil setiap kali tindakan dilakukan pada bilah kontrol yang ditentukan.
afx_msg BOOL OnBarCheck(UINT nID);
Parameter
nID
ID bilah kontrol yang ditampilkan.
Tampilkan Nilai
Bukan nol jika bilah kontrol ada; jika tidak, 0.
CFrameWnd::OnContextHelp
Menangani Bantuan SHIFT+F1 untuk item di tempat.
afx_msg void OnContextHelp();
Keterangan
Untuk mengaktifkan bantuan sensitif konteks, Anda harus menambahkan
ON_COMMAND(ID_CONTEXT_HELP, &CMainFrame::OnContextHelp)
pernyataan ke peta pesan kelas Anda CFrameWnd
dan juga tambahkan entri akselerator-tabel, biasanya SHIFT+F1, untuk mengaktifkan fungsi anggota ini.
Jika aplikasi Anda adalah Kontainer OLE, OnContextHelp
letakkan semua item di tempat yang terkandung dalam objek jendela bingkai ke dalam mode Bantuan. Kursor berubah menjadi panah dan tanda tanya, dan pengguna kemudian dapat memindahkan penunjuk mouse dan menekan tombol mouse kiri untuk memilih kotak dialog, jendela, menu, atau tombol perintah. Fungsi anggota ini memanggil fungsi WinHelp
Windows dengan konteks Bantuan objek di bawah kursor.
CFrameWnd::OnCreateClient
Dipanggil oleh kerangka kerja selama eksekusi OnCreate
.
virtual BOOL OnCreateClient(
LPCREATESTRUCT lpcs,
CCreateContext* pContext);
Parameter
lpcs
Penunjuk ke struktur Windows CREATESTRUCT
.
pContext
Penunjuk ke CCreateContext
struktur.
Tampilkan Nilai
Bukan nol jika berhasil; jika tidak, 0.
Keterangan
Jangan pernah memanggil fungsi ini.
Implementasi default fungsi ini membuat CView
objek dari informasi yang disediakan dalam pContext
, jika memungkinkan.
Ambil alih fungsi ini untuk mengambil alih nilai yang diteruskan dalam CCreateContext
objek atau untuk mengubah cara kontrol di area klien utama jendela bingkai dibuat. Anggota CCreateContext
yang dapat Anda ambil alih dijelaskan di CCreateContext
kelas .
Catatan
Jangan ganti nilai yang CREATESTRUCT
diteruskan dalam struktur. Mereka hanya untuk penggunaan informasi. Jika Anda ingin mengambil alih persegi jendela awal, misalnya, ambil alih CWnd
fungsi PreCreateWindow
anggota .
CFrameWnd::OnHideMenuBar
Fungsi ini dipanggil ketika sistem akan menyembunyikan bilah menu di aplikasi MFC saat ini.
virtual void OnHideMenuBar();
Keterangan
Penanganan aktivitas ini memungkinkan aplikasi Anda melakukan tindakan kustom saat sistem akan menyembunyikan menu. Anda tidak dapat mencegah menu disembunyikan, tetapi Anda dapat, misalnya, memanggil metode lain untuk mengambil gaya atau status menu.
CFrameWnd::OnSetPreviewMode
Panggil fungsi anggota ini untuk mengatur jendela bingkai utama aplikasi ke dalam dan kehabisan mode pratinjau cetak.
virtual void OnSetPreviewMode(
BOOL bPreview,
CPrintPreviewState* pState);
Parameter
bPreview
Menentukan apakah akan menempatkan aplikasi dalam mode pratinjau cetak atau tidak. Atur ke TRUE
tempat di pratinjau cetak, FALSE
untuk membatalkan mode pratinjau.
pState
Penunjuk ke CPrintPreviewState
struktur.
Keterangan
Implementasi default menonaktifkan semua toolbar standar dan menyembunyikan menu utama dan jendela klien utama. Ini mengubah jendela bingkai MDI menjadi jendela bingkai SDI sementara.
Ambil alih fungsi anggota ini untuk menyesuaikan persembunyian dan peragaan bilah kontrol dan bagian jendela bingkai lainnya selama pratinjau cetak. Panggil implementasi kelas dasar dari dalam versi yang ditimpa.
CFrameWnd::OnShowMenuBar
Fungsi ini dipanggil ketika sistem akan menampilkan bilah menu di aplikasi MFC saat ini.
virtual void OnShowMenuBar();
Keterangan
Penanganan aktivitas ini memungkinkan aplikasi Anda melakukan tindakan kustom saat menu akan ditampilkan. Anda tidak dapat mencegah menu ditampilkan, tetapi Anda dapat, misalnya, memanggil metode lain untuk mengambil gaya atau status menu.
CFrameWnd::OnUpdateControlBarMenu
Dipanggil oleh kerangka kerja saat menu terkait diperbarui.
afx_msg void OnUpdateControlBarMenu(CCmdUI* pCmdUI);
Parameter
pCmdUI
Penunjuk ke objek yang CCmdUI
mewakili menu yang menghasilkan perintah pembaruan. Handler pembaruan memanggil Enable
fungsi CCmdUI
anggota objek pCmdUI
untuk memperbarui antarmuka pengguna.
CFrameWnd::RecalcLayout
Dipanggil oleh kerangka kerja ketika bilah kontrol standar diaktifkan atau dimatikan atau saat jendela bingkai diubah ukurannya.
virtual void RecalcLayout(BOOL bNotify = TRUE);
Parameter
bNotify
Menentukan apakah item aktif di tempat untuk jendela bingkai menerima pemberitahuan perubahan tata letak. Jika TRUE
, item diberi tahu; jika tidak FALSE
.
Keterangan
Implementasi default fungsi anggota ini memanggil CWnd
fungsi RepositionBars
anggota untuk memposisikan ulang semua bilah kontrol dalam bingkai serta di jendela klien utama (biasanya a CView
atau MDICLIENT
).
Ambil alih fungsi anggota ini untuk mengontrol tampilan dan perilaku bilah kontrol setelah tata letak jendela bingkai berubah. Misalnya, panggil saat Anda mengaktifkan atau menonaktifkan bilah kontrol atau menambahkan bilah kontrol lain.
CFrameWnd::rectDefault
Teruskan statis CRect
ini sebagai parameter saat membuat jendela untuk memungkinkan Windows memilih ukuran dan posisi awal jendela.
static AFX_DATA const CRect rectDefault;
CFrameWnd::SaveBarState
Panggil fungsi ini untuk menyimpan informasi tentang setiap bilah kontrol yang dimiliki oleh jendela bingkai.
void SaveBarState(LPCTSTR lpszProfileName) const;
Parameter
lpszProfileName
Nama bagian dalam file inisialisasi atau kunci di registri Windows tempat informasi status disimpan.
Keterangan
Informasi ini dapat dibaca dari file inisialisasi menggunakan LoadBarState
. Informasi yang disimpan mencakup visibilitas, orientasi horizontal/vertikal, status docking, dan posisi bilah kontrol.
CFrameWnd::SetActivePreviewView
Menunjuk tampilan yang ditentukan untuk menjadi tampilan aktif untuk Pratinjau Kaya.
void SetActivePreviewView(CView* pViewNew);
Parameter
pViewNew
Penunjuk ke tampilan yang akan diaktifkan.
Keterangan
CFrameWnd::SetActiveView
Panggil fungsi anggota ini untuk mengatur tampilan aktif.
void SetActiveView(
CView* pViewNew,
BOOL bNotify = TRUE);
Parameter
pViewNew
Menentukan penunjuk ke CView
objek, atau NULL
untuk tampilan yang tidak aktif.
bNotify
Menentukan apakah tampilan akan diberi tahu tentang aktivasi. Jika TRUE
, OnActivateView
dipanggil untuk tampilan baru; jika FALSE
, itu tidak.
Keterangan
Kerangka kerja akan memanggil fungsi ini secara otomatis saat pengguna mengubah fokus ke tampilan dalam jendela bingkai. Anda dapat secara eksplisit memanggil SetActiveView
untuk mengubah fokus ke tampilan yang ditentukan.
CFrameWnd::SetDockState
Panggil fungsi anggota ini untuk menerapkan informasi status yang CDockState
disimpan dalam objek ke bilah kontrol jendela bingkai.
void SetDockState(const CDockState& state);
Parameter
state
Terapkan status tersimpan ke bilah kontrol jendela bingkai.
Keterangan
Untuk memulihkan status bilah kontrol sebelumnya, Anda dapat memuat status tersimpan dengan CDockState::LoadState
atau Serialize
, lalu menggunakannya SetDockState
untuk menerapkannya ke bilah kontrol jendela bingkai. Status sebelumnya disimpan dalam CDockState
objek dengan GetDockState
CFrameWnd::SetMenuBarState
Mengatur status tampilan menu di aplikasi MFC saat ini ke tersembunyi atau ditampilkan.
virtual BOOL SetMenuBarState(DWORD nState);
Parameter
nState
[di] Menentukan apakah akan menampilkan atau menyembunyikan menu. Parameter nState
dapat memiliki nilai berikut:
AFX_MBS_VISIBLE
(0x01) - Menampilkan menu jika disembunyikan, tetapi tidak berpengaruh jika terlihat.AFX_MBS_HIDDEN
(0x02) - Menyembunyikan menu jika terlihat, tetapi tidak berpengaruh jika tersembunyi.
Tampilkan Nilai
TRUE
jika metode ini berhasil mengubah status menu; jika tidak, FALSE
.
Keterangan
Jika terjadi kesalahan runtime, metode ini menegaskan dalam mode Debug dan menimbulkan pengecualian yang berasal dari CException
kelas .
CFrameWnd::SetMenuBarVisibility
Mengatur perilaku default menu di aplikasi MFC saat ini menjadi tersembunyi atau terlihat.
virtual void SetMenuBarVisibility(DWORD nStyle);
Parameter
nStyle
[di] Menentukan apakah menu disembunyikan secara default, atau terlihat dan memiliki fokus. Parameter nStyle
dapat memiliki nilai berikut:
AFX_MBV_KEEPVISIBLE
(0x01) - Menu ditampilkan setiap saat, dan secara default tidak memiliki fokus.AFX_MBV_DISPLAYONFOCUS
(0x02) - Menu disembunyikan secara default. Jika menu disembunyikan, tekan tombol ALT untuk menampilkan menu dan memfokuskannya. Jika menu ditampilkan, tekan tombol ALT atau ESC untuk menyembunyikan menu.AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10
(0x06) - Menu disembunyikan secara default. Jika menu disembunyikan, tekan tombol F10 untuk menampilkan menu dan memfokuskannya. Jika menu ditampilkan, tekan tombol F10 untuk mengalihkan fokus pada atau menonaktifkan menu. Menu ditampilkan hingga Anda menekan tombol ALT atau ESC untuk menyembunyikannya.
Keterangan
Jika nilai nStyle
parameter tidak valid, metode ini menegaskan dalam mode Debug dan dinaikkan dalam mode Rilis CInvalidArgException
. Jika terjadi kesalahan runtime lainnya, metode ini menegaskan dalam mode Debug dan menimbulkan pengecualian yang berasal dari CException
kelas .
Metode ini memengaruhi status menu dalam aplikasi yang ditulis untuk Windows Vista dan yang lebih baru.
CFrameWnd::SetMessageText
Panggil fungsi ini untuk menempatkan string di panel bilah status yang memiliki ID 0.
void SetMessageText(LPCTSTR lpszText);
void SetMessageText(UINT nID);
Parameter
lpszText
Menunjuk ke string yang akan ditempatkan pada bilah status.
nID
ID sumber daya string dari string yang akan ditempatkan pada bilah status.
Keterangan
Ini biasanya panel paling kiri, dan terpanjang, dari bilah status.
CFrameWnd::SetProgressBarPosition
Mengatur posisi saat ini untuk bilah kemajuan Windows 7 yang ditampilkan pada bilah tugas.
void SetProgressBarPosition(int nProgressPos);
Parameter
nProgressPos
Menentukan posisi yang akan diatur. Ini harus dalam rentang yang ditetapkan oleh SetProgressBarRange
.
Keterangan
CFrameWnd::SetProgressBarRange
Mengatur rentang untuk bilah kemajuan Windows 7 yang ditampilkan pada bilah tugas.
void SetProgressBarRange(
int nRangeMin,
int nRangeMax);
Parameter
nRangeMin
Nilai minimal.
nRangeMax
Nilai maksimal.
Keterangan
CFrameWnd::SetProgressBarState
Mengatur tipe dan status indikator kemajuan yang ditampilkan pada tombol bilah tugas.
void SetProgressBarState(TBPFLAG tbpFlags);
Parameter
tbpFlags
Bendera yang mengontrol status tombol kemajuan saat ini. Tentukan hanya salah satu bendera berikut karena semua status saling eksklusif: TBPF_NOPROGRESS
, , TBPF_INDETERMINATE
TBPF_NORMAL
, TBPF_ERROR
, TBPF_PAUSED
.
Keterangan
CFrameWnd::SetTaskbarOverlayIcon
Kelebihan beban. Menerapkan overlay ke tombol taskbar untuk menunjukkan status aplikasi atau untuk memberi tahu pengguna.
BOOL SetTaskbarOverlayIcon(
UINT nIDResource,
LPCTSTR lpcszDescr);
BOOL SetTaskbarOverlayIcon(
HICON hIcon,
LPCTSTR lpcszDescr);
Parameter
nIDResource
Menentukan ID Sumber Daya ikon yang akan digunakan sebagai overlay. Lihat deskripsi untuk hIcon
detailnya.
lpcszDescr
Penunjuk ke string yang menyediakan versi teks alt dari informasi yang disampaikan oleh overlay, untuk tujuan aksesibilitas.
hIcon
Handel ikon yang akan digunakan sebagai overlay. Ini harus menjadi ikon kecil, berukuran 16x16 piksel pada 96 titik per inci (dpi). Jika ikon overlay sudah diterapkan ke tombol taskbar, overlay yang ada akan diganti. Nilai ini bisa berupa NULL
. NULL
Bagaimana nilai ditangani tergantung pada apakah tombol taskbar mewakili satu jendela atau sekelompok jendela. Ini adalah tanggung jawab aplikasi panggilan untuk gratis hIcon
ketika tidak lagi diperlukan.
Tampilkan Nilai
TRUE
jika berhasil; FALSE
jika versi OS kurang dari Windows 7 atau jika terjadi kesalahan saat mengatur ikon.
Keterangan
CFrameWnd::SetTitle
Mengatur judul objek jendela.
void SetTitle(LPCTSTR lpszTitle);
Parameter
lpszTitle
Penunjuk ke string karakter yang berisi judul objek jendela.
CFrameWnd::ShowControlBar
Panggil fungsi anggota ini untuk menampilkan atau menyembunyikan bilah kontrol.
void ShowControlBar(
CControlBar* pBar,
BOOL bShow,
BOOL bDelay);
Parameter
pBar
Arahkan ke bilah kontrol untuk ditampilkan atau disembunyikan.
bShow
Jika TRUE
, menentukan bahwa bilah kontrol akan ditampilkan. Jika FALSE
, menentukan bahwa bilah kontrol akan disembunyikan.
bDelay
Jika TRUE
, penundaan memperlihatkan bilah kontrol. Jika FALSE
, segera tampilkan bilah kontrol.
CFrameWnd::ShowOwnedWindows
Panggil fungsi anggota ini untuk menampilkan semua jendela yang merupakan turunan objek CFrameWnd
.
void ShowOwnedWindows(BOOL bShow);
Parameter
bShow
Menentukan apakah jendela yang dimiliki akan ditampilkan atau disembunyikan.
Lihat juga
CWnd
Kelas
Bagan Hierarki
CWnd
Kelas
CMDIFrameWnd
Kelas
CMDIChildWnd
Kelas
CView
Kelas
CDocTemplate
Kelas
CRuntimeClass
Struktur