CDocTemplate::GetDocString

项目
03/01/2013

检索字符串关联的文件类型。

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

参数

rString
对于将包含字符串的 CString 对象的引用，因此当函数返回。
Index — 索引
从描述文件类型的字符串检索的子字符串的索引。此参数可以具有下列值之一：
- 例如在应用程序窗口标题栏的CDocTemplate::windowTitle 名称(“，Microsoft Excel”)中。仅存在于SDI应用程序的文档模板。
- CDocTemplate::docName 支持该默认文档名称(例如，“页”）。此根，以及数字，对于此类型的新文档的默认名称使用，只要用户从"文件"菜单选择新命令(例如，“Sheet1”或“Sheet2”）。如果未指定，则“没有权限”使用作为默认值。
- CDocTemplate::fileNewName 名称的此文件类型。如果应用程序支持多个文档类型，该字符串在文件的对话框(例如，“工作表”)显示。如果未指定，则文件类型使用文件的命令不可访问的。
- 文件类型和通配符筛选器匹配的CDocTemplate::filterName 演示文档此类型。此字符串在类型中的文件在文件打开对话框(例如，“工作表(*.xls) ")显示在下拉列表。如果未指定，则文件类型使用文件打开命令不可访问的。
- CDocTemplate::filterExt 扩展文档此类型(例如，“.xls”）。如果未指定，则文件类型使用文件打开命令不可访问的。
- 在注册数据库中存储的文件类型的CDocTemplate::regFileTypeId 标识符维护由Windows。此字符串仅供内部使用(例如，“ExcelWorksheet”）。如果未指定，则文件类型不能向Windows文件管理器注册。
- 在注册数据库中存储的文件类型的CDocTemplate::regFileTypeName 名称。此字符串(例如访问注册数据库的对话框会显示应用程序(，“Microsoft Excel工作表”）。

返回值

非零，如果找到指定的子字符串;否则为0。

备注

调用该函数检索描述文件类型的一个特定子字符串。包含这些子字符串的字符串在文档模板存储和"资源文件的字符串派生应用程序的。框架调用对于应用程序的用户界面需要的此函数获取字符串。如果您指定了应用程序的文件名扩展文档，该结构还调用此函数，在将项添加到Windows注册数据库时;这允许文档从Windows文件管理器中打开。

仅当您从 CDocTemplate，派生您的选件类调用此函数。