ATL Macros Alphabetical Reference

在 區段中, ATL 巨集的參考主題是依字母順序排列的。 若要依分類尋找特定巨集,請參閱 ATL 巨集

巨集

描述

_ATL_ALL_WARNINGS

啟用專案的錯誤的符號 ATL 舊版呈現。

_ATL_APARTMENT_THREADED

如果第一個或更多的物件使用 Apartment 執行緒,請定義。

_ATL_CSTRING_EXPLICIT_CONSTRUCTORS

判斷 CString 建構函式明確,防止所有不預期的轉換。

_ATL_DEBUG_INTERFACES

先前已定義這個巨集包含所有 ATL 標頭檔追蹤您的元件介面的所有 AddRef版本 呼叫至輸出視窗。

_ATL_DEBUG_QI

QueryInterface 撰寫所有呼叫至輸出視窗。

_ATL_FREE_THREADED

如果第一個或更多的物件使用中性或無限制執行緒,請定義。

_ATL_MIXED

可讓編譯器知道您的 ATL 應用程式包括原生和 /clr 編譯單位。

_ATL_MULTI_THREADED

表示專案中的符號將會被標記為和的物件,選擇性或中性。 巨集 _ATL_FREE_THREADED 應用於新的程式碼。

_ATL_NO_COM_SUPPORT

防止 COM 相關程式碼編譯專案的符號。

_ATL_NO_AUTOMATIC_NAMESPACE

防止對命名空間的預設會使用為 ATL 的符號。

_ATL_NO_VARIANT_THROW

隱藏擲回之例外狀況的 CComVariant Class

_ATL_SECURE_NO_WARNINGS

隱藏編譯器警告會使用已取代的 ATL 函式。

_ATL_STATIC_REGISTRY

符號指出您希望物件的註冊程式碼是避免在 ATL.DLL 具有相依性的物件。

_ATLCATCH

處理錯誤的陳述式會在關聯的 _ATLTRY

_ATLCATCHALL

處理錯誤的陳述式會在關聯的 _ATLTRY

_ATLTRY

標記錯誤可能會發生的受保護的程式碼部分。

ATL_ESC 旗標。

這些旗標可用來控制 EscapeXML行為。

ALT_MSG_MAP

標記中使用一個替代的訊息對應的開頭。

ATL 和 MFC 字串轉換巨集

字串轉換巨集則為 ATL 和 MFC。

ATLASSERT

ATLASSERT 巨集執行相同 _ASSERTE 巨集在 C 執行階段程式庫中找到的功能。

ATL_NOINLINE

表示函式的符號不應該內嵌。

ATL_NO_VTABLE

在類別的建構函式和解構函式 (Destructor) 避免 vtable 指標初始化的符號。

ATL_URL Flags

這些旗標修改 AtlEscapeUrlAtlCanonicalizeUrl行為。

ATL_URL_SCHEME

這個列舉型別的成員。 卷毛了解配置提供常數。

ATL_WORKER_THREAD_WAIT

這個巨集以毫秒定義預設值 CWorkerThread::Shutdown 等待背景工作執行緒關閉。

ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT

這個巨集以毫秒定義預設時間 CThreadPool 會等候執行緒關閉。

ATLS_DEFAULT_THREADSPERPROC

這個巨集定義執行緒的預設數目每個 CThreadPool使用的處理器。

ATLSMTP_QPENCODE 旗標。

這些旗標描述引號可列印的編碼方式。 QPEncode執行。

ATLSMTP_UUENCODE 旗標。

這些旗標的描述 uuencoding 方式。 UUEncode執行。

ATLTRACE

警告移到另一組輸出裝置報告,例如偵錯工具視窗,根據所指示的旗標和層級。 為了回溯相容性 (Backward Compatibility)。

ATLTRA CE2

警告移到另一組輸出裝置報告,例如偵錯工具視窗,根據所指示的旗標和層級。

ATLTRACENOTIMPL

在偵錯 ATL 建置,傳送字串「funcname 未實作」傾印至裝置而傳回 E_NOTIMPL

BEGIN_CATEGORY_MAP

標記導覽分類的開頭。

BEGIN_COM_MAP

COM 對應是透過 QueryInterface公開物件的介面對用戶端的機制。

BEGIN_CONNECTION_POINT_MAP

標記連接點對應項目的開頭。

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

標記嵌入式管理單元的擴充功能資料類別對應的開頭。

BEGIN_MSG_MAP

標記預設的訊息對應的開頭。

BEGIN_PROP_MAP

物件的標記屬性對應的開頭。

BEGIN_RDX_MAP

這個標記會註冊資料交換對應的開頭。

BEGIN_SERVICE_MAP

標記導覽服務的開頭。

BEGIN_SINK_MAP

宣告事件接收對應的開頭複合控制項的。

BEGIN_SNAPINTOOLBARID_MAP

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

