LCC-Win32小指南
By Daniel Guerrero Miralles
翻譯：pigprince
聲明
本文沒有任何明確的或者含蓄的表達說明本文是完全正確的，對于應用本文內容所
產生的任何結果，本人概不負責。
請原諒本文在語言和語法的的運用上的錯誤，本人才疏學淺，這是不可避免的。如
果有什么你覺得不舒服的地方請聯系pigprince，先謝謝了
_________________________________________________________________
LCC-Win32介紹
LCC-Win32原來是一個免費的開放源代碼WIN32編譯器，包含一個很好用的IDE，
用起來很爽，但是最近源碼開始要付費的了（40美圓）。詳情請見LCC-Win32官方網站。
它的免費版本可以在國內得到，到云風工作室看一下，你會有所收獲。
目錄
* 簡介
* 編譯器的安裝
* Lcc-Win32的一些基本概念
* 寫個小程序！
* 使用工程管理
* 第一個Windows程序
* 程序生成向導
* 使用WeditRes創建資源
* 添加其它類型的資源
* 使用非規格資源
* 靜態庫和動態庫
簡介
其實所謂的簡介這個部分的內容趨向取決于作者。但是我所讀過的一些指南都是由
一個“簡介”開始的，這部分的內容通常都是在重復讀者會在下面看到的東西，但是也
有的簡介只是作者的一些想法。
仔細的想一下，其實這個介紹并不是一件簡單的事情。首先，如果你要是開門見山
的直奔主題，這是不禮貌的，而且基于web的指南也不應該有超大個的簡介，不應該讓
讀者在這個東西上浪費時間和金錢。
看來我的廢話也夠多的了，讓我們切入正題。
這個指南是單頁的，建議你等瀏覽器下載完畢后保存一份拷貝來離線閱讀。
編譯器的安裝
編譯器的安裝簡單極了，只要把您下載的文件運行一下就OK了，應該不會遇到什么
問題。但是注意安裝的最后要編譯庫文件，可能要花點時間，要視你的機器速度而定。
Lcc-Win32的一些基本概念
Lcc-Win32編譯系統是由多個文件構成的。它們的共同的任務是把文本格式的源代
碼編譯位可以運行的二進制格式。優良個重要的文件分別是編譯器（lcc.exe）和連接
器（lcclnk.exe）。
編譯器是用來把你編寫的文本翻譯成處理器可以執行的格式的程序。連接器用來轉
換編譯器生成的二進制文件（通常叫做目標文件），并添加操作系統用來把程序調入內
存并執行所需要的信息它可以把多個目標文件鏈接為一個單獨的程可執行程序，這樣就
可以使你可以把一個程序的代碼文檔分割為幾個模塊，這個能力在你開發大型程序時是
很重要的。
雖然這些聽起來好像十分的簡單，但是實際上并不是這個樣子的。編輯器和鏈接器
需要你在命令行方式下鍵入你要建立的程序的所有信息，這將需要你記住大量的命令行
參數和各種各樣的開關，這時就需要IDE——集成開發環境（wedit.exe）來提供方便了。
IDE的基本功能是編輯文本，你可以在這個環境里編輯程序的源代碼，但是遠遠不
止有這個功能。它還給你提供了一個調用編譯器和鏈接器的簡單方法，這樣在編譯程序
的時候你就不用去記住那么多的命令行參數了。
你可以簡單的把Wedit想象成你的控制臺，在這里你可以控制所有的流程。
好吧！現在你可以用你的鼠標點一下Windows的“開始”按鈕，在程序項的子菜單了
尋找“lcc-win32”，好了嗎？現在你已經準備好在Lcc-Win32中寫你的第一個程序了。
寫個小程序！
你知道嗎？自從第一個C編譯器產生以來（也許可能更早一些），有一個慣例就是
為這個編譯器寫的第一個程序是“Hello World”，我為我擁有的所有編譯器都寫過，
現在我們就來寫一個。
第一步是創建源碼文件。在“File”菜單中選擇“new”項，然后在出現的對話框
中輸入“hello.c”并點一下“OK”。
現在你看到的是一個標題為“hello.c”的空白窗口，輸入下面的代碼：
#include <stdio.h>
void main (void)
{
printf ("Hello World from LCC-Win32!\n");
}
保存我們的小程序，在“File”菜單中選擇“Save”項。
現在我們可以編譯這個程序了。選擇“Compiler”菜單中的“Compile hello.c”
調用編譯器。這時一個新窗口會出現在IDE的底部，這是信息窗口，當編譯器處理完成，
在這個窗口中將會顯示“HELLO.exe build successfully.”，如果編譯出錯，出錯信
息也將會被顯示在這里。
如果編譯出錯了，在信息窗口處雙擊信息顯示所在行，在編輯窗口內將高亮度顯示
出錯代碼行，仔細的檢查一下你寫的程序和上面我寫的一樣，這里需要注意的是C語言
是大小寫敏感的程序語言，這意味著“printf”和“Printf”對編譯器是不相同。
現在你已經編譯好了這個程序，按[Ctrl]+[F5]鍵運行一下，結果對嗎？
使用工程管理
現在你已經編譯了你的第一個程序，你可能想知道——執行文件在哪里？
回答是：我也不知道！這可能聽起來很傻（的確也是），但是這是看你在編譯程序
時的缺省目錄是什么，所以你應該在你的硬盤里搜索一個叫做“hello.exe”的文件。
你肯定不會想要每開發一個程序都要搜索一下硬盤的，這種情況下你就要使用工程。
工程是一些編譯器要知曉的建立程序所需要的信息。這包括程序源文件、編譯好的
文件的存放地點、要編譯為什么類型的可執行文件，一個好的想法是為每一個程序建立
一個工程。
事實上，對于我們的“HelloWorld”程序還是有一個工程的，Lcc=Win32會為沒有
指明工程的程序建立一個缺省的工程。選擇“Project”菜單的“Erase...”項，Wedit
會顯示一個工程列表，你會看到一個項目叫做“HELLO”，現在我們毫不留情的刪除它。
與其他的編譯器不同的是，Lcc-Win32的工程信息不是存儲在硬盤上的，而是存儲
在Windows的注冊表項里。這使得Wedit可以“記住”所有的工程，甚至于在不同的磁盤
上。但是優勢我們也需要清除我們不再使用的工程，在這種情況下，我們可以把工程信
息導出到磁盤上，然后在IDE中刪除它。看一下“Project”菜單的選項，你就會明白了。
現在你可以試著創建一個“HELLO”工程。
第一個Windows程序
你可能已經注意到了hello.exe看起來象是一個DOS程序，但是它不是的，它是一個
真正Windows程序，但是這種類型的程序被稱為Windows控制臺程序,就是在文本模式下
運行的Windows程序。如果你不相信，可以試著在Windows的純DOS環境下運行一下，你
會得到一行信息：“This program cannot be run in DOS mode”。
寫一個真正的Windows版的“HelloWorld”程序并不比控制臺的版本難多少。首先
創建一個新工程，選擇“Windows executable”代替“Console application”，點OK
后，Lcc-Win32會問你需要Wizard（生成向導）創建程序框架嗎，回答No。
#include <windows.h>
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{
MessageBox (NULL, "Hello world from Lcc-Win32!", "Hello", MB_OK);
return 0;
}
編譯并運行這個程序，你會看到一個顯示hello信息的窗口，點ok關閉退出。
不幸的是，除了這樣的小之又小的Windows程序，一般情況下Windows程序是很復雜
的，現在你已經知道了如何創建工程和編譯程序，如果你是一個Windows編程新手，去
找一些有關的書來看看，取得必要的基礎，一些Windows編程知識在下面的部分是必須
的。
如果你是一個C語言的新手，那么先好好的學一段時間再來看這個指南吧！
程序生成向導
Windows程序與文本狀態下的程序比起來要好的多，但是天上不會掉餡餅的，你想
要得到的Windows功能支持，比如：剪裁板、多任務等等要付出的是大量的復雜的代碼。
但是總還是有些辦法可以使事情變得簡單一些的。長時間以來，程序員們發現實際
上總是有些在每個程序中都相同的代碼段，所以Windows程序員通常使用模板來生成這
部分代碼。就是說源文件一般只要生成一次，就可以在任何一個新程序中使用了。只有
變化的部分才是每個程序不同的部分，顯然這些應該是可以自動的進行的。
這就是生成向導要完成的工作。你可以在它的幫助下快速的生成應用程序的框架。
這個框架事實上就是一個什么功能也沒有的一個完整的程序，也許可能只是用來顯示一
個空窗體，因為使程序完成具體的功能是你的工作。
讓我們看一下使用向導建立最簡單的應用程序的處理。
通常，第一步是創建程序代碼，然后建立一個工程。在使用向導的模式下，你并不
需要寫一行代碼，向導將為你建立它，我們直接來看建立工程各個步驟。
在“Project”菜單下選擇“create”項，給出項目名稱和路徑，選擇工程類型為
“Windows executable”，當Wedit詢問你是否要使用向導（wizard），回答“yes”，
這樣就進入了向導模式。
向導將顯示一個對話框叫做：“Application characteristics”，這是向導將在
應用程序中包含的基本特點，你可以選擇以下情況的一種：單窗口、多窗口和DLL（動
態鏈接庫），現在我們要創建一個十分簡單的單窗口小應用程序，選擇單窗口類型并確
保所有的特性復選按紐都未被選中，點擊“OK”進行處理。
現在向導將要提示你輸入信息設置主窗口的“類”，這里所說的“類”和C++中的
類是不同的，它是Windows在內存中存儲的一個結構，用來存儲正確顯示窗口所需要的
信息。最重要的是“回叫函數”（下面將具體介紹）的名稱，現在只要簡單接受默認的
屬性值，點擊“NEXT”進行處理。
這個“Generate code for the main window creation”對話框用來設定相應窗口
的信息。當主窗體被創建的時候這些信息會被傳送到相應的窗口。在這里你可以改變窗
口的標題欄的顯示內容，然后點擊“Finish”。
向導的工作就要完成了，接下來的工程創建工作是通常的一些對編譯器、鏈接器、
調試器的一些設置，這里只要簡單的接受缺省的選項就可以了。
經過上面的步驟，就完成了向導的所有的工作，你可以在IDE中看到兩個窗口，一
個是源程序編輯窗，另外的一個是用來定義應用程序的主菜單的腳本。
正象剛剛所說的那樣，這個程序框架是全功能的，可以通過編譯并運行，你可以看
到一個有菜單的窗口。唯一可以進行的操作是“File”菜單的“Exit”項，你可以使用
這個菜單項關閉這個簡單的窗口，也可以使用[Ctrl]+[Q]完成同樣的操作。
現在你可以看一下這個程序的源代碼，你會注意到這個程序比那個“Hello World!”
程序復雜了許多，我可以告訴你一個小竅門——從源代碼的結尾開始讀起，因為通常那
里才是一些功能函數的所在。
使用WeditRes創建資源
在Windows程序的開發中，資源是十分重要的部分，菜單、對話框和其它的一些用
戶接口部分都是可以象寫程序一樣的編寫的，可以簡單的作為資源包含進程序中。
如果Lcc-Win32沒有提供一個資源編輯器那么Lcc-Win32將不是一個完整的Win32編
譯程序，Lcc-Win32提供的資源編輯器叫做WeditRes，是在“lcc\bin\”路徑下。
的確，WeditRes還是在不斷的完善的過程中，也就是說還沒有開發完成。不過它已
經可以編輯一些手工編輯難以完成的資源了，比如：菜單和對話框等等。在IDE下調用
WeditRes，在“Compiler”菜單下選擇“Resources”項。
如果你正在開發的程序是用向導生成的，那么向導會產生一個資源文件，在這個文
件里至少包括菜單資源，WeditRes會打開這個資源文件，但是它不會找到相應的頭文件，
你應該為它指明頭文件的路徑。通常是在WeditRes當前工作路徑的上一級目錄。
WeditRes要找的文件通常叫做prjnamewiz.h，這里的prjname是你指定
的工程的名稱。經過這一步就可以修改工程所用的資源了。
如果你的程序不是由向導生成的，那么WeditRes會提示你輸入資源文件的文件名，輸
入一個名稱后點擊“OK”，這時WeditRes會說不能打開這個資源文件，沒有關系，這是
因為這個目錄下的確是沒有資源文件的，還是在這個對話框中點擊“OK”，然后在
“File”菜單中選擇“New”項，這樣就會為你的工程創建一個新的資源工程，鍵入一
個工程名，一般情況是和應用程序的工程名相同，然后點擊“Validate”，現在你需要
手工在應用程序工程列表里添加這個資源文件（一般以“RES”為擴展名）。
在這里試舉一例——我們來為我們上面創建的程序創建一個“關于”對話框資源。
運行WeditRes，輸入頭文件的路徑后選擇“Objects”菜單的“New dialog”項，
這時WeditRes會顯示一個對話框，標題欄為“Dialog box parameters”，改變對話框
的標題為“About this application”或者隨便其它的什么東西，然后在“Identity”
（標識符）項鍵入一個你喜歡的東西，比如：“DLG_ABOUT”，在“standard buttons”
選單中選擇“Validate”選項并點擊“OK”關閉對話框。
你在這個時候應該可以看到一個新的對話框和一個浮動的工具條，在對話框中也應
該有一個按紐，你可以用鼠標拖動它來重新指定它的位置，如果你還想改變按紐上顯示
的文字——雙擊它打開屬性對話框，或者先選定它，然后在浮動工具條下改變顯示文字。
下面我們添加一個靜態文本標簽，在工具條上選擇文本工具，光標形狀變成由一個
矩形包圍的指針，在對話框的窗體上點擊一下，一個包含文本——“Text”——的矩形
會出現在你點擊的地方，可以通過鼠標拖動來改變這個文本框的大小，同樣也可以改變
顯示的文本和文本框的位置。
我們還可以在這個對話框中添加其它的裝置。空心方框、實心方框和組件盒等可以
對這個對話框進行一些簡單的裝飾。如果你想要刪除一個裝置，選定它然后按
[Ctrl] + [X]，或者選擇“Edit”菜單的“Cut”項。還可以選擇“Options”菜單的
“Test”項測試這個對話框的外觀。在工具欄里有一個按紐的功能是相同的，就是看起
來象一個開關的那個，如果想要繼續編輯這個對話框，只要再次選擇上述選項一次即可。
編輯完成后在“File”菜單中選擇存盤，然后關閉WeditRes，為了顯示這個對話框
下面我們必須在程序中包含相應的代碼。
尋找“OnCommand”語句，在那里肯定有一個switch語句的條件之一是菜單命令
“Exit”的（IDM_EXIT）,現在我們為我們的新對話框添加一個新的case條件，輸入如
下代碼：
case IDM_ABOUT:
DialogBox (hInst, MAKEINTRESOURCE(DGL_ABOUT), hwnd, AboutDlgProc);
break;
我們還需要編寫對話框函數。
BOOL CALLBACK AboutDlgProc (HWND hwnd,UINT msg,WPARAM wParam,LPARAM lParam)
{
switch (msg)
{
case WM_COMMAND:
if (LOWORD(wParam) == IDOK)
{
EndDialog(hwnd,0);
return TRUE;
}
break;
}
return FALSE;
}
你應該已經明白了，由向導來生成代碼要簡單得多！現在編譯、鏈接這個程序，然
后運行它，選擇“Compiler”中的“Execute prj.exe”項，我們創建的對話框將顯示
在屏幕上了。
添加其它類型的資源
你還需要知道如何添加其它資源，如圖標等。
事實上WeditRes還不能編輯圖標文件，作者說正在做這方面的工作。所以你可能要
使用其它的工具來完成圖標編輯的工作。
在資源創建完后，你要把它添加到工程的資源描述文件里面去。如果你是使用向導
創建的工程。你只須要打開與工程名相同的*.RC文件就可以了。
如果你沒有使用向導，那么你只能新創建一個RC文件。如果你是使用WeditRes創建
的資源，在建立資源描述文件時有些事情是你必須知道的——必須包含WeditRes資源，
甚至于你并沒有使用任何由WeditRes創建的資源，你完全有可能在后續的工作中用到，
我建議無論什么情況都應該象下面這樣做。
WeditRes一般要建立三個文件：一個*.DLG文件、一個*.H頭文件和一個*.RES二進
制資源文件。DLG文件描述了由WeditRes創建的資源的定義（如：資源串、菜單和對話
框等），H文件是所有資源的符號名的定義，RES文件是編譯后的二進制資源文件，這個
文件將被鏈接到工程最后生成的可執行程序中。
資源描述文件（*.RC）的文件名一定要和RES文件的文件名相同，當Lcc-Win32的資
源編譯器（lrc.exe）編譯資源時將覆蓋原來的RES文件。你可以在Wedit中創建資源描
述文件，如下：
#include <windows.h>
#include "resources.h"
#include "resources.dlg"
息。
第二行包含由WeditRes產生的資源的符號名的頭文件，我在這里假定你的資源工程
名為“resurces”，可以改為你所定義的名稱。第三行是WeditRes產生的資源描述文件，
這樣不會丟失你已經創建了的資源。
下面你可以向資源描述文件中增加資源，下面是一個例子：
IDI_MYICON ICON myiconfile.ico
這一行定義了圖標資源，在使用前，一定要定義圖標的符號名。比如在“prjwiz.h”
文件（或者“resource.h”，如果你沒有使用向導）中，如果你沒有定義這個符號名，
那么編譯器將認為它是一個字符串名。
添加光標或者位圖資源的步驟是相同的，只要把關鍵字改為“BITMAP”或者
“CURSOR”。
下面要做的是把資源描述文件包含在工程文件列表中，當下一次你編譯工程，資源
編譯器也將編譯這個資源描述文件，并把產生的二進制資源鏈接到執行文件內。
這樣你可以添加圖標、光標和位圖資源，對于其它類型的資源可以使用RCDATA資源
方式添加到資源文件內，就是一系列的由逗號分隔的數值信息，這種方式可以使Lcc-Win32
的資源編譯器不支持的資源得以添加到資源文件中去，比如WAV文件等。
使用非規格資源
Lcc-win32的資源編譯器可以使用各種類型的資源，如對話框、菜單、圖標等，但
是它不能使用其它非規格的資源如多媒體文件（WAV，MID等等）。
你可能認為使用其它的資源編譯器如微軟在Win32 SDK中提供的資源編譯器，或者
其它的什么東西。
但是這里的麻煩事是LCCLINK，因為它并不認識這些資源，因此也不可能把這些資
源鏈接到你的執行文件中去，這和真是個大問題，你可能不得不使用其它的鏈接器，這
意味著可能需要其它類性的入口庫。
我認為這樣做不是一個好的解決方案，主要的原因是Wedit不是設計成可以使用其
它的鏈接器的，你將不得不在命令行下編譯你的程序，放棄了Lcc-Win32 IDE提供的全
部優點。
但是這里還是有一個可供選擇的方案，——幸運的是LRC支持RCDATA資源類型，這
種資源類型用來包含二進制數據類型的資源，使用一系列的數字列表表示。
下面是具體的實現方法：
首先你需要轉換你要使用的二進制文件到有一系列的有逗號分割數值表示的文本文
件，LRC缺省的認為這些數據是16位長的，它同時也支持32位長度的整數，只要在數值
后添加“L”字符就可以了。
你可以從這里下栽做這些工作的轉換器：
* Bin2Txt: 開發者：Josef Planeta. 十分的靈活方便；
* TextIt: 本文作者開發，可以一次轉換多個文件。
這兩個工具都帶有源碼，使用Lcc-Win32開發。
然后一定要在資源數據中包含這些整數列表，如果你的資源文件沒有使用資源描述
文件，如果你沒有使用向導生成工程，這是有很大可能的。你一定要建立一個資源描述
文件，一般是這個樣子的：
#include <windows.h> //basic Windows header file
#include "resources.h" //resource identifiers (generated by WeditRes)
#include "resources.dlg" //resource scripts (generated by WeditRes)
MySound RCDATA
BEGIN
#include "mysound.txt"
END
在這個例子中，我們包含了一個叫做“mysound.txt”的文件，這個文件是由一個
WAV文件轉換成的數據文件。
要注意當前版本的LRC（V981126）在RCDATA資源的大小上是有限制的，如果任何一
個數據文件大于70Kb，你有可能得到一個溢出信息（Overflow in resource data），
在未來的版本中可能會有所改進，但是在目前如果出現了這種情況可能只有使用其它的
資源編譯器了。
使用RCDATA類型定義資源意味著你不能直接的指定PlaySound來播放這些資源，因
為類型是不同的。
解決辦法是手工把這些數據讀入內存，下面的代碼說明了在PlaySound時要做的事情：
BOOL PlayRcSound (HINSTANCE hInst, LPCTSTR lpszSndName)
{
HRSRC hr;
HGLOBAL hg;
LPVOID lpSndData;
hr = FindResource (hInst, lpszSndName, RT_RCDATA);
if (hr != NULL)
{
hg = LoadResource (hInst, hr);
if (hg != NULL)
{
lpSndData = LockResource (hg);
if (lpSndData != NULL)
{
return PlaySound((LPCTSTR)lpSndData, NULL, SND_MEMORY);
/* We do not need to unlock or unload the resource, */
/* Windows will take care of this */
}
}
}
return FALSE;
}
如果你的資源在頭文件中定義有標識符，叫做：ID_MYSOUND，那么調用函數的方式
應該是：
PlayRcSound (hInst, MAKEINTRESOURCE(ID_MYSOUND));
另外，如果你給出了一個字符串名，比如：MySound，函數調用如下所示：
PlayRcSound (hInst, "MySound");
靜態庫和動態庫
也許程序員就是喜歡比喻以類的修辭的，庫的概念就是一個例子，它是用來存儲可
能在許多的程序中使用的代碼，或者一部分十分專業的代碼，只要寫一次就可以了，甚
至是由其他的人為你寫的代碼，這樣使用這些代碼而完全不用關心具體的實現細節。
和其它的Windows編譯器一樣，LCC-Win32也支持兩種庫——動態庫和靜態庫。
靜態庫包含的代碼在編譯鏈接時將被添加在可執行文件中，它被稱為“靜態”庫是
因為一旦它鏈接到可執行文件中，就將不可改變（除非重新編譯整個程序）。
而動態鏈接庫不會由編譯器鏈接到可執行文件中，而是在運行時由操作系統鏈接的，
這樣即使你改變了這個庫，也不會使整個可執行程序重新編譯。
靜態庫的編寫要簡單些，只要創建一個類型為“Static library (lib)”的新工程，
添加你要在這個靜態庫中使用的原始資料——函數、數據等等，編譯后就會得到一個
LIB文件，這個文件里面包括了所有你指定的函數和數據。如果你要使用這些函數或者
數據，在“Configuration”對話框中的“Linker”表里的“Additional libraries”
項中指定靜態庫名稱，通知編譯器把這個靜態庫鏈接到工程里去，但是千萬不要忘了把
你的靜態庫放到鏈接器能夠找到的地方，比如：“\lcc\lib”路徑下。
動態鏈接庫就有些麻煩了，你要使用兩個文件而不是一個文件：動態庫本身——DLL
文件和關聯入口庫——LIB文件。入口庫是給鏈接器使用的，簡單的說它使用來哄騙
鏈接器的，同時它也包含了使Windows正確的調用相應動態庫中的函數的信息。
而且，動態庫的功能可以更加的強大，它有一個LibMain()函數，在程序每一次
調用它時都要通過它來進行初始化的工作。
要創建一個動態鏈接庫，你要創建一個DLL工程，然后你可以使用向導生成LibMain()
函數。添加你要使用的函數和數據，在編譯這個工程后，你就可以得到DLL庫和接口庫
文件。
如果要使用動態鏈接庫，象使用靜態庫一樣，要將接口庫放在“\lcc\lib”路徑下，
在“Options”對話框中添加這個接口庫。同時也要把DLL文件放置在Windows能夠搜索
到的路徑下，Windows搜索動態鏈接庫的缺省目錄是“\windows\system\”和應用程序
的起始目錄，將動態鏈接庫放置在這兩個目錄下都是可以的。