delphi资源文件使用_Delphi如何使用资源文件

布满荆棘的人生 2022-12-06 15:42 228阅读 0赞

delphi资源文件使用

From bitmaps to icons to cursors to string tables, every Windows program uses resources. **Resources** are those elements of a program that support the program but are not executable code. In this article, we will walk through some examples of the use of bitmaps, icons, and cursors from resources.

从位图到图标，再到游标再到字符串表，每个Windows程序都使用资源。 **资源**是程序中支持程序但不是可执行代码的那些元素。 在本文中，我们将介绍一些使用资源中的位图，图标和光标的示例。

## 资源位置 **(** Location of Resources **)** ##

Placing resources in the .exe file has two main *advantages*:

将资源放在.exe文件中有两个主要*优点* ：

*  The resources can be accessed more quickly because it takes less time to locate a resource in the executable file than it does to load it from a disk file.
    
    可以更快地访问资源，因为在可执行文件中定位资源所花的时间比从磁盘文件中加载资源所花费的时间少。
 *  The program file and resources can be contained in a single unit (the .exe file) without the need for a lot of supporting files.
    
    程序文件和资源可以包含在单个单元(.exe文件)中，而无需大量支持文件。

## 图像编辑器 **(** The Image Editor **)** ##

First of all, we need to create a resource file. The default extension for resource files is .**RES**. Resource files can be created with Delphi's Image Editor.

首先，我们需要创建一个资源文件。 资源文件的默认扩展名是。 **RES** 。 可以使用Delphi的图像编辑器创建资源文件。

You can name the resource file anything you want, as long as it has the extension ".RES" and the filename without the extension is not the same as any unit or project filename. This is important, because, by default, each [Delphi project][] that compiles into an application has a resource file with the same name as the project file, but with the extension ".RES". It's best to save the file to the same directory as your project file.

您可以将资源文件命名为任意名称，只要它的扩展名为“ .RES”，且不带扩展名的文件名与任何单位或项目的文件名都不相同。 这很重要，因为默认情况下，每个编译成应用程序的[Delphi项目][Delphi project]都具有与项目文件同名的资源文件，但扩展名为“ .RES”。 最好将文件保存到项目文件所在的目录中。

## 在应用程序中包含资源 **(** Including Resources in Applications **)** ##

In order to access our own resource file, we have to tell Delphi to link our resource file in with our application. This is accomplished by adding a compiler directive to the source code. This directive needs to immediately follow the form directive, like the following:

为了访问我们自己的资源文件，我们必须告诉Delphi将我们的资源文件链接到我们的应用程序。 这是通过在源代码中添加编译器指令来实现的。 该指令需要立即遵循form指令，如下所示：

{$R *.DFM} {$R DPABOUT.RES}

Do not accidentally erase \{$R \*.DFM\} part, as this is the line of code that tells Delphi to link in the form's visual part. When you choose bitmaps for speed buttons, Image components or Button components, Delphi includes the bitmap file you chose as part of the form's resource. Delphi isolates your user interface elements into the .DFM file.

不要意外删除\{$ R \* .DFM\}部分，因为这是告诉Delphi链接到表单可视部分的代码行。 当为速度按钮，图像组件或按钮组件选择位图时，Delphi会包含您选择的位图文件作为表单资源的一部分。 Delphi将您的用户界面元素隔离到.DFM文件中。

To actually use the resource, you must make a few [Windows API][] calls. Bitmaps, cursors, and icons stored in RES files can be retrieved by using the API functions *LoadBitmap*, *LoadCursor,* and *LoadIcon* respectively.

要实际使用资源，您必须进行几次[Windows API][]调用。 可以分别使用API函数*LoadBitmap* ， *LoadCursor*和*LoadIcon*来检索RES文件中存储的位图，光标和图标。

## 资源中的图片 **(** Pictures in Resources **)** ##

The first example shows how to load a bitmap stored as a resource and display it in a *TImage* component.

第一个示例显示如何加载存储为资源的位图并将其显示在*TImage*组件中。

procedure TfrMain.btnCanvasPic(Sender: TObject);var bBitmap : TBitmap;begin
     bBitmap := TBitmap.Create;try
     bBitmap.Handle := LoadBitmap(hInstance, 'ATHENA');
     Image1.Width := bBitmap.Width;
     Image1.Height := bBitmap.Height;
     Image1.Canvas.Draw(0,0,bBitmap);finally
     bBitmap.Free;end;end;

Note: If the bitmap that is to be loaded is not in the resource file, the program will still run, it just won't display the bitmap. This situation can be avoided by testing to see if the *bBitmap.Handle* is zero after a call to *LoadBitmap()* and taking the appropriate steps. The [try/finally][try_finally] part in the previous code doesn't solve this problem, it is just here to make sure that the bBitmap is destroyed and its associated memory is freed.

注意：如果要加载的位图不在资源文件中，则程序仍将运行，只是不会显示位图。 通过在调用*LoadBitmap()*之后进行测试以查看*bBitmap.Handle*是否为零并采取适当的步骤，可以避免这种情况。 先前代码中的[try / finally][try_finally]部分无法解决此问题，只是在此处确保bBitmap被销毁并释放其关联的内存。

Another way we can use to display a bitmap from a resource is as follows:

