/*
* Copyright (c) 2016, 桂林电子科技大学计算机中心  甘才军
* All rights reserved
*
* 文件名称：myconfig.h
* 文件标识：myconfig.h
* 摘    要：利用xml文档实现对程序参数的存储与读取
*
* 当前版本：1.0
* 作    者：甘才军
* 完成日期：2016.5.15
*
*/
#ifndef myconfigH
#define myconfigH
#include<vcl.h>
#include<XMLDoc.hpp>

class TMyConfig
{
public:
/*
* 方法介绍：构造函数
* 输入参数：
*       xmlfilename：保存程序中的参数的xml文档的完整路径，例如:c:\config.xml
*       fieldNames：待保存的参数的名称，多个参数名称之间用|隔开，例如：
*                   name|gender|birthday
*       doc:在窗体设计期间放置在窗体上的TXMLDocument对象的指针
* 输出参数：无
* 返回值  ： 无
* 使用示例：  无
*/
    TMyConfig(AnsiString&xmlfilename,AnsiString&fieldNames,TXMLDocument*doc);

/*
* 方法介绍：从参数配置文件中读取指定字段的值
* 输入参数：fieldName，待读取的参数（或字段）的名称
* 输出参数：无
* 返回值  ：字段的值
* 使用示例：无
*/
    AnsiString GetValue(AnsiString fieldName);
/*
* 方法介绍:保存某个参数的值到配置文件中
* 输入参数：fieldName,参数名；value，参数值
* 输出参数：无
* 返回值  ：无
* 使用示例：无
*/
    void SetValue(AnsiString fieldName,AnsiString value);
    ~TMyConfig();
protected:
    TXMLDocument*Doc;
    
/*
* 方法介绍：判断一个文件的扩展名是否为.xml,若不是返回false
* 输入参数：filename,文件名
* 输出参数：无
* 返回值  ：为合法的xml文档，返回true,否则返回false
* 使用示例：
*/
    bool IsValidConfigFileName(AnsiString& filename);

/*
* 方法介绍:创建一个名为filename的xml文件，并在其中写入指定字段名，每个字段为空值
* 输入参数：
*       filename:待创建的xml文件说明
        fieldNames：待存储的参数（或字段）的名字,具体解释参考构造函数
* 输出参数：无
* 返回值  ：无
* 使用示例：无
*/
    void CreateMyConfigFile(AnsiString& filename, AnsiString& fieldNames);

    void Save();
};
#endif