Klasa CSmartDockingInfo

Definiuje wygląd inteligentnych znaczników dokowania.

Składnia

class CSmartDockingInfo : public CObject

Członkowie

Konstruktory publiczne

Nazwa/nazwisko opis
CSmartDockingInfo::CSmartDockingInfo Konstruktor domyślny.

Metody publiczne

Nazwa/nazwisko opis
CSmartDockingInfo::CopyTo Kopiuje bieżące parametry informacji o zadokowaniu inteligentnym do udostępnionego obiektu CSmartDockingInfo .

Składowe danych

Nazwa/nazwisko opis
CSmartDockingInfo::m_bUseThemeColorInShading Określa, czy używać bieżącego koloru motywu, gdy platforma wyświetla znaczniki inteligentnego dokowania.
CSmartDockingInfo::m_clrBaseBackground Określa podstawowy kolor tła inteligentnych znaczników dokowania.
CSmartDockingInfo::m_clrToneDest Określa kolor, który zastępuje m_clrToneSrc się w inteligentnych mapach bitowych znacznika dokowania.
CSmartDockingInfo::m_clrToneSrc Określa kolor inteligentnych map bitowych znacznika dokowania.
CSmartDockingInfo::m_clrTransparent Określa kolor map bitowych znacznika dokowania inteligentnego, gdy są przezroczyste.
CSmartDockingInfo::m_nCentralGroupOffset Określa przesunięcie centralnej grupy inteligentnych znaczników dokowania z granic prostokąta grupy centralnej.
CSmartDockingInfo::m_sizeTotal Określa całkowity rozmiar wszystkich znaczników dokowania inteligentnego w grupie.
CSmartDockingInfo::m_uiMarkerBmpResID Definiuje identyfikatory zasobów map bitowych używanych przez platformę do inteligentnych znaczników dokowania, które nie są wyróżnione.
CSmartDockingInfo::m_uiMarkerLightBmpResID Definiuje identyfikatory zasobów map bitowych używanych przez platformę do inteligentnych znaczników dokowania wyróżnionych.

Uwagi

Struktura obsługuje inteligentne znaczniki dokowania wewnętrznie. Na poniższej ilustracji przedstawiono standardowe znaczniki inteligentnego dokowania:

Standard markers for smart docking.

Na tym rysunku obraz po lewej stronie przedstawia centralny znacznik inteligentnego dokowania grupy, który nie ma włączonego dokowania do karty. Obraz w środku przedstawia znacznik inteligentnego dokowania krawędzi prawej. Obraz po prawej stronie przedstawia centralny znacznik dokowania inteligentnego grupy, który ma włączone dokowanie do karty. Centralny znacznik dokowania inteligentnego grupy ma główną mapę bitową i pięć inteligentnych map bitowych znacznika dokowania.

Możesz dostosować następujące parametry znaczników inteligentnego dokowania:

  • Kolor. Można na przykład zastąpić niebieski kolor znaczników na rysunku dowolnym kolorem zdefiniowanym przez użytkownika.

  • Kolor przezroczystości.

  • Przesunięcie inteligentnego znacznika dokowania w grupie centralnej z obramowania prostokąta ograniczenia.

  • Główna mapa bitowa reprezentująca grupę centralną.

  • Mapy bitowe reprezentujące zwykłe i wyróżnione inteligentne znaczniki dokowania.

Na poniższej ilustracji przedstawiono przykład inteligentnych znaczników dokowania, które zostały dostosowane:

Custom markers for smart docking.

Hierarchia dziedziczenia

Cobject

CSmartDockingInfo

Wymagania

Nagłówek: afxDockingManager.h

CSmartDockingInfo::CopyTo

Kopiuje bieżące parametry inteligentnego dokowania do udostępnionego obiektu CSmartDockingInfo .

void CopyTo(CSmartDockingInfo& params);

Parametry

params
[out] Obiekt typu CSmartDockingInfo wypełniony bieżącymi parametrami inteligentnego dokowania.

CSmartDockingInfo::m_bUseThemeColorInShading

