CSmartDockingInfo 類別
定義智慧停駐標記的外觀。
語法
class CSmartDockingInfo : public CObject
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
預設建構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CSmartDockingInfo：：CopyTo | 將目前的智慧停駐資訊參數複製到提供的 CSmartDockingInfo 物件中。 |
資料成員
| 名稱 | 描述 |
|---|---|
| CSmartDockingInfo：：m_bUseThemeColorInShading | 指定當架構顯示智慧停駐標記時，是否要使用目前的主題色彩。 |
| CSmartDockingInfo：：m_clrBaseBackground | 指定智慧停駐標記的基底背景色彩。 |
| CSmartDockingInfo：：m_clrToneDest | 指定智慧停駐標記點陣圖中取代 m_clrToneSrc 的色彩。 |
| CSmartDockingInfo：：m_clrToneSrc | 指定智慧停駐標記點圖的色彩。 |
| CSmartDockingInfo：：m_clrTransparent | 指定智慧停駐標記點圖在透明時的顏色。 |
| CSmartDockingInfo：：m_nCentralGroupOffset | 從中央群組矩形的界限指定智慧停駐標記中央群組的位移。 |
| CSmartDockingInfo：：m_sizeTotal | 指定群組中所有智慧停駐標記的總大小。 |
| CSmartDockingInfo：：m_uiMarkerBmpResID | 定義架構用於未醒目提示之智慧停駐標記的點陣圖資源標識碼。 |
| CSmartDockingInfo：：m_uiMarkerLightBmpResID | 定義架構針對醒目提示之智慧停駐標記所使用的點陣圖資源標識碼。 |
備註
架構會在內部處理智慧停駐標記。 下圖顯示標準智慧停駐標記：
在此圖中，左側影像會顯示中央群組智慧停駐標記，該標記未啟用索引卷標。 中間的影像顯示右邊緣智慧停駐標記。 右邊的影像顯示中央群組智慧停駐標記，其已啟用定位點。 中央群組智慧停駐標記具有主要點圖和五個智慧停駐標記位圖。
您可以自訂下列智慧停駐標記的參數：
色彩。 例如，您可以將圖形中標記的藍色取代為任何使用者定義的色彩。
透明度色彩。
中央群組中智慧停駐標記的位移，從周框的框線。
代表中央群組的主要點陣圖。
代表一般和反白顯示智慧停駐標記的點陣圖。
下圖顯示已自訂的智慧停駐標記範例：
繼承階層架構
需求
標頭： afxDockingManager.h
CSmartDockingInfo：：CopyTo
將目前的智慧停駐參數複製到提供的 CSmartDockingInfo 物件中。
void CopyTo(CSmartDockingInfo& params);
參數
params
[out]型 CSmartDockingInfo 別的物件，已填入目前的智慧停駐參數。
CSmartDockingInfo：：m_bUseThemeColorInShading
指定當架構顯示智慧停駐標記時，是否要使用目前的主題色彩。
BOOL m_bUseThemeColorInShading;
備註
如果為TRUE，則會使用目前的主題色彩繪製標記;否則，標記會以淺藍色繪製。
預設值為 FALSE。
CSmartDockingInfo：：m_clrBaseBackground
指定智慧停駐標記的基底背景色彩。
COLORREF m_clrBaseBackground;
CSmartDockingInfo：：m_clrToneDest
指定將在智慧停駐標記點陣圖中取代 m_clrToneSrc 的色彩。
COLORREF m_clrToneDest;
備註
設定此值以程式設計方式變更標記點圖的色彩。 例如，如果您想要變更架構所提供的標準標記色彩，請將此值設定為所需的色彩。 根據預設， CSmartDockingInfo：：m_clrToneSrc 會設定為 RGB （61， 123， 241） （藍色）。
若要變更自訂標記的色彩，您必須同時指定 m_clrToneDest 和 m_clrToneSrc。
CSmartDockingInfo：：m_clrToneSrc
指定智慧停駐標記點圖的色彩。
COLORREF m_clrToneSrc;
備註
只有當您想要以另一種色彩取代自定義點陣圖的色彩時，才設定此值。 如果您要變更標準 （Framework 提供的） 標記的色彩，則不需要設定此值。
使用 (COLORREF)-1 將智慧停駐群組的成員保留空白。
CSmartDockingInfo：：m_clrTransparent
指定智慧停駐標記點圖在透明時的顏色。
COLORREF m_clrTransparent;
備註
當您在停駐群組中顯示自定義標記和自定義點陣圖時，必須設定此值。
CSmartDockingInfo：：m_nCentralGroupOffset
指定智慧停駐標記中央群組與中央群組矩形界限之間的位移。
int m_nCentralGroupOffset;
備註
如果您想要變更自定義標記與智慧停駐標記中央群組界限之間的預設位移，請指定此值。 預設位移為 5 像素。
CSmartDockingInfo：：m_sizeTotal
指定周框的總大小，這個矩形會封入中央群組中的所有智慧停駐標記。
CSize m_sizeTotal;
備註
設定 m_sizeTotal 為中央群組標記周框的大小。 如果您使用標記的自定義點陣圖，則必須指定此值。
CSmartDockingInfo：：m_uiMarkerBmpResID
定義用於非醒目提示自定義智慧停駐標記之位圖的資源標識碼。
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
備註
以代表智慧停駐標記的點陣圖資源標識元填入此數位。 AFX_SD_MARKERS_NUM目前定義為 5。 您可以填入陣列，如下所示：
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
定義用於醒目提示自定義智慧停駐標記之位圖的資源標識碼。
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
備註
將此陣列填入代表醒目提示智慧停駐標記之點陣圖的資源識別碼。 AFX_SD_MARKERS_NUM目前定義為 5。 您可以填入陣列，如下所示：
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;