Kelas CSmartDockingInfo

Mendefinisikan tampilan penanda docking pintar.

Sintaks

class CSmartDockingInfo : public CObject

Anggota

Konstruktor Publik

Nama	Deskripsi
CSmartDockingInfo::CSmartDockingInfo	Konstruktor default.

Metode Publik

Nama	Deskripsi
CSmartDockingInfo::CopyTo	Menyalin parameter info docking pintar saat ini ke dalam objek CSmartDockingInfo yang disediakan.

Anggota Data

Nama	Deskripsi
CSmartDockingInfo::m_bUseThemeColorInShading	Menentukan apakah akan menggunakan warna tema saat ini saat kerangka kerja menampilkan penanda docking pintar.
CSmartDockingInfo::m_clrBaseBackground	Menentukan warna latar belakang dasar penanda docking pintar.
CSmartDockingInfo::m_clrToneDest	Menentukan warna yang menggantikan m_clrToneSrc dalam bitmap penanda docking pintar.
CSmartDockingInfo::m_clrToneSrc	Menentukan warna bitmap penanda docking pintar.
CSmartDockingInfo::m_clrTransparent	Menentukan warna bitmap penanda docking pintar saat transparan.
CSmartDockingInfo::m_nCentralGroupOffset	Menentukan offset grup pusat penanda docking pintar dari batas persegi panjang grup pusat.
CSmartDockingInfo::m_sizeTotal	Menentukan ukuran total semua penanda docking pintar dalam grup.
CSmartDockingInfo::m_uiMarkerBmpResID	Menentukan ID sumber daya bitmap yang digunakan kerangka kerja untuk penanda docking pintar yang tidak disorot.
CSmartDockingInfo::m_uiMarkerLightBmpResID	Menentukan ID sumber daya bitmap yang digunakan kerangka kerja untuk penanda docking pintar yang disorot.

Keterangan

Kerangka kerja menangani penanda docking pintar secara internal. Ilustrasi berikut menunjukkan penanda docking pintar standar:

Dalam gambar ini, gambar di sebelah kiri menunjukkan penanda docking pintar grup pusat yang tidak mengaktifkan docking ke tab. Gambar di tengah menunjukkan penanda docking cerdas tepi kanan. Gambar di sebelah kanan menunjukkan penanda docking pintar grup pusat yang memang mengaktifkan docking ke tab. Penanda docking pintar grup pusat memiliki bitmap utama dan lima bitmap penanda docking pintar.

Anda dapat menyesuaikan parameter penanda docking pintar berikut:

• Warna. Misalnya, Anda dapat mengganti warna biru penanda dalam gambar dengan warna yang ditentukan pengguna.

• Warna transparansi.

• Offset penanda docking pintar di grup pusat dari batas persegi panjang pembatas.

• Bitmap utama yang mewakili grup pusat.

• Bitmap yang mewakili penanda docking pintar reguler dan disorot.

Ilustrasi berikut menunjukkan contoh penanda docking pintar yang telah dikustomisasi:

Hierarki Warisan

CObject

CSmartDockingInfo

Persyaratan

Header: afxDockingManager.h

CSmartDockingInfo::CopyTo

Menyalin parameter docking pintar saat ini ke dalam objek CSmartDockingInfo yang disediakan.

void CopyTo(CSmartDockingInfo& params);

Parameter

params
[out] Objek jenis CSmartDockingInfo yang diisi dengan parameter docking pintar saat ini.

CSmartDockingInfo::m_bUseThemeColorInShading

Menentukan apakah akan menggunakan warna tema saat ini saat kerangka kerja menampilkan penanda docking pintar.

BOOL m_bUseThemeColorInShading;

Keterangan

Jika TRUE, penanda digambar menggunakan warna tema saat ini; jika tidak, penanda digambar dengan warna biru muda.

Nilai defaultnya adalah FALSE.

CSmartDockingInfo::m_clrBaseBackground

Menentukan warna latar belakang dasar penanda docking pintar.

COLORREF m_clrBaseBackground;

CSmartDockingInfo::m_clrToneDest

