CSmartDockingInfo osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Meghatározza az intelligens dokkolójelölők megjelenését.

Szemantika

class CSmartDockingInfo : public CObject

Tagok

Nyilvános konstruktorok

Név	Description
CSmartDockingInfo::CSmartDockingInfo	Alapértelmezett konstruktor.

Nyilvános metódusok

Név	Description
CSmartDockingInfo::CopyTo	Másolja az aktuális intelligens dokkolás információparamétereit a megadott CSmartDockingInfo objektumba.

Adattagok

Név	Description
CSmartDockingInfo::m_bUseThemeColorInShading	Megadja, hogy az aktuális színt használja-e, amikor a keretrendszer intelligens dokkolójelölőket jelenít meg.
CSmartDockingInfo::m_clrBaseBackground	Megadja az intelligens dokkolójelölők alap háttérszínét.
CSmartDockingInfo::m_clrToneDest	Megadja az intelligens dokkolójelölő bittérképeken m_clrToneSrc lecserélt színt.
CSmartDockingInfo::m_clrToneSrc	Az intelligens dokkolójelölő bitképeinek színét adja meg.
CSmartDockingInfo::m_clrTransparent	Az intelligens dokkolójelölő bitképeinek színét adja meg transzparens állapotban.
CSmartDockingInfo::m_nCentralGroupOffset	Az intelligens dokkolási jelölők központi csoportjának eltolását adja meg a központi csoport téglalapjának határaitól.
CSmartDockingInfo::m_sizeTotal	A csoport összes intelligens dokkolójelölőjének teljes méretét adja meg.
CSmartDockingInfo::m_uiMarkerBmpResID	Meghatározza a keretrendszer által a kiemelt intelligens dokkolójelölőkhöz használt bitképek erőforrás-azonosítóit.
CSmartDockingInfo::m_uiMarkerLightBmpResID	Meghatározza a keretrendszer által a kiemelt intelligens dokkolójelölőkhöz használt bitképek erőforrás-azonosítóit.

Megjegyzések

A keretrendszer belsőleg kezeli az intelligens dokkolójelölőket. Az alábbi ábrán a szabványos intelligens dokkolójelölők láthatók:

Ebben az ábrán a bal oldali képen egy központi csoport intelligens dokkolási jelölője látható, amely nem rendelkezik engedélyezve a tabulátorhoz való rögzítéssel. A középső képen egy jobb szélű intelligens dokkolási jelölő látható. A jobb oldali képen egy központi csoport intelligens dokkolási jelölője látható, amelyen engedélyezve van a tabulátorhoz való rögzítés. A központi csoport intelligens dokkolójelölőjének fő bitképe és öt intelligens dokkolójelölő bitképe van.

Az intelligens dokkolójelölők alábbi paramétereit testre szabhatja:

• Szín. Az ábrán szereplő jelölők kék színét például bármilyen felhasználó által definiált színre lecserélheti.

• Áttetszőség színe.

• Intelligens dokkolási jelölő eltolása a középső csoportban a határoló téglalap szegélyétől.

• A központi csoportot jelképező fő bitkép.

• A normál és kiemelt intelligens dokkolójelölőket ábrázoló bitképek.

Az alábbi ábrán egy példa látható a testre szabott intelligens dokkolójelölőkre:

Öröklési hierarchia

CObject

CSmartDockingInfo

Requirements

Fejléc: afxDockingManager.h

CSmartDockingInfo::CopyTo

Másolja az aktuális intelligens dokkolási paramétereket a megadott CSmartDockingInfo objektumba.

void CopyTo(CSmartDockingInfo& params);

Paraméterek

params
[kifelé] Olyan típusú CSmartDockingInfo objektum, amely az aktuális intelligens dokkolási paraméterekkel van feltöltve.

CSmartDockingInfo::m_bUseThemeColorInShading

Megadja, hogy az aktuális színt használja-e, amikor a keretrendszer intelligens dokkolójelölőket jelenít meg.

