`CFrameWnd` Kelas

Artikel
10/12/2023

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 CreateLoadFrame, 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 memanggil CView::OnActivateView.
Pesan perintah dan banyak pesan pemberitahuan bingkai umum, termasuk yang ditangani OnSetFocusoleh fungsi CWnd, OnHScroll, dan OnVScroll , didelegasikan oleh CFrameWnd 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. Jendela CFrameWnd 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 menggunakan UPDATE_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 dengan LoadFrame 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 ketika ShellExecute 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 (untuk OnClose dan OnQueryEndSession).
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 CFrameWndPostNcDestroy 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

CObject

CCmdTarget

CWnd

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 CViewditurunkan 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::EnableDockingCFrameWnd::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 pContextNULL 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 = 1
borderRequest = 2
borderSet = 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 PreCreateWindowanggota .

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

Bagikan melalui

CFrameWnd Kelas

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Metode yang Dilindungi

Anggota Data Publik

Keterangan

Hierarki Warisan

Persyaratan

CFrameWnd::ActivateFrame

Parameter

Keterangan

Contoh

CFrameWnd::BeginModalState

CFrameWnd::CFrameWnd

Keterangan

CFrameWnd::Create

Parameter

Tampilkan Nilai

Keterangan

CFrameWnd::CreateView

Parameter

Tampilkan Nilai

Keterangan

CFrameWnd::DockControlBar

Parameter

Keterangan

CFrameWnd::EnableDocking

Parameter

Keterangan

Contoh

CFrameWnd::EndModalState

Keterangan

CFrameWnd::FloatControlBar

Parameter

Keterangan

CFrameWnd::GetActiveDocument

Tampilkan Nilai

CFrameWnd::GetActiveFrame

Tampilkan Nilai

Keterangan

CFrameWnd::GetActiveView

Tampilkan Nilai

Keterangan

CFrameWnd::GetControlBar

Parameter

Tampilkan Nilai

Keterangan

CFrameWnd::GetDockState

Parameter

Keterangan

CFrameWnd::GetMenuBarState

Tampilkan Nilai

Keterangan

CFrameWnd::GetMenuBarVisibility

Tampilkan Nilai

Keterangan

CFrameWnd::GetMessageBar

Tampilkan Nilai

CFrameWnd::GetMessageString

Parameter

Keterangan

CFrameWnd::GetTitle

Tampilkan Nilai

CFrameWnd::InitialUpdateFrame

Parameter

Keterangan

CFrameWnd::InModalState

Tampilkan Nilai

CFrameWnd::IsTracking

Tampilkan Nilai

CFrameWnd::LoadAccelTable

Parameter

Tampilkan Nilai

Keterangan

CFrameWnd::LoadBarState

Parameter

Keterangan

`CFrameWnd` Kelas

`CFrameWnd::ActivateFrame`

`CFrameWnd::BeginModalState`

`CFrameWnd::CFrameWnd`

`CFrameWnd::Create`

`CFrameWnd::CreateView`

`CFrameWnd::DockControlBar`

`CFrameWnd::EnableDocking`

`CFrameWnd::EndModalState`

`CFrameWnd::FloatControlBar`

`CFrameWnd::GetActiveDocument`

`CFrameWnd::GetActiveFrame`

`CFrameWnd::GetActiveView`

`CFrameWnd::GetControlBar`

`CFrameWnd::GetDockState`

`CFrameWnd::GetMenuBarState`

`CFrameWnd::GetMenuBarVisibility`

`CFrameWnd::GetMessageBar`

`CFrameWnd::GetMessageString`

`CFrameWnd::GetTitle`

`CFrameWnd::InitialUpdateFrame`

`CFrameWnd::InModalState`

`CFrameWnd::IsTracking`

`CFrameWnd::LoadAccelTable`

`CFrameWnd::LoadBarState`

`CFrameWnd::LoadFrame`

`CFrameWnd::m_bAutoMenuEnable`

`CFrameWnd::NegotiateBorderSpace`

`CFrameWnd::OnBarCheck`

`CFrameWnd::OnContextHelp`

`CFrameWnd::OnCreateClient`

`CFrameWnd::OnHideMenuBar`

`CFrameWnd::OnSetPreviewMode`

`CFrameWnd::OnShowMenuBar`

`CFrameWnd::OnUpdateControlBarMenu`

`CFrameWnd::RecalcLayout`

`CFrameWnd::rectDefault`

`CFrameWnd::SaveBarState`

`CFrameWnd::SetActivePreviewView`

`CFrameWnd::SetActiveView`

`CFrameWnd::SetDockState`

`CFrameWnd::SetMenuBarState`

`CFrameWnd::SetMenuBarVisibility`

`CFrameWnd::SetMessageText`

`CFrameWnd::SetProgressBarPosition`

`CFrameWnd::SetProgressBarRange`

`CFrameWnd::SetProgressBarState`

`CFrameWnd::SetTaskbarOverlayIcon`

`CFrameWnd::SetTitle`