CDocTemplate::GetDocString

virtual BOOL GetDocString(CString& rString, enum DocStringIndex index)const;

返回值:如果找到指定的子串,则返回非零值,否则为0。

参数:
rString函数返回时,包含字符串的CString对象的一个参考。
index描述文档模板的字符串的子串索引,可取下列值之一:
·CDocTemplate::WindowTitle窗口标题条上出现的名字(如:“Microsoft Excel”),只有在SDI应用的文档模板中出现。
·CDocTemplate::DocName缺省文档名称(如:“Sheet”)。该名称加上一个数字一起作为该类型新文档的缺省名字,不论用户何时选择File菜单中的New 命令(如:“Sheet 1”或“Sheet 2”)。如果未指定,使用“Untitled”作为缺省值。
·CDocTemplate::FileNewName文档类型名字。如果应用支持多个文档类型,则该字符串显示在File New对话框中(如:“WorkSheet”)。如果未指定,使用File New命令访问不到文档类型。
·CDocTemplate::FilterName与文档类型匹配的文档类型各过滤器的描述。该字符串显示在File Open对话框的文件类型下拉列表中(如:“WorkSheet”(*.xls))。如果未指定,使用File Open命令得不到文档类型。
·CDocTemplate::FilterExt文档类型的扩展名(如:“.xls”)。如果未指定,使用File Open命令访问不到文档类型。
·CDocTemplate::RegFileTypeID保存在Windows 的注册数据库中的文档类型的标识。该字符串只用于模板使用(如:“ExcelWorkSheet”)。如果未指定,Windows 文件管理器将不登记该类型。
·CDocTemplate::RegFileTypeName注册库中保存的文档类型名称。在访问注册库的应用的对话框中会得到显示(如:“Microsoft Excel WorkSheet”)。

说明:
调用该成员函数获得描述文档类的子串信息。含有子串字符串保存在文档模板中并由资源文件中的字符串派生得到。框架调用该函数获得应用的用户界面所需的字符串。如果应用文档指定文档扩展名,在向Windows注册库添加入口时,框架也会调用该函数,这就允许在Windows 文件管理器中打开文档。
如果从CDocTemplate中导出自己的类,则调用该函数。

请参阅:
CMultiDocTemplate::CMultiDocTemplate, CSingleDocTemplate::CSingleDocTemplate, CWinApp::RegisterShellFileTypes