BOOL m_bUseThemeColorInShading;

Megjegyzések

Ha IGAZ, a jelölők az aktuális színnel lesznek rajzolva; ellenkező esetben a jelölők világoskék színnel vannak rajzolva.

Az alapértelmezett érték HAMIS.

CSmartDockingInfo::m_clrBaseBackground

Megadja az intelligens dokkolójelölők alap háttérszínét.

COLORREF m_clrBaseBackground;

CSmartDockingInfo::m_clrToneDest

Megadja az intelligens dokkolójelölő bittérképeken lecserélni m_clrToneSrc kívánt színt.

COLORREF m_clrToneDest;

Megjegyzések

Állítsa be ezt az értéket úgy, hogy programozott módon módosítsa a jelölőbitképek színét. Ha például módosítani szeretné a keretrendszerben megadott szabványos jelölők színét, állítsa ezt az értéket a kívánt színre. Alapértelmezés szerint a CSmartDockingInfo::m_clrToneSrc RGB (61, 123, 241) (kékes szín) értékre van állítva.

Az egyéni jelölők színének módosításához meg kell adnia mind m_clrToneDest a m_clrToneSrckét jelölőt.

CSmartDockingInfo::m_clrToneSrc

Az intelligens dokkolójelölő bitképeinek színét adja meg.

COLORREF m_clrToneSrc;

Megjegyzések

Ezt az értéket csak akkor állítsa be, ha egy egyéni bitkép színét egy másik színre szeretné cserélni. Nem kell ezt az értéket beállítania, ha egy szabványos (keretrendszer által biztosított) jelölő színét módosítja.

Az intelligens dokkolócsoport egy tagjának üresen hagyásához használható (COLORREF)-1 .

CSmartDockingInfo::m_clrTransparent

Az intelligens dokkolójelölő bitképeinek színét adja meg transzparens állapotban.

COLORREF m_clrTransparent;

Megjegyzések

Ezt az értéket akkor kell beállítania, ha egyéni jelölőket és egyéni bitképeket jelenít meg a rögzítési csoportban.

CSmartDockingInfo::m_nCentralGroupOffset

Megadja az intelligens dokkolási jelölők központi csoportja és a központi csoport téglalapjának határai közötti eltolást.

int m_nCentralGroupOffset;

Megjegyzések

Adja meg ezt az értéket, ha módosítani szeretné az egyéni jelölők és az intelligens dokkolójelölők központi csoportjának határai közötti alapértelmezett eltolást. Az alapértelmezett eltolás 5 képpont.

CSmartDockingInfo::m_sizeTotal

Egy határoló téglalap teljes méretét adja meg, amely a központi csoportban található összes intelligens dokkolójelölőt tartalmazza.

CSize m_sizeTotal;

Megjegyzések

Állítsa be m_sizeTotal a középső csoportjelölő határoló téglalapjának méretét. Ezt az értéket akkor kell megadnia, ha egyéni bitképeket használ a jelölőkhöz.

CSmartDockingInfo::m_uiMarkerBmpResID

Meghatározza a nem kiemelt egyéni intelligens dokkolójelölőkhöz használt bitképek erőforrás-azonosítóit.

UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];

Megjegyzések

Töltse ki ezt a tömböt az intelligens dokkolójelölőket képviselő bitképek erőforrás-azonosítóival. AFX_SD_MARKERS_NUM jelenleg 5-ként van definiálva. A tömböt az alábbiak szerint tölti ki:

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

Meghatározza a kiemelt egyéni intelligens dokkolójelölőkhöz használt bittérképek erőforrás-azonosítóit.

UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];

Megjegyzések

Töltse ki ezt a tömböt a kiemelt intelligens dokkolójelölőket képviselő bitképek erőforrás-azonosítóival. AFX_SD_MARKERS_NUM jelenleg 5-ként van definiálva. A tömböt az alábbiak szerint tölti ki:

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;

Lásd még

hierarchiadiagram
osztályok
CObject osztály