#import 指令
C++特殊處
#import指令用于從一個(gè)類型庫(kù)中結(jié)合信息。該類型庫(kù)的內(nèi)容被轉(zhuǎn)換為C++類,主要用于描述COM界面。
語(yǔ)法
#import "文件名" [屬性]
#import <文件名> [屬性]
屬性:
屬性1,屬性2,...
屬性1 屬性2 ...
文件名是一個(gè)包含類型庫(kù)信息的文件的名稱。一個(gè)文件可為如下類型之一:
* 一個(gè)類型庫(kù)(.TLB或.ODL)文件。
* 一個(gè)可執(zhí)行(.EXE)文件。
* 一個(gè)包含類型庫(kù)資源(如.OCX)的庫(kù)文件(.DLL)。
* 一個(gè)包含類型庫(kù)的復(fù)合文檔。
* 其它可被LoadTypeLib API支持的文件格式。
文件名之前可以有一個(gè)目錄規(guī)格。文件名必須是一個(gè)已存在文件的名稱。兩種格式的區(qū)別是當(dāng)路徑未完全說明時(shí),預(yù)處理器檢索類型庫(kù)文件的順序不同。
動(dòng)作
語(yǔ)法格式
引號(hào)格式 這種格式讓預(yù)處理器首先搜索與包含#import語(yǔ)句的文件同一目錄的類型庫(kù)文件,然后在所有包括(#include)該文件的目錄中搜索,最后在如下路徑中搜索
尖括號(hào)格式 這種格式指示預(yù)處理器沿以下路徑搜索類型庫(kù)文件
編譯器在以下目錄中搜索已命名的文件:
1. PATH環(huán)境變量路徑表。
2. LIB環(huán)境變量路徑表。
3. 用/I(額外的包括目錄)編譯器選項(xiàng)指定的路徑。#import可以任選地包含一個(gè)或多個(gè)屬性。這些屬性使編譯器改變類型庫(kù)頭文件的內(nèi)容。一個(gè)反斜杠(\)符可用在一個(gè)單一的#import語(yǔ)句中包含額外的行,例如:
#import "test.lib" no_namespace \
rename("OldName","NewName")
#import屬性列出如下:
| exclude | high_method_prefix |
| high_property_prefixes | implementation_only |
| include(...) | inject_statement |
| named_guids | no_auto_exclude |
| no_implementation | no_namespace |
| raw_dispinterfaces | raw_interfaces_only |
| raw_method_prefix | raw_native_types |
| raw_property_prefixes | rename |
| rename_namespace | |
#import指令可創(chuàng)建兩個(gè)在C++源代碼中重構(gòu)類型庫(kù)內(nèi)容的頭文件,第一個(gè)頭文件和用Microsoft接口定義語(yǔ)言(MIDL)編譯器生成的頭文件類似,但有額外的編譯器生成代碼和數(shù)據(jù)。第一個(gè)頭文件與類型庫(kù)有相同的基本名,其擴(kuò)展名為.TLH。第二個(gè)頭文件也有與類型庫(kù)相同的基本名,其擴(kuò)展名為.TLI。它包括了編譯器生成成員函數(shù)的實(shí)現(xiàn),且被包含在(#include)的第一個(gè)頭文件內(nèi)。
兩個(gè)頭文件都在用/Fo(命名對(duì)象文件)選項(xiàng)指定的輸出目錄中。隨后它們被讀出和編譯,就像第一個(gè)頭文件被#include指令命名一樣。
以下是伴隨#import指令的編譯器優(yōu)化:
* 頭文件被創(chuàng)建時(shí),將被分配與類庫(kù)相同的時(shí)間標(biāo)志。
* 處理#import時(shí),編譯器首先測(cè)試頭文件是否存在,是否過期。若條件為真,就不需重新創(chuàng)建。
* 編譯器延遲對(duì)于OLE子系統(tǒng)的初始化,直到碰到第一個(gè)#import命令。
#import指令也可參與最小重建且可被置于一個(gè)預(yù)編譯頭文件中。
基本類型庫(kù)頭文件
基本類型庫(kù)頭文件由七個(gè)部分組成:
1. 頭部固定正文:由注釋、COMDEF.H(定義用在頭部的一些標(biāo)準(zhǔn)宏)的#include語(yǔ)句和其它繁雜的安裝信息組成。
2.前向引用和類型定義:由象struct IMyinterface之類的結(jié)構(gòu)說明和用于一些TKIND_ALIAS項(xiàng)的類型定義組成。
3.靈敏指針說明:模塊類_com_ptr_t是一個(gè)封裝接口指針和消除調(diào)用AddRef、Release 和QueryInterface函數(shù)需求的靈敏指針實(shí)現(xiàn)。此外,它隱藏了創(chuàng)建一個(gè)新COM對(duì)象中的CoCreateInstance調(diào)用。此部分采用宏語(yǔ)句_COM_SMARTPTR_TYPEDEF將COM接口的類型定義創(chuàng)建為_com_ptr_t模板類的模板特例化。例如,對(duì)于界面IFoo,.TLH文件包含有:
_COM_SMARTPTR_TYPEDEF(IFoo,_ _uuidof(IFoo));
編譯器將其擴(kuò)展為:type def _com_ptr_t<_com_IIID<IFoo,_ _uuidof(IFoo) >> IFooPtr;
類型IFooPtr可以用在原始的界面指針IFoo*的地方。結(jié)果,就不需調(diào)用各種IUnknown成員函數(shù)。
4. 類型信息(typeinfo)說明:主要由類定義和其它項(xiàng)組成,這些項(xiàng)說明由ITyptLib:GetTypeInfo返回的單個(gè)的信息類型項(xiàng)目。在這部分,每個(gè)來自于類型庫(kù)的信息類型都以一種依賴于TYPEKIND信息的格式反映在該頭部。
5. 任選舊式GUID定義:包含命名的GUID常量的初始化過程,這些定義是格式CLSID_CoClass和IID_Interface的名稱,與那些由MIDL編譯器產(chǎn)生的類似。
6. 用于第二個(gè)類型庫(kù)頭部的#include語(yǔ)句。
7. 結(jié)尾固定正文:目前包括#pragma pack(pop)。
以上這些部分除頭部固定正文和結(jié)尾固定正文部分之外,都被包括在原來的IDL文件中以library語(yǔ)句指定其名稱的名稱空間中。你可以通過用名稱空間顯式限定或包括如下語(yǔ)句從類型庫(kù)頭部使用該名稱。
using namespace MyLib
在源代碼的#import語(yǔ)句之后立即
名稱空間可用#import指令的no_namespace屬性來阻止。但阻止的名稱空間可能導(dǎo)致名稱沖突。名稱空間也可用rename_namespace屬性重新?lián)Q名。
編譯器提供完全路徑給需要依賴當(dāng)前正在處理的類型庫(kù)的任何類型庫(kù)。路徑以注釋格式寫入到由編譯器為每個(gè)處理的類型庫(kù)生成的類型庫(kù)頭部(.TLH)。
如果一個(gè)類型庫(kù)包含了對(duì)其它類型庫(kù)定義的類型引用,.TLH文件將包括以下注釋:
//
//Cross-referenced type libraries:
//
//#import "c:\path\typelib0.tlb"
//
在#import注釋中的實(shí)際文件名是存儲(chǔ)在寄存器中交叉引用的類型庫(kù)全路徑。如果你遇到由于省略類型定義的錯(cuò)誤時(shí),檢查.TLH頭部的注釋,看哪一種依賴類型庫(kù)需要先輸入。在編譯該.TLI文件時(shí)可能的錯(cuò)誤有語(yǔ)法錯(cuò)誤(例如C2143,C2146,C2321)、C2501(缺少說明指示符)或C2433(在數(shù)據(jù)說明中禁止′inline′)。
你必須確定哪些依賴注釋是不被系統(tǒng)頭部給出的,而是在依賴類型庫(kù)的#import指令前的某處給出一個(gè)#import指令以消除這些錯(cuò)誤。
exclude屬性exclude(“稱1”[,“名稱2”,...])
名稱1
被排斥的第一個(gè)項(xiàng)
名稱2
被排斥的第二個(gè)項(xiàng)(如有必要)
類型庫(kù)可能包含在系統(tǒng)頭部或其它類型庫(kù)內(nèi)定義的項(xiàng)的定義。該屬性可用于從生成的類型庫(kù)頭文件中排斥這些項(xiàng)。這個(gè)屬性可帶任意數(shù)目的參量,每個(gè)參量是一個(gè)被排斥的高級(jí)類型庫(kù)項(xiàng)目:
high_method_prefix屬性
high_method_prefix("Prefix")
Prefix
被使用的前綴
在缺省的情況下,高級(jí)錯(cuò)誤處理屬性和方法用一個(gè)無(wú)前綴命名的成員函數(shù)來展示。這個(gè)名稱來自于類型庫(kù)。high_method_prefix屬性說明一個(gè)前綴以用于命名這些高級(jí)屬性和方法。
high_property_prefixes屬性
high_property_prefixes("GetPrefix，""PutPrefix，""PutRefPrefix")
GetPrefix
用于propget方法的前綴
PutPrefix
用于propput方法的前綴
PutRefPrefix
用于propputref方法的前綴
在缺省情況下,高級(jí)錯(cuò)誤處理方法,如propget、propput和propputref,分別采用以前綴Get、Put和PutRef命名的成員函數(shù)來說明。high_property_prefixes屬性用于分別說明這三種屬性方法的前綴。
implementation_only屬性
implementation_only屬性禁止.TLH頭文件(基本頭文件)的生成。這個(gè)文件包括了所有用于展示類型庫(kù)內(nèi)容的說明。該.TLI頭文件和wrapper成員函數(shù)的實(shí)現(xiàn),將被生成且包含在編譯過程中。
當(dāng)指定該屬性時(shí),該.TLI頭部的內(nèi)容將和用于存放普通.TLH頭部的內(nèi)容放在相同的名稱空間。此外,該成員函數(shù)不會(huì)作為聯(lián)編說明。implementation_only屬性一般希望與no_implementation屬性配對(duì)使用,以跟蹤預(yù)編譯頭文件(PCH)之外的實(shí)現(xiàn)。一個(gè)有no_implementation屬性的#import語(yǔ)句被置于用來創(chuàng)建pch的源區(qū)域中,結(jié)果PCH將被一些源文件所用。一個(gè)帶implementation_only屬性的#import語(yǔ)句隨后被用在PCH區(qū)域之外。在一個(gè)源文件里只需用一次這種語(yǔ)句。這將生成不需對(duì)每個(gè)源文件進(jìn)行額外重編譯的所有必要的wrapper成員函數(shù)。
注意:一個(gè)#import語(yǔ)句中的implementation_only屬性必須和相同類型庫(kù)中no_implementation屬性的另一個(gè)#import語(yǔ)句配套使用。否則,將產(chǎn)生編譯錯(cuò)誤。這是因?yàn)閹?span lang="EN-US">no_implementation屬性的#import語(yǔ)句生成的wrapper類定義需要編譯implementation_only屬性生成的語(yǔ)句實(shí)現(xiàn)。
include(...)屬性
Include(名稱1[,名稱2,...])
名稱1
第一個(gè)被強(qiáng)制包含的項(xiàng)
名稱2
第二個(gè)被強(qiáng)制包含的項(xiàng)(如果必要)
類型庫(kù)可能包含在系統(tǒng)頭部或其它類型庫(kù)中定義的項(xiàng)的定義。#import指令試圖用自動(dòng)排斥這些項(xiàng)來避免多重定義錯(cuò)誤。若這些項(xiàng)已經(jīng)被排斥,象警告C4192所指出的那樣,且它們不應(yīng)該被排斥,則這個(gè)屬性可用于禁止自動(dòng)排斥。該屬性可帶任意數(shù)目的參量,每個(gè)參量應(yīng)是被包括的類型庫(kù)項(xiàng)的名稱。
inject_statement屬性
inject_statement("source_text")
source_text
被插入到類型庫(kù)頭文件的源文本。
inject_statement屬性將其參量作為源文本插入類型庫(kù)頭部。此文本被置于包括頭文件中類型庫(kù)內(nèi)容的名稱空間說明的起始處。
named_guids屬性
named_guids屬性讓編譯器定義和初始化模板LIBID_MyLib、CLSID_MyCoClass、IID_MyInterface和DIID_MyDispInterface的舊式格式的GUID變量。
no_implementation屬性
該屬性阻止.TLI頭文件的生成,這個(gè)文件包含wrapper成員函數(shù)的實(shí)現(xiàn)。如果指定這個(gè)屬性,則展示類型庫(kù)項(xiàng)說明的.TLH頭將生成沒有一個(gè)#include語(yǔ)句包括該.TLI頭文件。
該屬性與implementation_only屬性配套使用。
no_auto_exclude屬性
類型庫(kù)可能包括在系統(tǒng)頭部或其它類型庫(kù)中定義的項(xiàng)的定義。#import試圖通過自動(dòng)排斥這些項(xiàng)來避免多重定義錯(cuò)誤。當(dāng)這樣做時(shí),每個(gè)被排斥的項(xiàng)都將生成一個(gè)C4192警告信息。你可禁止這個(gè)屬性使用自動(dòng)排斥。
no_namespace屬性
#import頭文件中的類型庫(kù)內(nèi)容一般定義在一個(gè)名稱空間里。名稱空間的名稱在原來IDL文件的library語(yǔ)句中指定。如果指定no_namespace屬性,編譯器就不會(huì)生成這個(gè)名稱空間。
如果你想使用一個(gè)不同的名稱空間,應(yīng)代替使用rename_namespace屬性。
raw_dispinterfaces屬性
raw_dispinterfaces屬性讓編譯器生成一個(gè)低級(jí)wrapper函數(shù)。該函數(shù)用于調(diào)用IDispatch::Invoke和返回HRESULT錯(cuò)誤代碼的dispinterface方法和屬性。如果未指定此屬性,則只生成高級(jí)wrapper,它在失敗時(shí)丟棄該C++異常。
raw_interfaces_only屬性
raw_interfaces_only屬性禁止生成錯(cuò)誤處理wrapper函數(shù)以及使用這些wrapper函數(shù)的_ _declspec(屬性)說明。
raw_interfaces_only屬性也導(dǎo)致刪除在命名non__property函數(shù)中的缺省前綴。通常該前綴是raw_。若指定此屬性,函數(shù)名稱將直接從類型庫(kù)中生成。該屬性只允許展示類型庫(kù)的低級(jí)內(nèi)容。
raw_method_prefix屬性
raw_method_prefix("Prefix")
Prefix
被使用的前綴
用raw_作為缺省前綴的成員函數(shù)展示低層屬性和方法,以避免與高級(jí)錯(cuò)誤處理成員函數(shù)的名稱沖突。raw_method_prefix屬性用于指定一個(gè)不同的前綴。注意: raw_method_prefix屬性的效果不會(huì)因raw_method_prefix屬性的存在而改變。在說明一個(gè)前綴時(shí),raw_method_prefix總是優(yōu)先于raw_interfaces_only。若兩種屬性用在同一個(gè)#import語(yǔ)句中時(shí),則采用raw_method_prefix指定的前綴。
raw_native_types屬性
在缺省情況下,高級(jí)錯(cuò)誤處理方法在BSTR和VARIANT數(shù)據(jù)類型和原始COM界面指針的地方使用COM支持類_bctr_t和_variant_t。這些類封裝了分配和取消分配這些數(shù)據(jù)類型的存儲(chǔ)器存儲(chǔ)的細(xì)節(jié),并且極大地簡(jiǎn)化了類型造型和轉(zhuǎn)換操作。raw_native_types屬性在高級(jí)wrapper函數(shù)中禁止使用這些COM支持類,并強(qiáng)制替換使用低級(jí)數(shù)據(jù)類型。
raw_property_prefix屬性
raw_property_prefix("GetPrefix","PutPrefix","PutRefPrefix")
GetPrefix
用于propget方法的前綴
PutPrefix
用于propput方法的前綴
PutRefPrefix
用于propputref方法的前綴
在缺省情況下,低級(jí)方法propget、propput和propputref分別用后綴為get_、put_和putref_的成員函數(shù)來展示。這些前綴與MIDL生成的頭文件中的名稱是兼容的。raw_property_prefixes屬性分別用于說明這三個(gè)屬性方法的前綴。
rename屬性
rename("OldName，""NewName")
OldName
類型庫(kù)中的舊名
NewName
用于替換舊名的名稱
rename屬性用于解決名稱沖突的問題。若該屬性被指定,編譯器將在類型庫(kù)中的OldName的所有出現(xiàn)處用結(jié)果頭文件中用戶提供的NewName替換。
此屬性用于類型庫(kù)中的一個(gè)名稱和系統(tǒng)頭文件中的宏定義重合時(shí)。若這種情況未被解決,則將產(chǎn)生大量語(yǔ)法錯(cuò)誤,如C2059和C2061。
注意:這種替換用于類型庫(kù)的名稱,而不是用于結(jié)果頭文件中的名稱。
這里有一個(gè)例子:假設(shè)類型庫(kù)中有一個(gè)名稱為MyParent的屬性,且頭文件中定義了一個(gè)用在#import之前的宏GetMyParent。由于GetMyParent是用于錯(cuò)誤處理屬性get的一個(gè)wrapper函數(shù)的缺省名稱,所以將產(chǎn)生一個(gè)名稱沖突。為解決這個(gè)問題,使用#import語(yǔ)句中的以下屬性:
rename("MyParent","MyParentX")
該語(yǔ)句將重新命名類型庫(kù)中的名稱MyParent,而試圖重新命名GetMyParentwrapper名稱將會(huì)出錯(cuò):
rename("GetMyParent","GetMyParentX")
這是因?yàn)槊QGetMyParent只出現(xiàn)在結(jié)果類型庫(kù)頭文件中。
rename_namespace屬性
rename_namespace("NewName")
NewName
名稱空間的新名稱
rename_namespace屬性用于重新命名包含類型庫(kù)內(nèi)容的名稱空間。它帶有一個(gè)指定名稱空間新名newname的參量。
消除名稱空間可以使用no_namespace屬性。
C++特殊處結(jié)束