Kelas CMFCCaptionButton

Kelas CMFCCaptionButton mengimplementasikan tombol yang ditampilkan pada bilah keterangan untuk panel docking atau jendela bingkai mini. Biasanya, kerangka kerja membuat tombol keterangan secara otomatis.

Sintaks

class CMFCCaptionButton : public CObject

Anggota

Konstruktor

Nama	Deskripsi
CMFCCaptionButton::CMFCCaptionButton	Membuat objek CMFCCaptionButton.

Metode Publik

Nama	Deskripsi
CMFCCaptionButton::GetHit	Mengembalikan perintah yang diwakili oleh tombol .
CMFCCaptionButton::GetIconID	Mengembalikan ID gambar yang terkait dengan tombol .
CMFCCaptionButton::GetRect	Mengembalikan persegi panjang yang ditempati oleh tombol .
CMFCCaptionButton::GetSize	Mengembalikan lebar dan tinggi tombol.
CMFCCaptionButton::IsMiniFrameButton	Menunjukkan apakah tinggi bilah judul diatur ke ukuran mini.
CMFCCaptionButton::Move	Mengatur lokasi gambar tombol dan status peragaan jendela.
CMFCCaptionButton::OnDraw	Menggambar tombol keterangan.
CMFCCaptionButton::SetMiniFrameButton	Mengatur ukuran mini bilah judul.

Keterangan

Anda dapat memperoleh kelas dari Kelas CPaneFrameWnd dan menggunakan metode yang dilindungi, AddButton, untuk menambahkan tombol keterangan ke jendela bingkai mini.

CPaneFrameWnd.h mendefinisikan ID perintah untuk dua jenis tombol keterangan:

• AFX_CAPTION_BTN_PIN, yang menampilkan tombol sematkan saat panel dok mendukung mode sembunyikan otomatis.

• AFX_CAPTION_BTN_CLOSE, yang menampilkan tombol Tutup saat panel dapat ditutup atau disembunyikan.

Contoh

Contoh berikut menunjukkan cara membuat CMFCCaptionButton objek dan mengatur ukuran mini bilah judul.

CMFCCaptionButton *captionButton = new CMFCCaptionButton(AFX_HTCLOSE);
captionButton->SetMiniFrameButton(true);

Hierarki Warisan

CObject

CMFCCaptionButton

Persyaratan

Header: afxcaptionbutton.h

CMFCCaptionButton::CMFCCaptionButton

Membuat CMFCCaptionButton objek.

CMFCCaptionButton();

CMFCCaptionButton(
    UINT nHit,
    BOOL bLeftAlign = FALSE);

Parameter

nHit
[di] Perintah yang terkait dengan tombol .

bLeftAlign
[di] Menentukan apakah tombol diratakan ke kiri.

Tabel berikut mencantumkan nilai yang mungkin untuk parameter nHit .

Nilai	Perintah
AFX_HTCLOSE	Tombol Tutup.
HTMINBUTTON	Tombol Minimalkan.
HTMAXBUTTON	Tombol Maksimalkan.
AFX_HTLEFTBUTTON	Tombol panah kiri.
AFX_HTRIGHTBUTTON	Tombol panah kanan.
AFX_HTMENU	Tombol menu panah bawah.
HTNOWHERE	Nilai default; tidak mewakili perintah.

Keterangan

Secara default, tombol keterangan tidak terkait dengan perintah.

Tombol keterangan diratakan baik di kanan atau kiri.

CMFCCaptionButton::GetHit

Mengembalikan perintah yang diwakili oleh tombol .

UINT GetHit() const;

Tampilkan Nilai

Perintah yang diwakili oleh tombol .

Tabel berikut ini mencantumkan kemungkinan nilai pengembalian.

Nilai	Perintah
AFX_HTCLOSE	Tombol Tutup.
HTMINBUTTON	Tombol Minimalkan.
HTMAXBUTTON	Tombol Maksimalkan.
AFX_HTLEFTBUTTON	Tombol panah kiri.
AFX_HTRIGHTBUTTON	Tombol panah kanan.
AFX_HTMENU	Tombol menu panah bawah.
HTNOWHERE	Nilai default; tidak mewakili perintah.

CMFCCaptionButton::GetIconID

Mengembalikan ID gambar yang terkait dengan tombol .

virtual CMenuImages::IMAGES_IDS GetIconID(
    BOOL bHorz,
    BOOL bMaximized = FALSE) const;

Parameter

bHorz
[di] TRUE untuk ID gambar panah kiri atau kanan; FALSE untuk ID gambar panah atas atau bawah.

bMaximized
[di] TRUE untuk memaksimalkan ID gambar; FALSE untuk meminimalkan ID gambar.

Tampilkan Nilai

ID gambar.

Keterangan

Parameter menentukan ID gambar untuk meminimalkan atau memaksimalkan tombol keterangan.

CMFCCaptionButton::GetRect

Mengembalikan persegi panjang yang ditempati oleh tombol .

virtual CRect GetRect() const;

Tampilkan Nilai

Persegi panjang yang mewakili lokasi tombol.

Keterangan

Jika Anda tidak dapat melihat tombol , ukuran yang dikembalikan adalah 0.

CMFCCaptionButton::GetSize

Mengembalikan lebar dan tinggi tombol.

static CSize GetSize();

Tampilkan Nilai

Dimensi luar tombol.

Keterangan

Ukuran yang dikembalikan mencakup margin tombol dan batas.

CMFCCaptionButton::IsMiniFrameButton

Menunjukkan apakah tinggi bilah judul diatur ke ukuran mini.

BOOL IsMiniFrameButton() const;

Tampilkan Nilai

TRUE jika keterangan diatur ke ukuran mini; jika tidak FALSE.

Keterangan

CMFCCaptionButton::Move

Mengatur lokasi gambar tombol dan status peragaan jendela.

void Move(
    const CPoint& ptTo,
    BOOL bHide = FALSE);

Parameter

ptTo
[di] Lokasi baru.

bHide
[di] Apakah akan menampilkan tombol.

CMFCCaptionButton::OnDraw

Menggambar tombol keterangan.

virtual void OnDraw(
    CDC* pDC,
    BOOL bActive,
    BOOL bHorz = TRUE,
    BOOL bMaximized = TRUE,
    BOOL bDisabled = FALSE);

Parameter

pDC
[di] Arahkan ke konteks perangkat untuk tombol .

bActive
[di] Apakah akan menggambar gambar tombol aktif.

bHorz
[di] Dicadangkan untuk digunakan dalam kelas turunan.

bMaximized
[di] Apakah akan menggambar gambar tombol yang dimaksimalkan.

bDisabled
[di] Apakah akan menggambar gambar tombol yang diaktifkan.

Keterangan

Parameter bMaximized digunakan saat tombol adalah tombol maksimalkan atau minimalkan.

CMFCCaptionButton::SetMiniFrameButton

Mengatur ukuran mini bilah judul.

void SetMiniFramebutton(BOOL bSet = TRUE);

Parameter

bSet
[di] TRUE untuk tinggi bilah judul mini; FALSE untuk tinggi batang judul default.

Lihat juga

Bagan Hierarki
Kelas
Kelas CPaneFrameWnd
Kelas CDockablePane