Kelas CMFCOutlookBarTabCtrl

Artikel
10/12/2023

Kontrol tab yang memiliki tampilan visual Panel Navigasi di Microsoft Outlook. Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

Sintaks

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Anggota

Konstruktor Publik

Nama	Deskripsi
`CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl`	Konstruktor default.
`CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl`	Destruktor.

Metode Publik

Nama	Deskripsi
CMFCOutlookBarTabCtrl::AddControl	Menambahkan kontrol Windows sebagai tab baru di bilah Outlook.
`CMFCOutlookBarTabCtrl::CalcRectEdit`	Dipanggil oleh kerangka kerja untuk menentukan dimensi kotak edit yang muncul saat pengguna mengganti nama tab. (Ambil alih `CMFCBaseTabCtrl::CalcRectEdit`.)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons	Dipanggil oleh kerangka kerja selama operasi pengubahan ukuran untuk menentukan apakah lebih sedikit tombol halaman tab bilah Outlook yang dapat ditampilkan daripada yang saat ini terlihat.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons	Dipanggil oleh kerangka kerja selama operasi pengubahan ukuran untuk menentukan apakah lebih banyak tombol halaman tab bilah Outlook dapat ditampilkan daripada yang saat ini terlihat.
CMFCOutlookBarTabCtrl::Create	Membuat kontrol tab bilah Outlook.
`CMFCOutlookBarTabCtrl::CreateObject`	Digunakan oleh kerangka kerja untuk membuat instans dinamis dari jenis kelas ini.
CMFCOutlookBarTabCtrl::EnableAnimation	Menentukan apakah animasi yang terjadi selama pengalihan antar tab aktif diaktifkan.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit	Menentukan apakah pengguna dapat mengubah label teks pada tombol tab bilah Outlook. (Penimpaan CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons	Dipanggil oleh kerangka kerja untuk mengaktifkan tombol yang memungkinkan pengguna menggulir tombol pada panel bilah Outlook.
`CMFCOutlookBarTabCtrl::FindTargetWnd`	Mengidentifikasi panel yang berisi titik tertentu. (Penimpaan CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize	Mengembalikan ukuran batas kontrol tab Outlook.
`CMFCOutlookBarTabCtrl::GetTabArea`	Mengambil ukuran dan posisi area tab kontrol tab. (Penimpaan CMFCBaseTabCtrl::GetTabArea.)
`CMFCOutlookBarTabCtrl::GetThisClass`	Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke objek CRuntimeClass yang terkait dengan jenis kelas ini.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation	Menentukan apakah animasi yang terjadi selama peralihan antara tab aktif diaktifkan.
CMFCOutlookBarTabCtrl::IsMode2003	Menentukan apakah kontrol tab bilah Outlook berada dalam mode yang mengemulasi Microsoft Outlook 2003.
`CMFCOutlookBarTabCtrl::IsPtInTabArea`	Menentukan apakah titik berada di dalam area tab. (Penimpaan CMFCBaseTabCtrl::IsPtInTabArea.)
`CMFCOutlookBarTabCtrl::IsTabDetachable`	Menentukan apakah tab dapat dilepas. (Penimpaan CMFCBaseTabCtrl::IsTabDetachable.)
`CMFCOutlookBarTabCtrl::OnChangeTabs`	Dipanggil oleh kerangka kerja saat tab disisipkan atau dihapus. (Mengambil alih `CMFCBaseTabCtrl::OnChangeTabs`.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons	Dipanggil oleh kerangka kerja untuk mengurangi jumlah tombol halaman tab yang terlihat.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons	Dipanggil oleh kerangka kerja untuk meningkatkan jumlah tombol halaman tab yang terlihat.
CMFCOutlookBarTabCtrl::OnShowOptions	Menampilkan dialog Opsi Panel Navigasi.
`CMFCOutlookBarTabCtrl::RecalcLayout`	Menghitung ulang tata letak internal kontrol tab. (Penimpaan CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab	Mengatur tab aktif. (Mengganti CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize	Mengatur ukuran batas kontrol tab Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign	Mengatur perataan label teks pada tombol tab bilah Outlook.
CMFCOutlookBarTabCtrl::SetToolbarImageList	Mengatur bitmap yang berisi ikon yang ditampilkan di bagian bawah bilah Outlook dalam mode Outlook 2003 (lihat Kelas CMFCOutlookBar).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Keterangan

Untuk membuat bilah Outlook yang memiliki dukungan docking, gunakan objek untuk menghosting CMFCOutlookBar kontrol tab bilah Outlook. Untuk informasi selengkapnya, lihat Kelas CMFCOutlookBar.

Contoh

Contoh berikut menunjukkan cara menginisialisasi CMFCOutlookBarTabCtrl objek dan menggunakan berbagai metode di CMFCOutlookBarTabCtrl kelas . Contoh memperlihatkan cara mengaktifkan pengeditan label teks di tempat pada tombol halaman tab bilah Outlook, mengaktifkan animasi, mengaktifkan gagang gulir yang memungkinkan pengguna untuk menggulir tombol pada panel bilah Outlook, mengatur ukuran batas kontrol tab Outlook, dan mengatur perataan label teks pada tombol tab bilah Outlook. Cuplikan kode ini adalah bagian dari sampel Demo Outlook.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Hierarki Warisan

CMFCOutlookBarTabCtrl

Persyaratan

Header: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Menambahkan kontrol Windows sebagai tab baru di bilah Outlook.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

Parameter

pWndCtrl
[di] Penunjuk ke kontrol untuk ditambahkan.

lpszName
[di] Menentukan nama tab.

bDetachable
[di] Jika TRUE, halaman akan dibuat sebagai dapat dilepas.

nImageID
[di] Indeks gambar dalam daftar gambar internal agar gambar ditampilkan di tab baru.

dwControlBarStyle
[di] Menentukan gaya AFX_ CBRS_* untuk panel docking yang dibungkus.

Keterangan

Gunakan fungsi ini untuk menambahkan kontrol sebagai halaman baru bilah outlook.

Fungsi ini secara internal memanggil CMFCBaseTabCtrl ::AddTab.

Jika Anda mengatur bDetachable ke TRUE, AddControl secara internal membuat CDockablePaneAdapter objek dan membungkus kontrol yang ditambahkan. Ini secara otomatis mengatur kelas runtime jendela bertab ke kelas CMFCOutlookBar runtime dan kelas runtime bingkai mengambang ke CMultiPaneFrameWnd.

Contoh

Contoh berikut menunjukkan cara menggunakan AddControl metode di CMFCOutlookBarTabCtrl kelas . Cuplikan kode ini adalah bagian dari sampel Demo Outlook.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Dipanggil oleh kerangka kerja selama operasi pengubahan ukuran untuk menentukan apakah lebih sedikit tombol halaman tab bilah Outlook yang dapat ditampilkan daripada yang saat ini terlihat.

virtual BOOL CanShowFewerPageButtons() const;

Tampilkan Nilai

TRUE jika ada lebih dari satu tombol; jika tidak FALSE.

Keterangan

Kontrol tab bilah Outlook secara dinamis menambahkan atau menghapus tab dari tampilan bergantung pada berapa banyak ruang yang tersedia. Metode ini digunakan oleh kerangka kerja untuk membantu dalam proses tersebut.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Dipanggil oleh kerangka kerja selama operasi pengubahan ukuran untuk menentukan apakah lebih banyak tombol halaman tab bilah Outlook dapat ditampilkan daripada yang saat ini terlihat.

virtual BOOL CanShowMorePageButtons() const;

Tampilkan Nilai

TRUE jika ada tombol yang saat ini tidak terlihat; jika tidak FALSE.

Keterangan

Kontrol tab bilah Outlook secara dinamis menambahkan atau menghapus tab dari tampilan, bergantung pada berapa banyak ruang yang tersedia. Metode ini digunakan oleh kerangka kerja untuk membantu dalam proses tersebut.

CMFCOutlookBarTabCtrl::Create

Membuat kontrol tab bilah Outlook.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

rect
[di] Menentukan ukuran dan posisi awal, dalam piksel.

pParentWnd
[di] Menunjuk ke jendela induk. Tidak boleh NULL.

Nid
[di] ID kontrol.

Tampilkan Nilai

Bukan nol jika kontrol berhasil dibuat; jika tidak, 0.

Keterangan

Biasanya, kontrol tab bilah outlook dibuat ketika Kelas CMFCOutlookBar mengontrol pesan WM_CREATE proses.

CMFCOutlookBarTabCtrl::EnableAnimation

Menentukan apakah animasi yang terjadi selama pengalihan antar tab aktif diaktifkan.

static void EnableAnimation(BOOL bEnable=TRUE);

Parameter

bEnable
[di] Menentukan apakah animasi harus diaktifkan atau dinonaktifkan.

Keterangan

Panggil fungsi ini untuk mengaktifkan dan menonaktifkan animasi. Saat pengguna membuka halaman tab, keterangan halaman meluncur ke atas atau ke bawah jika animasi diaktifkan. Jika animasi dinonaktifkan, halaman akan segera aktif.

Secara default, animasi diaktifkan.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Menentukan apakah pengguna dapat mengubah label teks pada tombol halaman tab bilah Outlook.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parameter

bEnable
Jika TRUE, aktifkan pengeditan label teks di tempat. Jika FALSE, nonaktifkan pengeditan di tempat.

Keterangan

Panggil fungsi ini untuk mengaktifkan atau menonaktifkan pengeditan label teks di tempat pada tombol halaman tab. Secara default pengeditan di tempat dinonaktifkan.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Dipanggil oleh kerangka kerja untuk mengaktifkan handel gulir yang memungkinkan pengguna menggulir tombol pada panel bilah Outlook.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parameter

bEnable
[di] Menentukan apakah tombol gulir ditampilkan.

bIsUp
[di] Menentukan apakah bilah gulir atas ditampilkan.

bIsDown
[di] Menentukan apakah bilah gulir bawah ditampilkan.

Keterangan

Mengaktifkan tampilan tombol gulir. Metode ini dipanggil oleh kerangka kerja ketika tab aktif berubah untuk memulihkan tombol gulir.

CMFCOutlookBarTabCtrl::GetBorderSize

Mengembalikan ukuran batas kontrol tab Outlook.

int GetBorderSize() const;

Tampilkan Nilai

Ukuran batas, dalam piksel.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::IsAnimation

Menentukan apakah animasi yang terjadi selama pengalihan antar tab aktif diaktifkan.

static BOOL IsAnimation();

Tampilkan Nilai

Bukan nol jika animasi diaktifkan; jika tidak, 0.

Keterangan

Panggil fungsi CMFCOutlookBarTabCtrl::EnableAnimation untuk mengaktifkan atau menonaktifkan animasi.

CMFCOutlookBarTabCtrl::IsMode2003

Menentukan apakah kontrol tab bilah Outlook berada dalam mode yang mengemulasi Microsoft Outlook 2003.

BOOL IsMode2003() const;

Tampilkan Nilai

TRUE jika kontrol tab bilah Outlook berada dalam mode Outlook 2003; jika tidak FALSE;

Keterangan

Nilai ini diatur oleh CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Dipanggil oleh kerangka kerja untuk mengurangi jumlah tombol halaman tab yang terlihat.

virtual void OnShowFewerPageButtons();

Keterangan

Metode ini menyesuaikan jumlah tombol tab halaman yang terlihat saat kontrol diubah ukurannya.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Dipanggil oleh kerangka kerja untuk meningkatkan jumlah tombol halaman tab yang terlihat.

virtual void OnShowMorePageButtons();

Keterangan

Metode ini menyesuaikan jumlah tombol halaman tab yang terlihat saat kontrol diubah ukurannya.

CMFCOutlookBarTabCtrl::OnShowOptions

Menampilkan kotak dialog Opsi Panel Navigasi.

virtual void OnShowOptions();

Keterangan

Kotak dialog Opsi Panel Navigasi memungkinkan pengguna untuk memilih tombol halaman tab mana yang akan ditampilkan, dan urutan tampilannya.

Metode ini dipanggil oleh kerangka kerja saat pengguna memilih item menu Opsi Panel Navigasi dari menu kustomisasi kontrol.

CMFCOutlookBarTabCtrl::SetActiveTab

Mengatur tab aktif. Tab aktif adalah tab yang terbuka, dengan kontennya terlihat.

virtual BOOL SetActiveTab(int iTab);

Parameter

iTab
[di] Indeks berbasis nol dari tab yang akan dibuka.

Tampilkan Nilai

Bukan nol jika tab yang ditentukan telah berhasil dibuka; jika tidak, 0.

Keterangan

Efek visual pengaturan tab aktif bergantung pada apakah Anda telah mengaktifkan animasi. Untuk informasi selengkapnya, lihat CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Mengatur ukuran batas kontrol tab Outlook.

void SetBorderSize(int nBorderSize);

Parameter

nBorderSize
[di] Menentukan ukuran batas baru dalam piksel.

Keterangan

Mengatur ukuran batas baru dan menghitung ulang tata letak jendela outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Mengatur perataan label teks pada tombol tab bilah Outlook.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parameter

uiAlign
[di] Menentukan perataan teks.

bRedraw
[di] Jika TRUE, jendela outlook akan digambar ulang.

Keterangan

Gunakan fungsi ini untuk mengubah perataan teks untuk tombol halaman.

uiAlign bisa menjadi salah satu nilai berikut:

Terus-menerus	Makna
TA_LEFT	Perataan kiri
TA_CENTER	Perataan tengah
TA_RIGHT	Perataan kanan

Nilai defaultnya adalah TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Mengatur bitmap yang berisi ikon yang ditampilkan di bagian bawah bilah Outlook dalam mode Outlook 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parameter

uiID
[di] Menentukan ID sumber daya gambar yang akan dimuat.

cx
[di] Menentukan lebar gambar dalam daftar gambar, dalam piksel.

clrTransp
[di] Nilai RGB yang menentukan warna transparan.

Tampilkan Nilai

Mengembalikan TRUE jika berhasil; jika tidak, mengembalikan FALSE.

Keterangan

Gunakan fungsi ini untuk melampirkan daftar gambar yang gambarnya akan ditampilkan pada tombol toolbar dalam mode Microsoft Office 2003. Indeks gambar harus sesuai dengan indeks halaman.

Metode ini tidak boleh dipanggil jika tidak dalam mode Microsoft Office 2003. Untuk informasi selengkapnya, lihat Kelas CMFCOutlookBar.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parameter

[di] nVisiblePageButtons

Keterangan

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCBaseTabCtrl
Kelas CMFCOutlookBar
Kelas CMFCOutlookBarPane

Bagikan melalui

Kelas CMFCOutlookBarTabCtrl

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Contoh

Hierarki Warisan

Persyaratan

CMFCOutlookBarTabCtrl::AddControl

Parameter

Keterangan

Contoh

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::Create

Parameter

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::EnableAnimation

Parameter

Keterangan

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Parameter

Keterangan

CMFCOutlookBarTabCtrl::EnableScrollButtons

Parameter

Keterangan

CMFCOutlookBarTabCtrl::GetBorderSize

Tampilkan Nilai

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::IsAnimation

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::IsMode2003

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Keterangan

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Keterangan

CMFCOutlookBarTabCtrl::OnShowOptions

Keterangan

CMFCOutlookBarTabCtrl::SetActiveTab

Parameter

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::SetBorderSize

Parameter

Keterangan

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Parameter

Keterangan

CMFCOutlookBarTabCtrl::SetToolbarImageList

Parameter

Tampilkan Nilai

Keterangan

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Parameter

Keterangan

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: