Sdílet prostřednictvím


CSmartDockingInfo – třída

Definuje vzhled inteligentních dokovacích značek.

Syntaxe

class CSmartDockingInfo : public CObject

Členové

Veřejné konstruktory

Jméno popis
CSmartDockingInfo::CSmartDockingInfo Výchozí konstruktor.

Veřejné metody

Jméno popis
CSmartDockingInfo::CopyTo Zkopíruje aktuální inteligentní dokovací parametry do zadaného objektu CSmartDockingInfo .

Datové členy

Jméno 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í:

Standard markers for smart docking.

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:

  • Barev. 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:

Custom markers for smart docking.

Hierarchie dědičnosti

Objekt CObject

CSmartDockingInfo

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;

Viz také

Graf hierarchie
Třídy
CObject – třída