我们可以用来显示资源中位图的另一种方法如下：

procedure TfrMain.btnLoadPicClick(Sender: TObject);begin
     Image1.Picture.Bitmap.
     LoadFromResourceName(hInstance,'EARTH');end;

## 资源中的游标 **(** Cursors in Resources **)** ##

*Screen.Cursors\[\]* is an [array][] of cursors supplied by Delphi. By using resource files, we can add custom cursors to the Cursors property. Unless we wish to replace any of the defaults, the best strategy is to use cursor numbers starting from 1.

*Screen.Cursors \[\]*是Delphi提供的游标[数组][array] 。 通过使用资源文件，我们可以将自定义光标添加到Cursors属性。 除非我们希望替换任何默认值，否则最佳策略是使用从1开始的光标编号。

procedure TfrMain.btnUseCursorClick(Sender: TObject);const NewCursor = 1;begin
     Screen.Cursors[NewCursor] :=
     LoadCursor(hInstance,'CURHAND');
     Image1.Cursor := NewCursor;end;

## 资源中的图标 **(** Icons in Resources **)** ##

If we look at Delphi's *Project-Options-Application* settings, we can find that Delphi supplies the default icon for a project. This icon represents the application in the Windows Explorer and when the application is minimized. We can easily change this by clicking the 'Load Icon' button.

如果我们查看Delphi的*Project-Options-Application*设置，我们会发现Delphi为项目提供了默认图标。 此图标代表Windows资源管理器中的应用程序以及应用程序最小化的时间。 我们可以通过单击“加载图标”按钮轻松更改此设置。

If we want, for example, to animate the program's icon when the program is minimized, then the following code will do the job.

例如，如果我们要在最小化程序时对程序的图标进行动画处理，则以下代码将完成此工作。

For the animation, we need a *TTimer* component on a form. The code loads two icons from resource file into an array of *TIcon* objects; this array needs to be declared in the public part of the main form. We'll also need *NrIco*, that is an Integer type [variable][], declared in the **public** part. The *NrIco* is used to keep track of the next icon to show.

对于动画，我们需要窗体上的*TTimer*组件。 该代码将两个图标从资源文件加载到*TIcon*对象数组中。 该数组需要在主表单的公共部分声明。 我们还需要在**公共**部分声明的*NrIco* ，它是一个Integer类型的[变量][variable] 。 *NrIco*用于跟踪要显示的下一个图标。

public
     nrIco : Integer;
     MinIcon : array[0..1] of TIcon;
    ...procedure TfrMain.FormCreate(Sender: TObject);begin
     MinIcon[0]:=TIcon.Create;
     MinIcon[1]:=TIcon.Create;
     MinIcon[0].Handle:=LoadIcon(hInstance,'ICOOK');
     MinIcon[1].Handle:=LoadIcon(hInstance,'ICOFOLD');
     NrIco:=0;
     Timer1.Interval:=200;end;
    ...procedure TfrMain.Timer1Timer(Sender: TObject);beginif IsIconic(Application.Handle) then begin
     NrIco:=(NrIco+1) mod 2;
     Application.Icon:=MinIcon[NrIco];end;end;
    ...procedure TfrMain.FormDestroy(Sender: TObject);begin
     MinIcon[0].Free;
     MinIcon[1].Free;end;

In the *Timer1.OnTimer* event handler, *IsMinimized* function is used to see whether we need to animate our main icon or not. A better way of accomplishing this would be to capture the maximize/minimize buttons and than act.

在*Timer1.OnTimer*事件处理程序中，使用*IsMinimized*函数查看我们是否需要对主图标进行动画处理。 更好的方法是捕获最大化/最小化按钮，然后执行操作。

## 最后的话 **(** Final Words **)** ##

We can place anything (well, not everything) in resource files. This article has shown you how to use resources to use/display bitmap, cursor or an icon in your Delphi application.

我们可以在资源文件中放置任何内容(不是全部)。 本文介绍了如何在Delphi应用程序中使用资源来使用/显示位图，光标或图标。

Note: When we save a Delphi project to the disk, Delphi automatically creates one .RES file that has the same name as the project (if nothing else, the main icon of the project is inside). Although we can alter this resource file, this is not advisable.

注意：当我们将一个Delphi项目保存到磁盘时，Delphi会自动创建一个与该项目同名的.RES文件(如果没有其他说明，则该项目的主图标位于其中)。 尽管我们可以更改此资源文件，但这是不可取的。

> 翻译自: [https://www.thoughtco.com/how-delphi-uses-resource-files-4077232][https_www.thoughtco.com_how-delphi-uses-resource-files-4077232]

delphi资源文件使用

[Delphi project]: https://www.thoughtco.com/beginners-guide-to-delphi-programming-1057657
[Windows API]: https://www.thoughtco.com/guide-to-developing-delphi-programs-1058446
[try_finally]: https://www.thoughtco.com/handling-errors-and-exceptions-1058212
[array]: https://www.thoughtco.com/array-as-a-function-return-type-1057837
[variable]: https://www.thoughtco.com/definition-of-variable-958320
[https_www.thoughtco.com_how-delphi-uses-resource-files-4077232]: https://www.thoughtco.com/how-delphi-uses-resource-files-4077232