CSmartDockingInfo – třída
Definuje vzhled inteligentních dokovacích značek.
Syntaxe
class CSmartDockingInfo : public CObject
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Výchozí konstruktor. |
Veřejné metody
| Název | Popis |
|---|---|
| CSmartDockingInfo::CopyTo | Zkopíruje aktuální inteligentní dokovací parametry do zadaného objektu CSmartDockingInfo . |
Datové členy
| Název | Popis |
|---|---|
| CSmartDockingInfo::m_bUseThemeColorInShading | Určuje, jestli se má použít aktuální barva motivu, když architektura zobrazuje inteligentní dokovací značky. |
| CSmartDockingInfo::m_clrBaseBackground | Určuje základní barvu pozadí inteligentních dokovacích značek. |
| CSmartDockingInfo::m_clrToneDest | Určuje barvu, která nahrazuje rastrové m_clrToneSrc obrázky inteligentních dokovacích značek. |
| CSmartDockingInfo::m_clrToneSrc | Určuje barvu rastrových obrázků inteligentních dokovacích značek. |
| CSmartDockingInfo::m_clrTransparent | Určuje barvu rastrových obrázků inteligentních dokovacích značek, pokud jsou průhledné. |
| CSmartDockingInfo::m_nCentralGroupOffset | Určuje posun centrální skupiny inteligentních dokovacích značek od hranic obdélníku centrální skupiny. |
| CSmartDockingInfo::m_sizeTotal | Určuje celkovou velikost všech inteligentních dokovacích značek ve skupině. |
| CSmartDockingInfo::m_uiMarkerBmpResID | Definuje ID prostředků rastrových obrázků, které architektura používá pro inteligentní dokovací značky, které nejsou zvýrazněny. |
| CSmartDockingInfo::m_uiMarkerLightBmpResID | Definuje ID prostředků rastrových obrázků, které architektura používá pro inteligentní dokovací značky, které jsou zvýrazněny. |
Poznámky
Architektura zpracovává inteligentní dokovací značky interně. Následující obrázek znázorňuje standardní značky inteligentního ukotvení:
Na tomto obrázku obrázek na levé straně zobrazuje značku inteligentního dokování centrální skupiny, která nemá povolené ukotvení na kartě. Obrázek uprostřed znázorňuje značku inteligentního dokování pravého okraje. Obrázek na pravé straně ukazuje značku inteligentního dokování centrální skupiny, která má povolené ukotvení na kartě. Značka inteligentního dokování centrální skupiny má hlavní rastrový obrázek a pět rastrových obrázků inteligentních dokovacích značek.
Můžete přizpůsobit následující parametry inteligentních dokovacích značek:
Barva. Modrou barvu značek na obrázku můžete například nahradit libovolnou uživatelsky definovanou barvou.
Barva průhlednosti
Odsazení inteligentní značky ukotvení v centrální skupině od ohraničení ohraničujícího obdélníku
Hlavní rastrový obrázek, který představuje centrální skupinu.
Rastrové obrázky, které představují běžné a zvýrazněné inteligentní dokovací značky.
Následující obrázek ukazuje příklad značky inteligentního ukotvení, které byly upraveny:
Hierarchie dědičnosti
Požadavky
Hlavička: afxDockingManager.h
CSmartDockingInfo::CopyTo
Zkopíruje aktuální inteligentní dokovací parametry do zadaného objektu CSmartDockingInfo .
void CopyTo(CSmartDockingInfo& params);
Parametry
params
[ven] Objekt typu CSmartDockingInfo naplněný aktuálními inteligentními dokovacími parametry.
CSmartDockingInfo::m_bUseThemeColorInShading
Určuje, jestli se má použít aktuální barva motivu, když architektura zobrazuje inteligentní dokovací značky.
BOOL m_bUseThemeColorInShading;
Poznámky
Pokud je pravda, značky jsou vykresleny pomocí aktuální barvy motivu; jinak jsou značky kresleny světle modrou barvou.
Výchozí hodnota je FALSE.
CSmartDockingInfo::m_clrBaseBackground
Určuje základní barvu pozadí inteligentních dokovacích značek.
COLORREF m_clrBaseBackground;
CSmartDockingInfo::m_clrToneDest
Určuje barvu, která nahradí m_clrToneSrc rastrové obrázky inteligentních dokovacích značek.
COLORREF m_clrToneDest;
Poznámky
Nastavte tuto hodnotu tak, aby se barva rastrových obrázků značek změnila programově. Pokud například chcete změnit barvu standardních značek poskytovaných architekturou, nastavte tuto hodnotu na požadovanou barvu. Ve výchozím nastavení je CSmartDockingInfo::m_clrToneSrc nastaven na RGB (61, 123, 241) (modravá barva).
Chcete-li změnit barvu vlastních značek, je nutné zadat obě m_clrToneDest a m_clrToneSrc.
CSmartDockingInfo::m_clrToneSrc
Určuje barvu rastrových obrázků inteligentních dokovacích značek.
COLORREF m_clrToneSrc;
Poznámky
Tuto hodnotu nastavte pouze v případě, že chcete nahradit barvu vlastního rastrového obrázku jinou barvou. Tuto hodnotu nemusíte nastavovat, pokud měníte barvu standardní značky (poskytnuté architektury).
Umožňuje (COLORREF)-1 ponechat člena inteligentní dokovací skupiny prázdné.
CSmartDockingInfo::m_clrTransparent
Určuje barvu rastrových obrázků inteligentních dokovacích značek, pokud jsou průhledné.
COLORREF m_clrTransparent;
Poznámky
Tuto hodnotu je nutné nastavit při zobrazení vlastních značek a vlastních rastrových obrázků ve skupině ukotvení.
CSmartDockingInfo::m_nCentralGroupOffset
Určuje posun mezi centrální skupinou inteligentních dokovacích značek a hranicemi obdélníku centrální skupiny.
int m_nCentralGroupOffset;
Poznámky
Tuto hodnotu zadejte, pokud chcete změnit výchozí posun mezi vlastními značkami a hranicemi centrální skupiny inteligentních dokovacích značek. Výchozí posun je 5 pixelů.
CSmartDockingInfo::m_sizeTotal
Určuje celkovou velikost ohraničujícího obdélníku, který uzavře všechny inteligentní dokovací značky v centrální skupině.
CSize m_sizeTotal;
Poznámky
Nastavte m_sizeTotal velikost ohraničujícího obdélníku centrální značky skupiny. Tuto hodnotu musíte zadat, pokud pro značky používáte vlastní rastrové obrázky.
CSmartDockingInfo::m_uiMarkerBmpResID
Definuje ID prostředků rastrových obrázků, které se používají pro nezvýrazněné vlastní značky inteligentního ukotvení.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Poznámky
Vyplňte toto pole ID prostředků rastrových obrázků představujících inteligentní dokovací značky. AFX_SD_MARKERS_NUM je aktuálně definován jako 5. Pole vyplníte následujícím způsobem:
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
Definuje ID prostředků rastrových obrázků, které se používají pro zvýrazněné vlastní značky inteligentního ukotvení.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Poznámky
Vyplňte toto pole ID prostředků rastrových obrázků představujících zvýrazněné inteligentní dokovací značky. AFX_SD_MARKERS_NUM je aktuálně definován jako 5. Pole vyplníte následujícím způsobem:
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;