MFC TN035 在Visual C++中使用多个资源文件和头文件

  • 格式:doc
  • 大小:65.50 KB
  • 文档页数:9

MFC TN035 在Visual C++中使用多个资源文件和头文件

翻译:kingyo

本文描述了Visual C++是如何支持在一个工程或者多个工程中共享多个资源文件和头文件的,以及我们如何利用它。本文回答如下这些问题:

 当想把一个工程拆分成多个资源文件和头文件时,该怎么做?

 如何在两个.RC文件中共享一个公共头文件?

 如何将工程资源拆分成多个.RC文件?

 Visual C++是如何管理.RC,.CPP,.H文件之间的编译依赖的?

应该清楚,如果为工程增加一个额外的资源文件,ClassWizard是不会理会这个文件中的资源的。下面的几点是用来回答以上的问题的:

 Visual C++管理资源文件和头文件的概述 描述了Visual C++的“Resource Includes”(资源包含)命令是如何让我们可以在一个工程中使用多个资源文件和头文件的。

 AppWizard创建的.RC文件和.H文件的分析 考察由AppWizard创建的应用程序所使用的多个资源文件和头文件,这些文件是我们要加入到工程中的资源文件和头文件的绝好参照。

 包含额外的头文件 描述了该在什么时候增加多个头文件,以及详细做法。

 在两个.RC文件之间共享一个头文件 展示了如何在不同工程(也可能是同一个工程)的多个.RC文件中共享一个头文件。

 在同一个工程中使用多个资源文件 描述了该在什么时候将工程拆分成多个.RC文件,以及详细做法。

 设置成不允许Visual C++编辑的文件 描述了如何确定Visual C++不会无意中改掉一个自定义的资源。

 管理在Visual C++可编辑.RC文件中共享的符号 描述了如何在多个.RC文件中共享相同的符号,以及如何避免出现重复的ID值。

 管理.RC,.CPP,.H文件依赖 描述了Visual C++是如何避免对依赖资源符号的.CPP文件产生不必要的重编译。

 Visual C++如何管理资源包含信息 展示了Visual C++是如何跟踪多个(嵌套).RC文件和一个.RC文件中包含的多个头文件的。

Visual C++管理资源文件和头文件的概述

Visual C++以捆绑的方式管理一个单独的.RC文件及其相应的.H文件。当修改并保存.RC文件中的资源时,会间接地修改并保存了相应.H文件。虽然可以同时打开多个.RC文件(用Visual C++的MDI界面),但是对于给定的.RC文件只能间接修改一个相应的头文件。

符号头文件(Symbol Header File)

默认时Visual C++总是将相应的头文件命名为RESOURCE.H而不管资源文件的名字(如MYAPP.RC)。使用Visual C++的“Resource Includes”命令,可以通过在“Resource Includes”对话框中更新“Symbol Header File”来改变这个默认头文件的名字。 只读符号指令(Read-Only Symbol Directives)

虽然Visual C++只为给定的.RC文件维护一个头文件,但是它也支持引用其他的只读头文件。使用“Resource Include”命令,你能在“Read-Only Symbol Directives”中指定任意数量的其他只读头文件。“只读”的限制表明当在.RC文件中增加一个新资源时,能使用在只读头文件中定义的符号,但是当删除资源时,这个符号仍然留在只读头文件中。不能改变只读符号的值。

编译时指令(Compile-Time Directives)

Visual C++也支持资源文件的嵌套,一个.RC文件可以被另外一个#include(包含)。当用Visual

C++编辑一个给定的.RC文件时,任何在#include语句中的资源都是不可见的,但是当编译.RC文件时,这些在#include语句中的资源也被编译。使用“Resource Include”命令,能指定任意数量的.RC文件作为编译时指令。

要注意当Visual C++读入一个包含了其他.RC文件但不指定为编译时指令的.RC文件时会发生什么,产生这种情况的原因可能是给了Visual C++一个以前用文本编辑手工维护的.RC文件。当Visual C++读入被包含的.RC文件时会将它与父.RC文件合并。当保存父.RC文件时,#include语句就会由被包含的资源替代。如果不希望这种合并发生,应当在Visual C++读入之前把#include语句从父.RC文件中删除。然后再用Visual C++把同样的#include语句加到“Compile-Time Directives”。

Visual C++在#include指令符和TEXTINCLUDE资源中保存一个.RC文件中用到的上述三种资源包含信息(符号头文件、只读符号指令、编译时指令)。TEXTINCLUDE资源,一般情况下不需要处理,这在Visual C++如何管理资源包含信息中有说明。

AppWizard创建的.RC文件和.H文件的分析

