Kelas CMFCAutoHideBar

Nota

Pustaka Microsoft Foundation Classes (MFC) terus didukung. Namun, kami tidak lagi menambahkan fitur atau memperbarui dokumentasi.

Kelas CMFCAutoHideBar adalah kelas toolbar khusus yang mengimplementasikan fitur sembunyikan otomatis.

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

Sintaks

class CMFCAutoHideBar : public CPane

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCAutoHideBar::CMFCAutoHideBar

Metode Publik

Nama Deskripsi
CMFCAutoHideBar::AddAutoHideWindow
CMFCAutoHideBar::AllowShowOnPaneMenu (Mengambil alih CPane::AllowShowOnPaneMenu.)
CMFCAutoHideBar::CalcFixedLayout (Penimpaan CBasePane::CalcFixedLayout.)
CMFCAutoHideBar::Create Membuat bilah kontrol dan melampirkannya ke objek CPane . (Penimpaan CPane::Create.)
CMFCAutoHideBar::GetFirstAHWindow
CMFCAutoHideBar::GetVisibleCount
CMFCAutoHideBar::OnShowControlBarMenu Dipanggil oleh kerangka kerja saat menu panel khusus akan ditampilkan. (Penimpaan CPane::OnShowControlBarMenu.)
CMFCAutoHideBar::RemoveAutoHideWindow
CMFCAutoHideBar::SetActiveInGroup (Penimpaan CPane::SetActiveInGroup.)
CMFCAutoHideBar::SetRecentVisibleState
CMFCAutoHideBar::ShowAutoHideWindow
CMFCAutoHideBar::StretchPane Membentangkan panel secara vertikal atau horizontal. (Penimpaan CBasePane::StretchPane.)
CMFCAutoHideBar::UnSetAutoHideMode
CMFCAutoHideBar::UpdateVisibleState

Anggota Data

Nama Deskripsi
CMFCAutoHideBar::m_nShowAHWndDelay Penundaan waktu antara saat pengguna menempatkan kursor mouse di atas Kelas CMFCAutoHideButton dan saat ketika kerangka kerja menunjukkan jendela terkait.

Keterangan

Saat pengguna mengalihkan panel dock ke mode sembunyikan otomatis, kerangka kerja secara otomatis membuat CMFCAutoHideBar objek. Ini juga membuat objek CAutoHideDockSite dan CMFCAutoHideButton yang diperlukan. Setiap CAutoHideDockSite objek dikaitkan dengan individu CMFCAutoHideButton.

Kelas CMFCAutoHideBar mengimplementasikan tampilan CAutoHideDockSite saat mouse pengguna melayang di atas CMFCAutoHideButton. Saat toolbar menerima pesan WM_MOUSEMOVE, CMFCAutoHideBar memulai timer. Ketika timer selesai, timer mengirimkan toolbar pemberitahuan peristiwa WM_TIMER. Bilah alat menangani peristiwa ini dengan memeriksa apakah penunjuk mouse diposisikan di atas tombol sembunyikan otomatis yang sama dengan yang diposisikan ketika timer dimulai. Jika ya, terlampir CAutoHideDockSite akan ditampilkan.

Anda dapat mengontrol panjang penundaan timer dengan mengatur m_nShowAHWndDelay. Nilai defaultnya adalah 400 mdtk.

Contoh

Contoh berikut menunjukkan cara membuat CMFCAutoHideBar objek dan menggunakan metodenya GetDockSiteRow .

CMFCAutoHideBar *pParentBar = new CMFCAutoHideBar();
CDockingPanesRow *pParentRow = pParentBar->GetDockSiteRow();

Hierarki Warisan

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCAutoHideBar

Persyaratan

Header: afxautohidebar.h

CMFCAutoHideBar::AddAutoHideWindow

Menambahkan fungsionalitas ke CDockablePane jendela yang memungkinkannya untuk menyembunyikan secara otomatis.

CMFCAutoHideButton* AddAutoHideWindow(
    CDockablePane* pAutoHideWnd,
    DWORD dwAlignment);

Parameter

pAutoHideWnd
[di] Jendela yang ingin Anda sembunyikan.

dwAlignment
[di] Nilai yang menentukan perataan tombol sembunyikan otomatis dengan jendela aplikasi.

Tampilkan Nilai

Keterangan

Parameter dwAlignment menunjukkan tempat tombol sembunyikan otomatis berada di aplikasi. Parameter dapat berupa salah satu nilai berikut:

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

CMFCAutoHideBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Tampilkan Nilai

Keterangan

CMFCAutoHideBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameter

[di] bStretch

[di] bHorz

Tampilkan Nilai

