電子發(fā)燒友App
關(guān)于API使用
網(wǎng)上有很多API教程，但是都是針對單個API的使用來講解，但是如果遇到網(wǎng)上沒有教程的API呢？如下教程的目的就是這樣：當(dāng)遇到一個不會的API的時候，懂得如何利用資料學(xué)會使用這個API。
本文讀者需具備的知識：
1、VB的基本語法
2、API、結(jié)構(gòu)體、常數(shù)
3、VB的數(shù)據(jù)類型，C語言的簡單數(shù)據(jù)類型
4、API Viewer 2004（或其他同類軟件）的基本使用
5、一定的英文閱讀能力
那么要調(diào)用一個陌生的API，基本上遵循以下步驟
1、找到相關(guān)API、結(jié)構(gòu)體、常數(shù)的聲明
2、到MSDN閱讀這個API的網(wǎng)頁指南
3、按照MSDN寫代碼
實戰(zhàn)演示：
這次實戰(zhàn)的目標(biāo)是：GetOpenFileName
首先介紹一下這個API吧，這個API會顯示一個打開對話框，給用戶選擇一個文件打開
這個跟CommonDialog里面的打開對話框是一樣的（那干嘛不直接用那個控件？教程用來做演示嘛，而且用API也有他的好處）
第一步：找到聲明
找聲明主要有兩種方法
第一種是通過軟件找，例如API Viewer 2004，這類軟件內(nèi)置有絕大部分常用的聲明，直接復(fù)制即可，方便快捷
第二種是去MSDN找到API的頁面，然后復(fù)制聲明。MSDN是微軟的網(wǎng)站，聲明肯定是準(zhǔn)確的，但是對于VB開發(fā)者的劣勢是，絕大部分聲明都是按照C語言的格式的（至今沒見過一個API的頁面有VB聲明），所以如果不懂C語言的話要轉(zhuǎn)換成VB的聲明難度就大了
還有其他方法，例如dump dll文件之類的
本文主要討論第一種方法，使用的軟件是API Viewer 2004，其他同類軟件操作大同小異
打開API Viewer 2004，打開Win32api.apv文件，然后選擇Declarations一欄，然后選擇Subs and Functions，在文本框輸入GetOpenFileName，然后就找到這個API的聲明了，復(fù)制下來，扔進VB的代碼里面
好了，現(xiàn)在來仔細看一下這個聲明：
Private Declare Function GetOpenFileName Lib “comdlg32.dll” Alias “GetOpenFileNameA” （ByRef pOpenfilename As OPENFILENAME） As Long
可以看到這里有一個陌生的參數(shù)類型OPENFILENAME，這明顯不是VB的基本數(shù)據(jù)類型，所以我們需要這個OPENFILENAME的聲明
于是回到API Viewer 2004，選擇Types一欄，在文本框輸入OPENFILENAME，找到聲明了，復(fù)制下來，扔到VB代碼里面
Private Type OPENFILENAME
lStructSize As Long
hwndOwner As Long
hInstance As Long
lpstrCustomFilter As String
nMaxCustFilter As Long
nFilterIndex As Long
lpstrFile As String
nMaxFile As Long
lpstrFileTitle As String
nMaxFileTitle As Long
lpstrInitialDir As String
lpstrTitle As String
flags As Long
nFileOffset As Integer
nFileExtension As Integer
lpstrDefExt As String
lCustData As Long
lpfnHook As Long
lpTemplateName As String
End Type
繼續(xù)仔細看這個結(jié)構(gòu)體的聲明，可以發(fā)現(xiàn)成員都是VB的基本數(shù)據(jù)類型，說明不需要在找其他聲明了
第二步：閱讀MSDN對于這個API的解釋 & 第三步：按照MSDN寫代碼
這里說的MSDN不是按F1出來那個MSDN，而是MSDN網(wǎng)站msdn.microsoft.com。這個是微軟的官方開發(fā)者網(wǎng)站，里面資料齊全絕對是開發(fā)者的天堂
網(wǎng)站有中文版本和英文版本，不過強烈建議大家看英文版本，中文版的翻譯質(zhì)量不好（這就是為什么要求有一定的英文閱讀能力）
好吧進入了這個官網(wǎng)之后，在最上面的Bing搜索里面打GetOpenFileName，然后搜索
出來的結(jié)果，一般選擇xxxx function這種頁面，這里選的就是第一個結(jié)果GetOpenFileName function
http://msdn.microsoft.com/en-us/library/windows/desktop/ms646927（v=vs.85）.aspx
頁面打開了，可以看到這個頁面分成幾大節(jié)：
開頭：對API的簡單介紹
Syntax：語法，也就是API的聲明
Return Value：返回值
Remarks：一些附加的說明
Examples：示例代碼，一般都是用C語言寫的
Requirements：API對系統(tǒng)的要求等等
See Also：與此相關(guān)的API等
Community Additions：其他人對此文章的評論
網(wǎng)頁左欄：是整個站點的分類目錄
好吧，英文不好的同學(xué)要加油了，混國外網(wǎng)站英文是必須要會的
不要覺得一個API能有這么多內(nèi)容，很多信息都是很有用很關(guān)鍵的，耐心從上往下一節(jié)一節(jié)讀完
開頭：這個自己看就是了，對API的介紹和描述，不是很重要的部分（不過有時會有很重要的批注，例如此API不再被微軟支持建議用xxx代替之類的）
Syntax：這個就是API的語法，也就是聲明啦，C語言的，所以對我們沒什么用，可以跳掉不看
如果要根據(jù)這個C語言的聲明自己寫出VB的聲明，還是需要一定的C語言數(shù)據(jù)類型的知識
PS：這里為什么返回值是BOOL，但是我們的聲明是Long呢？是不是應(yīng)該把我們的VB聲明改成Boolean？不需要的。BOOL在C里面的定義就是long型（unsigned long？具體忘了，差不多這類東西），占用4字節(jié)，所以應(yīng)該對應(yīng)VB的Long型。當(dāng)然，你閑著蛋疼也可以把返回值聲明成Single型，同樣也是4字節(jié)，不過沒什么意義
Parameters：API的參數(shù)部分啦，整個網(wǎng)頁最重要的部分之一
按照這里的解釋，填寫參數(shù)就可以調(diào)用API了
好吧這里只有一個參數(shù)，網(wǎng)頁寫的是
lpofn ［in， out］
Type： LPOPENFILENAME
這個［in， out］是什么意思呢？in表示這個是個輸入?yún)?shù)，這個參數(shù)的值會作為輸入對API的結(jié)果進行影響。out表示這個同時也是個輸出參數(shù)，API會把部分?jǐn)?shù)據(jù)返回到這個參數(shù)里面。（除了in和out，有些還會出現(xiàn)optional，表示這是個可選參數(shù)）
LPOPENFILENAME說的就是參數(shù)的類型，等等，我們的聲明不是寫的類型是OPENFILENAME嗎，怎么這里多了個LP？這個是C語言里指針的意思（long pointer？），意思是當(dāng)調(diào)用API的時候，不是把這個整個OPENFILENAME結(jié)構(gòu)體的數(shù)據(jù)傳過去，而是只把這個結(jié)構(gòu)體的指針傳過去。同樣的寫法還有xxx*，例如OPENFILENAME*
接下來看他對這個參數(shù)的描述，大致是這個參數(shù)裝載著啟動這個API的參數(shù)，當(dāng)API返回的時候會把結(jié)果放到這個結(jié)構(gòu)體里面
說的基本都是廢話，這個結(jié)構(gòu)體有這么多成員，我們還是不知道怎么填，那么就點進去這個OPENFILENAME的鏈接
點進去之后，發(fā)現(xiàn)這個OPENFILENAME文章結(jié)構(gòu)也差不多
Syntax可以跳過，我們已經(jīng)從API Viewer 2004里面找到聲明了（PS：后面這個#if和#endif中間的是什么東西呢？這個是C的預(yù)編譯指令，具體可以自己去看，在這里沒什么用）
Members，終于在講解這些成員的意思了，好吧可以開始寫代碼了，首先在VB里面寫
Dim ofn As OPENFILENAME
With ofn
End With
那么接下來就一個一個看成員，看他的解釋，是什么意思，應(yīng)該怎么填
需要注意的一些東西是，不像API的參數(shù)，并沒有告訴你每個成員是作為輸入還是輸出的作用，需要自己認真讀解釋
lStructSize，Type： DWORD
結(jié)構(gòu)體的字節(jié)大小，用sizeof（OPENFILENAME）獲得
sizeof其實就是C語言里面獲得結(jié)構(gòu)體大小的函數(shù)，那VB里面我們就用LenB吧（Len也行，不過按照MSDN的說法還是用LenB吧）
（PS：DWORD對應(yīng)VB的Long）
代碼：.lStructSize = LenB（ofn）
hwndOwner，Type： HWND
這個對話框的父窗體的句柄，可以設(shè)置成NULL
那我們就做成父窗體是我們的Form1吧
（PS：HWND也是對于VB的Long，NULL則是0）
代碼：.hwndOwner = Me.hWnd
hInstance，Type： HINSTANCE
如果要指定對話框的模板，那么這個需要填上模板所在的程序句柄
我們沒興趣用什么模板，windows自帶的那個已經(jīng)夠好看了，不理他填個NULL
代碼：.hInstance = 0
lpstrFilter，Type： LPCTSTR
文件類型過濾器，格式為 描述文字 庄河市| 桐庐县| 安吉县| 高尔夫| 怀柔区| 磐石市| 定结县| 屯昌县| 赤峰市| 宁强县| 巨野县| 泰和县| 汕头市| 集安市| 古交市| 吴川市| 宜阳县| 永清县| 鄂州市| 印江| 西平县| 仁怀市| 乌拉特中旗| 施秉县| 河南省| 昌黎县| 林甸县| 崇义县| 太仆寺旗| 江源县| 普格县| 绥阳县| 哈密市| 景德镇市| 文昌市| 荃湾区| 滦南县| 富顺县| 冷水江市| 论坛| 安乡县|