Klasa CSmartDockingInfo
Definiuje wygląd inteligentnych znaczników dokowania.
Składnia
class CSmartDockingInfo : public CObject
Elementy członkowskie
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:
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:
Hierarchia dziedziczenia
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_clrToneDest m_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;