Menentukan warna yang akan menggantikan m_clrToneSrc dalam bitmap penanda docking pintar.

COLORREF m_clrToneDest;

Keterangan

Atur nilai ini untuk mengubah warna bitmap penanda secara terprogram. Misalnya, jika Anda ingin mengubah warna penanda standar yang disediakan dengan kerangka kerja, atur nilai ini ke warna yang diinginkan. Secara default, CSmartDockingInfo::m_clrToneSrc diatur ke RGB (61, 123, 241) (warna kemerahan).

Untuk mengubah warna penanda kustom, Anda harus menentukan dan m_clrToneDest m_clrToneSrc.

CSmartDockingInfo::m_clrToneSrc

Menentukan warna bitmap penanda docking pintar.

COLORREF m_clrToneSrc;

Keterangan

Atur nilai ini hanya jika Anda ingin mengganti warna bitmap kustom dengan warna lain. Anda tidak perlu mengatur nilai ini jika Anda mengubah warna penanda standar (kerangka kerja yang disediakan).

Gunakan (COLORREF)-1 untuk membiarkan anggota grup docking pintar kosong.

CSmartDockingInfo::m_clrTransparent

Menentukan warna bitmap penanda docking pintar saat transparan.

COLORREF m_clrTransparent;

Keterangan

Anda harus mengatur nilai ini saat menampilkan penanda kustom dan bitmap kustom dalam grup docking.

CSmartDockingInfo::m_nCentralGroupOffset

Menentukan offset antara grup pusat penanda docking pintar dan batas persegi panjang grup pusat.

int m_nCentralGroupOffset;

Keterangan

Tentukan nilai ini jika Anda ingin mengubah offset default antara penanda kustom dan batas grup pusat penanda docking pintar. Offset default adalah 5 piksel.

CSmartDockingInfo::m_sizeTotal

Menentukan ukuran total persegi panjang pembatas yang mencakup semua penanda dok pintar di grup pusat.

CSize m_sizeTotal;

Keterangan

Atur m_sizeTotal ke ukuran persegi panjang pembatas penanda grup pusat. Anda diharuskan menentukan nilai ini jika Anda menggunakan bitmap kustom untuk penanda.

CSmartDockingInfo::m_uiMarkerBmpResID

Menentukan ID sumber daya bitmap yang digunakan untuk penanda docking pintar kustom yang tidak disorot.

UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];

Keterangan

Isi array ini dengan ID sumber daya bitmap yang mewakili penanda docking pintar. AFX_SD_MARKERS_NUM saat ini didefinisikan sebagai 5. Anda mengisi array sebagai berikut:

params.m_uiMarkerBmpResID[0] = IDB_MARKER_LEFT;
params.m_uiMarkerBmpResID[1] = IDB_MARKER_RIGHT;
params.m_uiMarkerBmpResID[2] = IDB_MARKER_TOP;
params.m_uiMarkerBmpResID[3] = IDB_MARKER_BOTTOM;
params.m_uiMarkerBmpResID[4] = IDB_MARKER_CENTER;

CSmartDockingInfo::m_uiMarkerLightBmpResID

Menentukan ID sumber daya bitmap yang digunakan untuk penanda docking pintar kustom yang disorot.

UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];

Keterangan

Isi array ini dengan ID sumber daya bitmap yang mewakili penanda docking pintar yang disorot. AFX_SD_MARKERS_NUM saat ini didefinisikan sebagai 5. Anda mengisi array sebagai berikut:

params.m_uiMarkerLightBmpResID[0] = IDB_MARKER_LEFT_LIGHT;
params.m_uiMarkerLightBmpResID[1] = IDB_MARKER_RIGHT_LIGHT;
params.m_uiMarkerLightBmpResID[2] = IDB_MARKER_TOP_LIGHT;
params.m_uiMarkerLightBmpResID[3] = IDB_MARKER_BOTTOM_LIGHT;
params.m_uiMarkerLightBmpResID[4] = IDB_MARKER_CENTER_LIGHT;

Lihat juga

Bagan Hierarki
Kelas
Kelas CObject