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	定義架構針對醒目提示之智慧停駐標記所使用的點陣圖資源識別碼。

備註

架構會在內部處理智慧停駐標記。 下圖顯示標準智慧停駐標記：

在此圖中，左側影像會顯示中央群組智慧停駐標記，該標記未啟用索引標籤。 中間的影像顯示右邊緣智慧停駐標記。 右邊的影像顯示中央群組智慧停駐標記，其已啟用定位點。 中央群組智慧停駐標記具有主要點陣圖和五個智慧停駐標記點陣圖。

您可以自訂下列智慧停駐標記的參數：

• 色彩。 例如，您可以將圖形中標記的藍色取代為任何使用者定義的色彩。

• 透明度色彩。

• 中央群組中智慧停駐標記的位移，從周框的框線。

• 代表中央群組的主要點陣圖。

• 代表一般和反白顯示智慧停駐標記的點陣圖。

下圖顯示已自訂的智慧停駐標記範例：

繼承階層架構

CObject

CSmartDockingInfo

需求

標頭： 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;

另請參閱

階層架構圖表
類別
CObject 類別