嵌入式管理單元物件巨集

發行項
08/03/2024

這些宏提供嵌入式管理單元延伸模組的支援。

名稱	描述
BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP	標記 Snap-In 物件的嵌入式管理單元延伸模組數據類別對應開頭。
BEGIN_SNAPINTOOLBARID_MAP	標記嵌入式管理單元物件的工具列對應開頭。
END_EXTENSION_SNAPIN_NODEINFO_MAP	標記 Snap-In 物件的嵌入式管理單元延伸模組數據類別對應結尾。
END_SNAPINTOOLBARID_MAP	標記嵌入式管理單元物件的工具列對應結尾。
EXTENSION_SNAPIN_DATACLASS	為嵌入式管理單元延伸模組的數據類別建立數據成員。
EXTENSION_SNAPIN_NODEINFO_ENTRY	在 Snap-In 物件的嵌入式管理單元延伸模組數據類別對應中輸入嵌入式管理單元數據類別。
SNAPINMENUID	宣告嵌入式管理單元物件所使用之操作功能表的標識碼。
SNAPINTOOLBARID_ENTRY	在嵌入式管理單元物件的工具列對應中輸入工具列。

需求

標頭： atlsnap.h

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

標記嵌入式管理單元延伸模組數據類別對應的開頭。

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(classname)

參數

classname
[in]嵌入式管理單元延伸模組數據類別的名稱。

備註

使用BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP 巨集啟動嵌入式管理單元延伸模塊對應、使用EXTENSION_SNAPIN_NODEINFO_ENTRY巨集新增每個嵌入式管理單元數據類型的專案，並使用END_EXTENSION_SNAPIN_NODEINFO_MAP巨集完成地圖。

範例

class CMyExtSnapinExtData : 
   public CSnapInItemImpl<CMyExtSnapinExtData>,
   public CMySnapinBase
{
public:
   CMyExtSnapinExtData() {}
};

class CMyExtSnapin : 
   public CComObjectRoot,
   public CSnapInObjectRoot<1, CMyExtSnapin>,
   public IComponentDataImpl<CMyExtSnapin, CMyExtSnapin>
{
public:
   CMyExtSnapin() {}

   BEGIN_COM_MAP(CMyExtSnapin)
   END_COM_MAP()

   EXTENSION_SNAPIN_DATACLASS(CMyExtSnapinExtData)

   BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(CMyExtSnapin)
      EXTENSION_SNAPIN_NODEINFO_ENTRY(CMyExtSnapinExtData)
   END_EXTENSION_SNAPIN_NODEINFO_MAP()
};

BEGIN_SNAPINTOOLBARID_MAP

宣告嵌入式管理單元物件的工具列標識碼對應開頭。

BEGIN_SNAPINTOOLBARID_MAP(_class)

參數

_類
[in]指定 Snap-In 物件類別。

範例

class CMySnapinData : 
   public CSnapInItemImpl<CMySnapinData>,
   public CMySnapinBase
{
public:
   CMySnapinData() {}

   BEGIN_SNAPINTOOLBARID_MAP(CMySnapinData)
      // IDR_MYSNAPINTOOLBAR is the resource ID of a toolbar resource.
      SNAPINTOOLBARID_ENTRY(IDR_MYSNAPINTOOLBAR)
   END_SNAPINTOOLBARID_MAP()
};

END_EXTENSION_SNAPIN_NODEINFO_MAP

標記嵌入式管理單元數據類別對應的結尾。

END_EXTENSION_SNAPIN_NODEINFO_MAP()

備註

使用BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP巨集啟動嵌入式管理單元對應、使用EXTENSION_SNAPIN_NODEINFO_ENTRY巨集新增每個延伸模組嵌入式管理單元數據類型的專案，並使用END_EXTENSION_SNAPIN_NODEINFO_MAP 巨集完成對應。

範例

請參閱BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP範例。

END_SNAPINTOOLBARID_MAP

宣告嵌入式管理單元物件的工具列標識碼對應結尾。

END_SNAPINTOOLBARID_MAP( _class )

參數

_類
[in]指定 Snap-In 物件類別。

範例

請參閱BEGIN_SNAPINTOOLBARID_MAP範例。

EXTENSION_SNAPIN_DATACLASS

將數據成員加入 ISnapInItemImpl 衍生類別的嵌入式管理單元延伸模組數據類別。

EXTENSION_SNAPIN_DATACLASS(dataClass )

參數

dataClass
[in]嵌入式管理單元延伸模組的數據類別。

備註

此類別也應該輸入嵌入式管理單元數據類別對應。使用BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP巨集啟動嵌入式管理單元數據類別對應、使用 EXTENSION_SNAPIN_NODEINFO_ENTRY巨集新增每個嵌入式管理單元數據類型的專案，並使用END_EXTENSION_SNAPIN_NODEINFO_MAP巨集完成對應。

範例

class CMyExtSnapinExtData : 
   public CSnapInItemImpl<CMyExtSnapinExtData>,
   public CMySnapinBase
{
public:
   CMyExtSnapinExtData() {}
};

class CMyExtSnapin : 
   public CComObjectRoot,
   public CSnapInObjectRoot<1, CMyExtSnapin>,
   public IComponentDataImpl<CMyExtSnapin, CMyExtSnapin>
{
public:
   CMyExtSnapin() {}

   BEGIN_COM_MAP(CMyExtSnapin)
   END_COM_MAP()

   EXTENSION_SNAPIN_DATACLASS(CMyExtSnapinExtData)

   BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(CMyExtSnapin)
      EXTENSION_SNAPIN_NODEINFO_ENTRY(CMyExtSnapinExtData)
   END_EXTENSION_SNAPIN_NODEINFO_MAP()
};

EXTENSION_SNAPIN_NODEINFO_ENTRY

將嵌入式管理單元延伸模組數據類別新增至嵌入式管理單元數據類別對應。

EXTENSION_SNAPIN_NODEINFO_ENTRY( dataClass )

參數

dataClass
[in]嵌入式管理單元延伸模組的數據類別。

備註

使用BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP巨集啟動嵌入式管理單元數據類別對應、使用EXTENSION_SNAPIN_NODEINFO_ENTRY 巨集新增每個嵌入式管理單元延伸模組數據類型的專案，並使用END_EXTENSION_SNAPIN_NODEINFO_MAP巨集完成對應。

範例

請參閱BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP範例。

SNAPINMENUID

使用此巨集來宣告 Snap-In 物件的操作功能表資源。

SNAPINMENUID( id )

參數

id
[in]識別嵌入式管理單元物件的操作功能表。

SNAPINTOOLBARID_ENTRY

使用此巨集，即可在嵌入式管理單元物件的工具列標識碼對應中輸入工具列標識碼。

SNAPINTOOLBARID_ENTRY( id )

參數

id
[in]識別工具列控制件。

備註

BEGIN_SNAPINTOOLBARID_MAP巨集標記工具列標識碼對應的開頭;END_SNAPINTOOLBARID_MAP巨集標記結尾。

範例