電子發(fā)燒友App
關于API使用
網(wǎng)上有很多API教程，但是都是針對單個API的使用來講解，但是如果遇到網(wǎng)上沒有教程的API呢？如下教程的目的就是這樣：當遇到一個不會的API的時候，懂得如何利用資料學會使用這個API。
本文讀者需具備的知識：
1、VB的基本語法
2、API、結構體、常數(shù)
3、VB的數(shù)據(jù)類型，C語言的簡單數(shù)據(jù)類型
4、API Viewer 2004（或其他同類軟件）的基本使用
5、一定的英文閱讀能力
那么要調用一個陌生的API，基本上遵循以下步驟
1、找到相關API、結構體、常數(shù)的聲明
2、到MSDN閱讀這個API的網(wǎng)頁指南
3、按照MSDN寫代碼
實戰(zhàn)演示：
這次實戰(zhàn)的目標是：GetOpenFileName
首先介紹一下這個API吧，這個API會顯示一個打開對話框，給用戶選擇一個文件打開
這個跟CommonDialog里面的打開對話框是一樣的（那干嘛不直接用那個控件？教程用來做演示嘛，而且用API也有他的好處）
第一步：找到聲明
找聲明主要有兩種方法
第一種是通過軟件找，例如API Viewer 2004，這類軟件內置有絕大部分常用的聲明，直接復制即可，方便快捷
第二種是去MSDN找到API的頁面，然后復制聲明。MSDN是微軟的網(wǎng)站，聲明肯定是準確的，但是對于VB開發(fā)者的劣勢是，絕大部分聲明都是按照C語言的格式的（至今沒見過一個API的頁面有VB聲明），所以如果不懂C語言的話要轉換成VB的聲明難度就大了
還有其他方法，例如dump dll文件之類的
本文主要討論第一種方法，使用的軟件是API Viewer 2004，其他同類軟件操作大同小異
打開API Viewer 2004，打開Win32api.apv文件，然后選擇Declarations一欄，然后選擇Subs and Functions，在文本框輸入GetOpenFileName，然后就找到這個API的聲明了，復制下來，扔進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，找到聲明了，復制下來，扔到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ù)仔細看這個結構體的聲明，可以發(fā)現(xiàn)成員都是VB的基本數(shù)據(jù)類型，說明不需要在找其他聲明了
第二步：閱讀MSDN對于這個API的解釋 & 第三步：按照MSDN寫代碼
這里說的MSDN不是按F1出來那個MSDN，而是MSDN網(wǎng)站msdn.microsoft.com。這個是微軟的官方開發(fā)者網(wǎng)站，里面資料齊全絕對是開發(fā)者的天堂
網(wǎng)站有中文版本和英文版本，不過強烈建議大家看英文版本，中文版的翻譯質量不好（這就是為什么要求有一定的英文閱讀能力）
好吧進入了這個官網(wǎng)之后，在最上面的Bing搜索里面打GetOpenFileName，然后搜索
出來的結果，一般選擇xxxx function這種頁面，這里選的就是第一個結果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：與此相關的API等
Community Additions：其他人對此文章的評論
網(wǎng)頁左欄：是整個站點的分類目錄
好吧，英文不好的同學要加油了，混國外網(wǎng)站英文是必須要會的
不要覺得一個API能有這么多內容，很多信息都是很有用很關鍵的，耐心從上往下一節(jié)一節(jié)讀完
開頭：這個自己看就是了，對API的介紹和描述，不是很重要的部分（不過有時會有很重要的批注，例如此API不再被微軟支持建議用xxx代替之類的）
Syntax：這個就是API的語法，也就是聲明啦，C語言的，所以對我們沒什么用，可以跳掉不看
如果要根據(jù)這個C語言的聲明自己寫出VB的聲明，還是需要一定的C語言數(shù)據(jù)類型的知識
PS：這里為什么返回值是BOOL，但是我們的聲明是Long呢？是不是應該把我們的VB聲明改成Boolean？不需要的。BOOL在C里面的定義就是long型（unsigned long？具體忘了，差不多這類東西），占用4字節(jié)，所以應該對應VB的Long型。當然，你閑著蛋疼也可以把返回值聲明成Single型，同樣也是4字節(jié)，不過沒什么意義
Parameters：API的參數(shù)部分啦，整個網(wǎng)頁最重要的部分之一
按照這里的解釋，填寫參數(shù)就可以調用API了
好吧這里只有一個參數(shù)，網(wǎng)頁寫的是
lpofn ［in， out］
Type： LPOPENFILENAME
這個［in， out］是什么意思呢？in表示這個是個輸入?yún)?shù)，這個參數(shù)的值會作為輸入對API的結果進行影響。out表示這個同時也是個輸出參數(shù)，API會把部分數(shù)據(jù)返回到這個參數(shù)里面。（除了in和out，有些還會出現(xiàn)optional，表示這是個可選參數(shù)）
LPOPENFILENAME說的就是參數(shù)的類型，等等，我們的聲明不是寫的類型是OPENFILENAME嗎，怎么這里多了個LP？這個是C語言里指針的意思（long pointer？），意思是當調用API的時候，不是把這個整個OPENFILENAME結構體的數(shù)據(jù)傳過去，而是只把這個結構體的指針傳過去。同樣的寫法還有xxx*，例如OPENFILENAME*
接下來看他對這個參數(shù)的描述，大致是這個參數(shù)裝載著啟動這個API的參數(shù)，當API返回的時候會把結果放到這個結構體里面
說的基本都是廢話，這個結構體有這么多成員，我們還是不知道怎么填，那么就點進去這個OPENFILENAME的鏈接
點進去之后，發(fā)現(xiàn)這個OPENFILENAME文章結構也差不多
Syntax可以跳過，我們已經(jīng)從API Viewer 2004里面找到聲明了（PS：后面這個#if和#endif中間的是什么東西呢？這個是C的預編譯指令，具體可以自己去看，在這里沒什么用）
Members，終于在講解這些成員的意思了，好吧可以開始寫代碼了，首先在VB里面寫
Dim ofn As OPENFILENAME
With ofn
End With
那么接下來就一個一個看成員，看他的解釋，是什么意思，應該怎么填
需要注意的一些東西是，不像API的參數(shù)，并沒有告訴你每個成員是作為輸入還是輸出的作用，需要自己認真讀解釋
lStructSize，Type： DWORD
結構體的字節(jié)大小，用sizeof（OPENFILENAME）獲得
sizeof其實就是C語言里面獲得結構體大小的函數(shù)，那VB里面我們就用LenB吧（Len也行，不過按照MSDN的說法還是用LenB吧）
（PS：DWORD對應VB的Long）
代碼：.lStructSize = LenB（ofn）
hwndOwner，Type： HWND
這個對話框的父窗體的句柄，可以設置成NULL
那我們就做成父窗體是我們的Form1吧
（PS：HWND也是對于VB的Long，NULL則是0）
代碼：.hwndOwner = Me.hWnd
hInstance，Type： HINSTANCE
如果要指定對話框的模板，那么這個需要填上模板所在的程序句柄
我們沒興趣用什么模板，windows自帶的那個已經(jīng)夠好看了，不理他填個NULL
代碼：.hInstance = 0
lpstrFilter，Type： LPCTSTR
文件類型過濾器，格式為 描述文字