查看AppWizard产生的应用程序代码能使我们了解Visual C++是如何管理多个资源文件和头文件的。下面的代码是从一个由AppWizard在默认选项下产生的MYAPP应用层程序中摘录的。

一个AppWizard创建的应用程序使用多个资源文件和头文件,就像下图显示的那样:

RESOURCE.H AFXRES.H

\ /

\ /

MYAPP.RC

|

|

RES\MYAPP.RC2

AFXRES.RC

AFXPRINT.RC

能通过Visual C++的“Resource Include”命令参看这几个文件之间的关系。

MYAPP.RC 应用程序的资源文件,用Visual C++编辑。

RESOURCE.H

是应用程序专用的头文件,AppWizard总是称之为RESOURCE.H,这与Visual C++默认的头文件一致。#include是这个资源文件(MYAPP.RC)的第一个语句:

//Microsoft Visual C++ generated resource script

//

#include "resource.h"

RES\MYAPP.RC2

包含了不由Visual C++编辑但是包含到最终编译的.EXE中的资源。AppWizard默认不产生这样的资源,因为Visual C++能处理所有的标准资源,包括版本信息。AppWizard只产生一个空文件,万一需要自定义格式的时可用。

当需要自定义格式的资源,将其加入到RES\MYAPP.RC2,并用Visual C++的文本编辑器编辑。

AFXRES.RC和AFXPRINT.RC

包含框架所需特定特性的标准资源。与RES\MYAPP.RC2一样,这两个框架提供的资源文件包含在MYAPP.RC的结尾,同时他们也在“Resource Include”对话框的“Compile-Time

Directives”中指定。这样在Visual C++中编辑MYAPP.RC时,不能直接看到或者编辑这些框架提供的资源,但是他们会被编译到应用程序的二进制.RES文件和最终的.EXE中。更多关于框架的标准资源,包括修改的方法,请看Technical Note 23.

AFXRES.H

定义了框架尤其是AFXRES.RC使用的标准符号,如ID_FILE_NEW。AFXRES.H也#include

WINRES.H,它是WINDOWS.H的一个子集,包含了Visual C++产生的.RC文件所需的符号。在编辑应用程序资源文件(MYAPP.RC)时,AFXRES.H中定义的符号是有效的,如ID_FILE_NEW在MYAPP.RC中的菜单资源“File New”中用到。不能改变或者删除这些框架定义的符号。

包含额外的头文件

AppWizard创建的应用程序只包含两个头文件:RESOURCE.H和AFXRES.H,只有RESOURCE.H是应用程序的。在下面的一些情况下,可能需要包含只读的头文件:

头文件由外部提供,或者希望在多个工程或者一个工程的多个部分共享头文件。

头文件中包含不希望Visual C++更改的或者在保存时要过滤的格式和内容。例如,也许希望保留使用符号运算的#define:

#define RED 0

#define BLUE 1

#define GREEN 2

#define ID_COLOR_BUTTON 1001

#define ID_RED_BUTTON (ID_COLOR_BUTTON + RED)

#define ID_BLUE_BUTTON (ID_COLOR_BUTTON + BLUE)

#define ID_GREEN_BUTTON (ID_COLOR_BUTTON + GREEN) 可以通过“Resource Include”命令在只读符号指令中指定第二个#include语句来包含额外的只读头文件:

#include "afxres.h"

#include "second.h"

新的关系图现在看起来像这样:

AFXRES.H

RESOURCE.H SECOND.H

\ /

\ /

MYAPP.RC

|

|

RES\MYAPP.RC2

AFXRES.RC

AFXPRINT.RC

在两个.RC文件之间共享一个头文件

也许希望在不同工程或者同一工程的两个.RC文件之间共享一个头文件。要做到这点,仅需对两个.RC都使用上述的只读符号指令。当两个.RC文件是来源于不同的应用程序(不同的工程)时,结果如下图所示:

RESOURCE.H AFXRES.H RESOURCE.H

(for MYAPP1) SECOND.H (for MYAPP2)

\ / \ /

\ / \ /

MYAPP1.RC MYAPP2.RC

/ \ / \

/ \ / \

RES\MYAPP1.RC2 AFXRES.RC RES\MYAPP2.RC2

AFXPRINT.RC

第二个头文件被一个程序(工程)的两个.RC文件共享的情况在下面讨论。

在同一个工程中使用多个资源文件

通过一个.RC文件#include另外一个.RC文件的方式,Visual C++和资源编译器支持同一个工程中使用多个资源文件,多重嵌套也是允许的。将工程资源文件拆分成多个资源文件的原因有几个: