C_CG::File::SpecificationHeader 属性指定要在规范文件开头生成的多行文件头。
C 中 SpecificationHeader 属性的缺省内容如下所示:
/*******************************************************
Rational Rhapsody Developer for C : $Rational RhapsodyVersion
Login : $Login
Component : $ComponentName
Configuration : $ConfigurationName
Model Element : $FullModelElementName
//! Generated Date : $CodeGeneratedDate
File Path : $FullCodeGeneratedFileName
*******************************************************/
文件头格式字符串可以包含下列任何关键字:
- $ProjectName 表示项目名称。
- $ComponentName 表示组件名称(例如,HelloWorld)。
- $ConfigurationName 表示配置名称(例如,HelloWorld)。
- $ModelElementName 表示映射到文件的元素的名称。如果有多个元素,那么这是第一个元素的名称。
- $FullModelElementName 表示映射到文件的元素的,包含完整的路径的名称(例如,Default)。如果有多个元素,那么这是第一个元素的名称。
- $CodeGeneratedDate 表示生成日期。
- $CodeGeneratedTime 表示生成时间。
- $Rational RhapsodyVersion 表示生成文件的 IBM® Rational® Rhapsody® 版本(例如,7.5)。
- $Login 表示生成文件的用户。
- $CodeGeneratedFileName 表示所生成文件的名称。
- $FullCodeGeneratedFileName 表示完整的文件名(例如,HelloWorld\Default.h)。
- $Tag 表示指定元素的标记的值。
- $Property 表示具有指定名称的元素属性的值。
为了避免冗余编译,Rational Rhapsody 将避免对具有特殊字符串前缀(由 C_CG::File::DiffDelimiter 属性定义)的特定行进行非必要的更改。缺省的 DiffDelimiter 值为 //!。关键字的解析顺序如下:
- 预定义的关键字(例如 $Name)
- 属性关键字
- 标记关键字
请注意下列事项:
- 可以将关键字括在圆括号中。例如:
$(名称)
- 如果某个关键字的值是 MultiLine,那么除第一行以外的每个新行都将以 C_CG::Configuration::DescriptionBeginLine 属性的值开头;每一行都以 C_CG::Configuration::DescriptionEndLine 属性的值结尾。