INI文件
配置设置(INI)文件是Windows操作系统中的一种特殊ASCII文件,以“ini”为文件扩展名。该文件也被称做是初始化文件(Initialization file)和概要文件(Profile),通常应用程序可以拥有自己的配置设置文件来存储状态信息。一般来说私有的配置设置文件比较小,这样可以减少程序在初始化时读取配置文件时的信息量,从而提高程序的启动速度、提高应用程序和系统的性能。如果待存取的信息涉及到Windows系统环境或是其他应用程序时, 就必须在Windows系统的配置文件win.ini中记录并在访问的同时发送WM_WININICHANGE消息给所有的顶层窗口,通知其他的程序系统配置文件已做了更改。但由于win.ini中不仅记录了系统的有关信息,也存储着许多其他应用软件的配置数据,所以访问的数据量要远比私有的配置文件大得多。
配置文件里的信息之所以能为系统和众多的软件所读取并识别,是由于其内部对数据的存取采用了预先约定的“项-值对(entry-value pairs)”存储结构, 并对待存取的数据分门别类地进行条理清晰的存储。下面是系统目录下win.ini文件的部分内容:
[windows]
load=
run=
NullPort=None
[Desktop]
WallpaperStyle=2
Pattern=(无)
配置文件把信息分成若干“节”,节标题放在方括号中,如“[Desktop]”就是Desktop节,在一个节内包含了一些与之相关的“项”,并通过等号对其进行赋值。一般的形式如下:
[SECTION]
ENTRY=VALUE
其中VALUE值可以有两种类型: 数值型和字符串型。Windows操作系统专门为此提供了6个API函数来对配置设置文件进行读、写:
GetPrivateProfileInt() 从私有初始化文件获
取整型数值
GetPrivateProfileString() 从私有初始化文件获
取字符串型值
GetProfileInt 从win.ini获取整数值
GetProfileString 从win.ini获取字符
串值
WritePrivateProfileString 写字符串到私有初始
化文件
WriteProfileString 写字符串到win.ini
这里需要指出: 当向配置文件存储信息时,不论是数据还是字符串都要先转换成字符串,然后再进行存储。
API函数的应用
按照通常的编程习惯,在程序刚开始运行时对配置设置文件进行读取访问,获取存储在其中的数据,并按照这些数据对程序进行配置,比如可以决定加载哪些组件、显示的位置等等。存储一般比较灵活,可以显式地由用户发送命令来执行,也可以在程序退出前把当前状态存储其内,以便下次运行时能恢复到上次退出时的界面。下面就通过几个程序片段对前面提到过的访问配置文件的API函数的使用进行介绍。
我们可以把视图类的OnInitialUpdate 函数作为程序启动时读取配置文件的入口,配置文件的存储格式如下:
[SECTION 1]
XPos=300
YPos=200
[SECTION 2]
Text=Hello
这里仅有两个节,XPos和YPos标明了待显示信息的坐标,而待显示的信息存储在第二节的Text项中,用访问私有配置设置文件的API函数将其分别读入到变量m_nXPos、m_nYPos和m_strText中,并通过Invalidate调用OnDraw函数,在其内用TextOut函数将该信息在读取的坐标位置显示出来:
m_nXPos=GetPrivateProfileInt(
“SECTION 1”, //节名
“XPos”, //项名
0, //没找到此项时的缺省返回值
“C://test//debug//test.ini”);
//配置文件的准确路径
m_nYPos=GetPrivateProfileInt(“SECTION 1”,“YPos”,0,exeFullPath);
char buf[256];
len=GetPrivateProfileString(
“SECTION 2”, //节名
“Text”, //项名
“No Text”, //没找到此项时的返回值
buf, //目标缓冲区地址
256, //目标缓冲区长度
“C://test//debug//test.ini”);
//配置文件的准确路径
for(int i=0;i CString str;
str.Format(“%c”,buf[i]);
m_strText+=str;
}
Invalidate();
一般配置文件是和应用程序存放在同一个目录中的,如果用“C://test//debug//test.ini”的绝对路径进行设置就会出现路径改变后找不到配置文件的问题,所以应动态搜寻配置文件的存放地址:
TCHAR exeFullPath[MAX_PATH];
//MAX_PATH在API中有定义,为128
int len=GetModuleFileName(NULL,
exeFullPath, //应用程序全路径存放地址
MAX_PATH);
CString path=“//test.ini”; //配置文件名
::strcpy(exeFullPath+len-13,path);
//组合出配置文件的全路径
写配置文件也基本类似,只是需要把数值类型的变量格式化成字符串再行存储:
str.Format(“%d”,m_nXPos);
WritePrivateProfileString(“SECTION 1”,“XPos”,str,exeFullPath);
str.Format(“%d”,m_nYPos);
WritePrivateProfileString(“SECTION 1”,“YPos”,str,exeFullPath);
WritePrivateProfileString(“SECTION 2”,“Text”,m_strText,exeFullPath);
这样的程序常遇到: 在执行过一遍以后,重启系统会自动加载该程序,其实除了在启动菜单和注册表添加信息外,也可以用WriteProfileString函数向win.ini的“windows”节的“run”项目添加应用程序的全路径来实现,这要比其他两种方法简便得多,而且也比较安全。
实践中,采用ini配置设置文件是Windows下配置系统和应用软件的一种非常普遍的方法,合理地使用该配置文件,不仅能增强软件的自身功能,也可以加强同系统、其他应用软件的相互联系,使我们的程序更加灵活。