CHAIN_MSG_MAP

定義在訊息對應的項目。

CHAIN_MSG_MAP_ALT

定義在訊息對應的項目。

CHAIN_MSG_MAP_ALT_MEMBER

定義在訊息對應的項目。

CHAIN_MSG_MAP_DYNAMIC

定義在訊息對應的項目。

CHAIN_MSG_MAP_MEMBER

定義在訊息對應的項目。

COM_INTERFACE_ENTRY 巨集

這些巨集輸入物件的介面輸入它的 COM 對應,以供 QueryInterface存取。

COM_INTERFACE_ENTRY

輸入介面的 COM 介面對應。

COM_INTERFACE_ENTRY2

使用這個巨集會區分繼承自兩個分支。

COM_INTERFACE_ENTRY2_IID

COM_INTERFACE_ENTRY2,不過,您可以指定不同的 IID。

COM_INTERFACE_ENTRY_AGGREGATE

當 iid 判斷的介面來查詢,會 punk的 COM_INTERFACE_ENTRY_AGGREGATE 轉送。

COM_INTERFACE_ENTRY_AGGREGATE_BLIND

COM_INTERFACE_ENTRY_AGGREGATE,不過,查詢在順向查詢的任何 IID 結果的效果相同。 punk。

COM_INTERFACE_ENTRY_AUTOAGGREGATE

COM_INTERFACE_ENTRY_AGGREGATE相同,不過,如果 punk 是 NULL,就會自動建立 clsid描述的彙總。

COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND

COM_INTERFACE_ENTRY_AUTOAGGREGATE,但是有一點例外,就是查詢任何 IID 的相同導致轉送至查詢 punk,而且,如果是 punkNULL,自動建立 clsid描述的彙總。

COM_INTERFACE_ENTRY_BREAK

在指定的介面上查詢時,會造成程式呼叫 DebugBreak

COM_INTERFACE_ENTRY_CACHED_TEAR_OFF

儲存使用者專屬的每個執行個體的資料。

COM_INTERFACE_ENTRY_CHAIN

表示處理到達 COM 對應時,這個項目的處理基底類別的 COM 對應。

COM_INTERFACE_ENTRY_FUNC

攔截到 ATL 的 QueryInterface 邏輯的一般機制。

COM_INTERFACE_ENTRY_FUNC_BLIND

COM_INTERFACE_ENTRY_FUNC,不過,查詢在呼叫的任何 IID 結果的效果相同。 func。

COM_INTERFACE_ENTRY_IID

使用這個巨集輸入至 COM 介面對應並指定它的 IID。

COM_INTERFACE_ENTRY_NOINTERFACE

在指定的介面上查詢時,會傳回 E_NOINTERFACE 並結束處理 COM 對應。

COM_INTERFACE_ENTRY_TEAR_OFF

公開 (Expose) Tear-Off 介面。

COMMAND_CODE_HANDLER

與類似,但是會對應 COMMAND_HANDLER,以通知程式碼只會 WM_COMMAND 訊息。

COMMAND_HANDLER

定義在訊息對應的項目。

COMMAND_ID_HANDLER

與類似,但是會對應 COMMAND_HANDLER,根據功能表項目、控制項或快速鍵 (Accelerator) 識別項只會 WM_COMMAND 訊息。

COMMAND_RANGE_CODE_HANDLER

與類似,但 COMMAND_RANGE_HANDLER,對應 WM_COMMAND 訊息與特定通知程式碼從控制項的範圍是單一處理常式中運作。

COMMAND_RANGE_HANDLER

與類似,但 COMMAND_HANDLER,對應 WM_COMMAND 訊息從控制項的範圍是單一處理常式中運作。

CONNECTION_POINT_ENTRY

編碼指定的介面的連接點的連接點對應,才能存取。

DECLARE_AGGREGATABLE

指定您的物件可彙總。

DECLARE_CLASSFACTORY

宣告 CComClassFactory 是 Class Factory。

DECLARE_ CLASSFACTORY2

宣告 CComClassFactory2 是 Class Factory。

DECLARE_CLASSFACTORY_AUTO_THREAD

宣告 CComClassFactoryAutoThread 是 Class Factory。

DECLARE_CLASSFACTORY_EX

宣告 cf 是 Class Factory。

DECLARE_CLASSFACTORY_SINGLETON

宣告 CComClassFactorySingleton 是 Class Factory。

DECLARE_EMPTY_MSG_MAP

宣告一個空的訊息對應。

DECLARE_GET_CONTROLLING_UNKNOWN

宣告虛擬函式 GetControllingUnknown

DECLARE_LIBID

提供 ATL 提供衍生這個型別程式庫的 libid

DECLARE_NO_REGISTRY

請使用 DECLARE_NO_REGISTRY ,如果要避免這個巨集顯示的任何類別的預設 ATL 註冊。