Określa, czy używać bieżącego koloru motywu, gdy platforma wyświetla znaczniki inteligentnego dokowania.

BOOL m_bUseThemeColorInShading;

Uwagi

Jeśli wartość TRUE, znaczniki są rysowane przy użyciu bieżącego koloru motywu; w przeciwnym razie znaczniki są rysowane z jasnoniebieskim kolorem.

Wartość domyślna to FALSE.

CSmartDockingInfo::m_clrBaseBackground

Określa podstawowy kolor tła inteligentnych znaczników dokowania.

COLORREF m_clrBaseBackground;

CSmartDockingInfo::m_clrToneDest

Określa kolor, który zastąpi m_clrToneSrc w inteligentnych mapach bitowych znacznika dokowania.

COLORREF m_clrToneDest;

Uwagi

Ustaw tę wartość, aby programowo zmienić kolor map bitowych znacznika. Jeśli na przykład chcesz zmienić kolor standardowych znaczników dostarczonych ze strukturą, ustaw tę wartość na żądany kolor. Domyślnie CSmartDockingInfo ::m_clrToneSrc jest ustawiona na RGB (61, 123, 241) (kolor bluish).

Aby zmienić kolor znaczników niestandardowych, należy określić wartości i m_clrToneDestm_clrToneSrc.

CSmartDockingInfo::m_clrToneSrc

Określa kolor inteligentnych map bitowych znacznika dokowania.

COLORREF m_clrToneSrc;

Uwagi

Ustaw tę wartość tylko wtedy, gdy chcesz zamienić kolor niestandardowej mapy bitowej na inny kolor. Nie musisz ustawiać tej wartości, jeśli zmieniasz kolor znacznika standardowego (dostarczonej struktury).

Użyj polecenia (COLORREF)-1 , aby pozostawić członka grupy inteligentnego dokowania puste.

CSmartDockingInfo::m_clrTransparent

Określa kolor map bitowych znacznika dokowania inteligentnego, gdy są przezroczyste.

COLORREF m_clrTransparent;

Uwagi

Tę wartość należy ustawić podczas wyświetlania niestandardowych znaczników i niestandardowych map bitowych w grupie dokowania.

CSmartDockingInfo::m_nCentralGroupOffset

Określa przesunięcie między centralną grupą inteligentnych znaczników dokowania a granicami prostokąta grupy centralnej.

int m_nCentralGroupOffset;

Uwagi

Określ tę wartość, jeśli chcesz zmienić domyślne przesunięcie między znacznikami niestandardowymi a granicami centralnej grupy znaczników dokowania inteligentnego. Domyślne przesunięcie to 5 pikseli.

CSmartDockingInfo::m_sizeTotal

Określa całkowity rozmiar prostokąta ograniczenia, który otacza wszystkie znaczniki dokowania inteligentnego w grupie centralnej.

CSize m_sizeTotal;

Uwagi

Ustaw m_sizeTotal rozmiar prostokąta ograniczenia centralnego znacznika grupy. Ta wartość jest wymagana, jeśli używasz niestandardowych map bitowych dla znaczników.

CSmartDockingInfo::m_uiMarkerBmpResID

Definiuje identyfikatory zasobów map bitowych, które są używane na potrzeby niestandardowych znaczników inteligentnego dokowania.

UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];

Uwagi

Wypełnij tę tablicę identyfikatorami zasobów map bitowych reprezentującymi znaczniki inteligentnego dokowania. AFX_SD_MARKERS_NUM jest obecnie definiowana jako 5. Tablicę należy wypełnić w następujący sposób:

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

Definiuje identyfikatory zasobów map bitowych, które są używane do wyróżnionych niestandardowych znaczników dokowania inteligentnego.

UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];

Uwagi

Wypełnij tę tablicę identyfikatorami zasobów map bitowych reprezentującymi wyróżnione znaczniki inteligentnego dokowania. AFX_SD_MARKERS_NUM jest obecnie definiowana jako 5. Tablicę należy wypełnić w następujący sposób:

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;

Zobacz też

Wykres hierarchii
Klasy
Klasa CObject