Keterangan

CMFCAutoHideBar::CMFCAutoHideBar

Membuat objek CMFCAutoHideBar.

CMFCAutoHideBar();

Keterangan

CMFCAutoHideBar::Create

virtual BOOL Create(
    LPCTSTR lpszClassName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parameter

lpszClassName

dwStyle

rect

pParentWnd

Nid

dwControlBarStyle

pContext

Tampilkan Nilai

Keterangan

CMFCAutoHideBar::GetFirstAHWindow

Mengembalikan penunjuk ke jendela sembunyikan otomatis pertama dalam aplikasi.

CDockablePane* GetFirstAHWindow();

Tampilkan Nilai

Jendela sembunyikan otomatis pertama dalam aplikasi, atau NULL jika tidak ada.

Keterangan

CMFCAutoHideBar::GetVisibleCount

Mendapatkan jumlah tombol sembunyikan otomatis yang terlihat.

int GetVisibleCount();

Tampilkan Nilai

Mengembalikan jumlah tombol sembunyikan otomatis yang terlihat.

Keterangan

CMFCAutoHideBar::m_nShowAHWndDelay

Penundaan waktu antara saat pengguna menempatkan kursor mouse di atas Kelas CMFCAutoHideButton dan saat ketika kerangka kerja menunjukkan jendela terkait.

int CMFCAutoHideBar::m_nShowAHWndDelay = 400;

Keterangan

Ketika pengguna menempatkan kursor mouse di atas CMFCAutoHideButton, ada sedikit penundaan sebelum kerangka kerja menampilkan jendela terkait. Parameter ini menentukan panjang penundaan tersebut dalam milidetik.

CMFCAutoHideBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parameter

[di] CPoint

Tampilkan Nilai

Keterangan

CMFCAutoHideBar::RemoveAutoHideWindow

Menghapus dan menghancurkan jendela sembunyikan otomatis.

    BOOL RemoveAutoHideWindow(CDockablePane* pAutoHideWnd);

Parameter

CDockablePane* pAutoHideWnd Jendela sembunyikan otomatis untuk dihapus.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

CMFCAutoHideBar::SetActiveInGroup

Menandai bilah sembunyikan otomatis sebagai aktif.

virtual void SetActiveInGroup(BOOL bActive);

Parameter

[di] BOOL bActive TRUE untuk diatur ke aktif; jika tidak FALSE.

Keterangan

Lihat CPane::SetActiveInGroup.

CMFCAutoHideBar::SetRecentVisibleState

void SetRecentVisibleState(BOOL bState);

Parameter

bState
[di] Status yang akan diatur.

Keterangan

CMFCAutoHideBar::ShowAutoHideWindow

Memperlihatkan jendela sembunyikan otomatis.

BOOL ShowAutoHideWindow(
    CDockablePane* pAutoHideWnd,
    BOOL bShow,
    BOOL bDelay);

Parameter

pAutoHideWnd
[di] Jendela untuk ditampilkan.

bShow
[di] TRUE untuk menampilkan jendela.

bDelay
[di] Parameter ini diabaikan.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

CMFCAutoHideBar::StretchPane

Mengubah ukuran bilah sembunyikan otomatis dalam status diciutkan agar pas dengan CMFCAutoHideButton objek.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameter

nLength
[di] Nilai tidak digunakan dalam implementasi dasar. Dalam implementasi turunan, gunakan nilai ini untuk menunjukkan panjang panel yang diubah ukurannya.

bVert
[di] Nilai tidak digunakan dalam implementasi dasar. Dalam implementasi turunan, gunakan TRUE untuk menangani kasus di mana bilah sembunyikan otomatis diciutkan secara vertikal, dan FALSE untuk kasus di mana bilah sembunyikan otomatis diciutkan secara horizontal.

Tampilkan Nilai

Ukuran yang dihasilkan dari panel mengubah ukuran.

Keterangan

Kelas turunan dapat mengambil alih metode ini untuk menyesuaikan perilaku.

CMFCAutoHideBar::UnSetAutoHideMode

Menonaktifkan mode sembunyikan otomatis untuk sekelompok bilah sembunyikan otomatis.

void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup)

Parameter

[in] pFirstBarInGroup Penunjuk ke bilah sembunyikan otomatis pertama dalam grup.

Keterangan

CMFCAutoHideBar::UpdateVisibleState

Dipanggil oleh kerangka kerja ketika bilah sembunyikan otomatis perlu digambar ulang.

void UpdateVisibleState();

Keterangan

Lihat juga

Bagan Hierarki
Kelas
Kelas CPane
Kelas CAutoHideDockSite
Kelas CMFCAutoHideButton