DECLARE_NOT_AGGREGATABLE

指定您的物件無法彙總。

DECLARE_OBJECT_DESCRIPTION

可讓您為類別的文字描述。

DECLARE_OLEMISC_STATUS

用於 ATL ActiveX 控制項設定 OLEMISC 旗標。

DECLARE_ONLY_AGGREGATABLE

指定必須彙總您自己的物件。

DECLARE_POLY_AGGREGATABLE

指定 CComPolyObject < x > 執行個體之後,當您建立的物件。

DECLARE_PROTECT_FINAL_CONSTRUCT

保護您的物件遭刪除,如果 (在 FinalConstruct) 內部彙總物件加入參考計數會遞減計數為 0。

DECLARE_REGISTRY

輸入標準類別註冊到系統登錄或從系統登錄中將它移除。

DECLARE_REGISTRY_APPID_RESOURCEID

指定要求的資訊會自動註冊 appid

DECLARE_REGISTRY_RESOURCE

取得含有登錄檔的具名資源和執行指令碼對輸入物件到系統登錄或從系統登錄移除它們。

DECLARE_REGISTRY_RESOURCEID

DECLARE_REGISTRY_RESOURCE 和相同,但是它使用精靈產生的 UINT 識別資源,而不是字串的名稱。

DECLARE_VIEW_STATUS

將這個巨集在 ATL ActiveX 控制項的控制項類別指定 VIEWSTATUS 旗標加入容器。

DECLARE_WND_CLASS

可讓您指定新的視窗類別的名稱。 將這個巨集在 ATL ActiveX 控制項的控制項類別。

DECLARE_WND_CLASS_EX

可讓您指定新的視窗類別現有視窗類別的名稱。 將這個巨集在 ATL ActiveX 控制項的控制項類別。

DECLARE_WND_SUPERCLASS

可讓您指定類別的參數。 將這個巨集在 ATL ActiveX 控制項的控制項類別。

DEFAULT_REFLECTION_HANDLER

會接收反映訊息的子視窗 (控制項) 提供預設處理常式;這個處理常式會適當地傳遞至 DefWindowProc未處理訊息。

DEVMODE 和 TEXTMETRIC 字串轉換巨集

這些巨集建立 DEVMODETEXTMETRIC 結構的複本並且將新結構中的字串傳遞至新的資料型別。

END_CATEGORY_MAP

標記導覽分類的。

END_COM_MAP

關閉您的 COM 介面對應的定義。

END_CONNECTION_POINT_MAP

標記連接點對應項目的結尾。

END_EXTENSION_SNAPIN_NODEINFO_MAP

標記嵌入式管理單元的擴充功能資料類別對應的結束。

END_MSG_MAP

標記訊息對應的結束。

END_PROP_MAP

物件的標記屬性對應的。

END_RDX_MAP

這個標記會註冊資料交換對應的結束。

END_SERVICE_MAP

標記導覽服務的結束。

END_SINK_MAP

宣告事件接收對應的結束複合控制項的。

END_SNAPINTOOLBARID_MAP

宣告工具列 ID 對應的結束嵌入式管理單元的物件的。

EXTENSION_SNAPIN_DATACLASS

將資料成員加入至 ISnapInItemImpl的嵌入式管理單元的擴充功能資料類別的衍生類別。

EXTENSION_SNAPIN_NODEINFO_ENTRY

將嵌入式管理單元的擴充功能資料類別加入至嵌入式管理單元的擴充功能資料類別對應。

FORWARD_NOTIFICATIONS

傳送通知訊息寫入父視窗。

IMPLEMENTED_CATEGORY

IMPLEMENTED_CATEGORY 巨集加入至元件的 類別對應 指定應將其註冊為實作 catID 參數所識別的分類。

MESSAGE_HANDLER

定義在訊息對應的項目。

MESSAGE_RANGE_HANDLER

與類似,但 MESSAGE_HANDLER,將 Windows 訊息的範圍限制為單一處理函式。

NOTIFY_CODE_HANDLER

與類似,但是會對應 NOTIFY_HANDLER,以通知程式碼只會 WM_NOTIFY 訊息。

NOTIFY_HANDLER

定義在訊息對應的項目。

NOTIFY_ID_HANDLER

與類似,但是會對應 NOTIFY_HANDLER,根據控制識別項只會 WM_NOTIFY 訊息。

NOTIFY_RANGE_CODE_HANDLER

與類似,但 NOTIFY_RANGE_HANDLER,對應 WM_NOTIFY 訊息與特定通知程式碼從控制項的範圍是單一處理常式中運作。

NOTIFY_RANGE_HANDLER

與類似,但 NOTIFY_HANDLER,對應 WM_NOTIFY 訊息從控制項的範圍是單一處理常式中運作。

OBJECT_ENTRY_AUTO

輸入 ATL 物件至物件的對應,更新登錄,並建立物件的執行個體。

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO

可讓您指定應該註冊和初始化物件,不過,它不應該是外部可透過 CoCreateInstance

PROP_DATA_ENTRY

表示範圍或維度, ActiveX 控制項。

PROP_ENTRY_INTERFACE

使用這個巨集輸入屬性頁 CLSID 屬性描述、屬性 DISPID 和清單物件中的屬性。

PROP_ENTRY_INTERFACE_CALLBACK

使用這個巨集進入屬性描述,屬性的物件,並提供回呼函式判斷 CLSID 是否應加入至屬性。

PROP_ENTRY_INTERFACE_CALLBACK_EX

如果您的物件支援雙重介面,類似於, PROP_ENTRY_INTERFACE_CALLBACK,但可讓您指定特定 IID。

PROP_ENTRY_INTERFACE_EX

如果您的物件支援雙重介面,類似於, PROP_ENTRY_INTERFACE,但可讓您指定特定 IID。

PROP_ENTRY_TYPE

使用這個巨集進入屬性描述、屬性和 DISPID 屬性頁 CLSID 到物件的屬性。

PROP_ENTRY_TYPE_EX

如果您的物件支援雙重介面,類似於, PROP_ENTRY_TYPE,但可讓您指定特定 IID。

PROP_PAGE

使用這個巨集輸入屬性頁 CLSID 到物件的屬性。

RDX_BINARY

會將指定的登錄項目具有型別的位元組指定的成員變數。

RDX_CSTRING_TEXT

會將指定的登錄項目與型別 CString 中指定的成員變數。

RDX_DWORD

會將指定的登錄項目與型別 DWORD 中指定的成員變數。

RDX_TEXT

會將指定的登錄項目以 TCHAR 型別的指定成員變數。

REFLECT_NOTIFICATIONS

反映通知訊息傳送至其子視窗 (控制項)。

REFLECTED_COMMAND_CODE_HANDLER

與類似,但 COMMAND_CODE_HANDLER,將父視窗所反映的命令。

REFLECTED_COMMAND_HANDLER

與類似,但 COMMAND_HANDLER,將父視窗所反映的命令。

REFLECTED_COMMAND_ID_HANDLER

與類似,但 COMMAND_ID_HANDLER,將父視窗所反映的命令。

REFLECTED_COMMAND_RANGE_CODE_HANDLER

與類似,但 COMMAND_RANGE_CODE_HANDLER,將父視窗所反映的命令。

REFLECTED_COMMAND_RANGE_HANDLER

與類似,但 COMMAND_RANGE_HANDLER,將父視窗所反映的命令。

REFLECTED_NOTIFY_CODE_HANDLER

與類似,但 NOTIFY_CODE_HANDLER,將父視窗所反映的告知。

REFLECTED_NOTIFY_HANDLER

與類似,但 NOTIFY_HANDLER,將父視窗所反映的告知。

REFLECTED_NOTIFY_ID_HANDLER

與類似,但 NOTIFY_ID_HANDLER,將父視窗所反映的告知。

REFLECTED_NOTIFY_RANGE_CODE_HANDLER

與類似,但 NOTIFY_RANGE_CODE_HANDLER,將父視窗所反映的告知。

REFLECTED_NOTIFY_RANGE_HANDLER

與類似,但 NOTIFY_RANGE_HANDLER,將父視窗所反映的告知。

REQUIRED_CATEGORY

REQUIRED_CATEGORY 巨集加入至元件的 類別對應 指定應將其註冊為要求 catID 參數所識別的分類。

SERVICE_ENTRY

指示物件支援 SID指定的服務 ID。

SERVICE_ENTRY_CHAIN

指示 IServiceProviderImpl::QueryServicepunk繫結至指定的物件。

SINK_ENTRY

宣告處理常式函式 (fn) 指定事件的dispid() id決定的,則該控制項。

SINK_ENTRY_EX

宣告處理常式函式 (fn) 指定的事件 (),dispid分派介面 (iid),但是,為了 id識別的控制項。

SINK_ENTRY_INFO

使用事件接收對應中的 SINK_ENTRY_INFO 巨集 IDispEventSimpleImpl 提供所需資訊的路由事件加入至相關的處理函式。

SNAPINMENUID

使用這個巨集會宣告嵌入式管理單元的物件內容功能表資源。

SNAPINTOOLBARID_ENTRY

使用這個巨集輸入工具列 ID 為嵌入式管理單元的物件的工具列 ID 對應。

WM_FORWARDMSG

這個巨集會將連結視窗接收到的訊息會傳送到另一個視窗。

請參閱

其他資源

ATL 巨集

ATL COM Desktop Components

ATL Functions

ATL Global Variables

ATL Structures

ATL Typedefs

ATL Class Overview