1sapscriptforms(编辑修改稿)

1sapscriptforms(编辑修改稿)内容摘要：

址栏窗口、包含参考消息的信息窗口、包含公司相关数据的窗口以及包含真正业务数据的窗口（业务数据也显示在 subsequent page 中）和包含页码的窗口组成。 包含业务数据的窗口不同于其他窗口。 无论什么时候，只要一页数据显示不下时，会自动显示在 subsequent 中。 因而，这个窗口控制换页，而且这种窗口只能有一个，在 SAPscript form 中称这种窗口为 main window. 如下 图所示： SAP Script 编程指南 稀世软件系统（上海）有限公司 6/56 Paragraph Formats and Attributes 在 SAPscript 中， Paragraph(段落 )就是使用某种格式和相应属性的一种格式设置。 通过应用不同的段落属性组来简化文本处理，这些属性组包括：  标准属性  字体  Tabs  Outline 对一个段落标志命名有下面的约定束成：  段落名由一到两个字符组成；  第一个字符必须是字母，第二个字符可以是字母、数字或者空格；特殊字符无效；  段落格式在 Description 域中必须进行标识。 段落格式设置画面如下： SAP Script 编程指南 稀世软件系统（上海）有限公司 7/56 下面分别对前面的属性组加以说明： 1） 标准属性 在标准属性组中，可以设置在段落格式中需要用到的通用属性，包括： 描述信息 (Description) 左边右边距 (Left margin, Right margin) 第一行的缩进 (indent 1st line) 前后空格 (Space before, Space after) 对齐方式 (Alignment) 行间距 (Line spacing) 是否空行 (No blank lines) 是否页面保护 (Page protection) 同一页上是否有下一个 段落 (Next paragraph same page) 2） Font 属性 可以为段落格式指定字体属性，用来控制文本中的字体。 字体属性包括字体、大小、黑体 /粗体 /斜体、下划线等等。 、 3） Tabs in Paragraph Formats 可以根据需要为每个段落格式定义 tabs 的位置，在 pc editor 中两个 ”,”symbol 代表段落中的一个 tabs。 可以使用下面的度量单位来定义 tabs 的位置： SAP Script 编程指南 稀世软件系统（上海）有限公司 8/56 CH (字符 ) CM (厘米 ) MM(毫米 ) PT(点阵 ) TW(1/20 点 ) 4） Outline 用来指定文档中的 层次和目录结构。 具体请参见 sap online help Character Formats and Attributes Character formats and Attributes 可以用来格式段落中的一段文字。 命名方式与段落一样。 字符属性组可以是：  Standard  Font Standard 属性包括 marker(标记或者超连接 )、 Barcode、 Protected、 Hidden、 Superscript 等。 Font 属性与段落中的 Font 属性一样使用。 Windows Windows 在 Form维护中定义。 代表页面中的一个区域（ Page Window），每一个 Form中至少定一个 window，否则， SAPscript 不能格式化文本。 可以为 window定义类型和名字，注意在每一个 Form中只能有一个 Main window。 在定义一个 Form Window的时候，必须选择一个窗口类型。 下面是可以使用的窗口类型：  Main Window 每一个 Form 必须有一个 MAIN 类型的窗口，这样的窗口叫做 Main Window。 在 SAPscript 中主窗口具有下面的意义： 1） 控制换 页； 2） 包含可以跨越多个 pages 的内容； 3） 可以在 page window中固定文本元素，比如列标题。 一旦 main window内容填满后，就会自动换页，在下一页的 main window 中继续输出余下的内容。 而且格式保持不变。 注意：如果 page 中没有 main window，系统会隐含处理 page 中的其他 window 以及 subsequent page，在这种情况下， SAPscript 会在处理完（最多）三个 subsequent pages 后终止处理。 为了输出 header line 或者 totals，需要指定 main window中的输出区域 (output area)。 为了在页面（ page）中的 main window中进行文本输出，可以选择三种类型的区域之一。 Main window中的顶层区域叫 TOP Area；下层区域叫 BOTTOM Area；它们之间的区域叫做 BODY Area。 TOP Area 和 BOTTOM Area 的大小依赖于各自的文本内容， BODY Area 的大小相应的发生变化。 如下图所示： SAP Script 编程指南 稀世软件系统（上海）有限公司 9/56 在 Form输出时，可以对这三个区域的内容进行动态修改。 SAPscript 在包含 main windwo 的 Form的每一页上自动输出这些区域。 当在调用函数模块 WRITE_FORM 或者 WRITE_FORM_LINES 时， TYPE 参数决定在哪一个区域输出文本，如果在调用时，没有指定 TYPE 参数，系统默认输出 BODY 区域的内容。 比如下面的图示以及代码： SAP Script 编程指南 稀世软件系统（上海）有限公司 10/56  VAR Window（可变窗口） 可变窗口的内容在每一个 page 中都要处理一次。 系统输出仅仅适合窗口尺寸，超出窗口的文本被自动截掉；可变窗口也不会触发换页处理。 不象 CONST Window， page window如果声明为 VAR Window，意味着在不同的 Form pages 中可以有不同的尺寸。 注意：在窗口内容处理方面，系统并不区分 CONST Window 和 VAR Window，唯一的区别就是在全部 Form中具有同样尺寸。  CONST window（常量窗口） 从版本 开始，在系统内部处理中，并不区分 CONST Window 和 VAR Window，所以，如果创建一个新的 window，总是使用 VAR 类型的。 Pages(页面 ) 对每一个 Form 必须定义至少一个 page，而且必须在 Form 的 header 属性标签中指定“ first” page。 否则，不能进行文本格式化。 另外，应该指定当到达第一页的末尾的时候，接下来的一页是哪页。 如果没有指定的话，输出就在当前页的末尾终止。 为了定义一个 page，需要为它指定名字和属性：  下一页的名字  page 的计数模式  page 数的数字类型  资源名字  打印模式 文档的单个 pages 通常有不同的 layouts：发票的第一页与接下来的页不一样，在这些页上不需要重复通用信息，比如地址或者客户数据，象窗口中的文本元素一样， page 也有名字，在有需要换页的情况下，需要通过这些名字来指定下一页，如果想文档的样式变化越多 ，就需要在 SAPscript 中定义越多的 page。 下图说明如何利用事务代码 SE71 维护一个 page。 在 WIN32 操作系统中可以利用 Form Painter。 SAP Script 编程指南 稀世软件系统（上海）有限公司 11/56 Pages window(页面窗口 ) Pages window 就是定义在页面中的窗口 ,这里的页面和窗口都是已经预先定义好的 ,定义 pages window 的主要任务就是将窗口和页面关联起来，一个页面中可以有多个窗口。 在定义 pages windows 时，窗口的名字与 page 的名字关联起来。 必须指定分配给 page 的窗口的位置和大小。 通过指定左边和上边距来定义窗口的位置，指定其高度和宽度来定义窗口的大小。 注意： 1)在所有 pages 中的 main window 的宽度必须相同。 其他的窗口类型在不同的 pages 中可以有不同的尺寸和位置。 2)为了打印多列，需要在一个 page 中定义多个 main window。 因为文本条目是连续的，一旦第一个 main window 被写满之后，输出可以在第二个窗口继续。 当定义 windows 和 pages 的时候，可以不必指定位置和输出的文本间隔。 为了指定这些值，可以直接创建一个 page window。  当定义 page window 时，需要指定：  显示在 page 上的 window  window 的尺寸（包括大小、宽度、高度）  页面中各个 window 的位置 如下图所示： SAP Script 编程指南 稀世软件系统（上海）有限公司 12/56 Text Elements (文本元素 ) SAPscript 将 form中的单个文本组件称之为 Text Elements(文本元素 )，为了获得较好的结构和可读性，可以为 form 中的每一个 Text Elements 分配一个固定的名字，打印程序通过这些定义的名字来访问 Text Elements。 Text Elements 与 window 相关，就是说，打印程序仅仅能够调用定义在窗口中的文本元素。 下图显示了定义在 main window 中的 HEADING 和 FLIGHTIST 两个 Text Elements。 SAP Script 编程指南 稀世软件系统（上海）有限公司 13/56 可以将这里定义的 Text Elements 和 ABAP 程序中（比如 TEXT001）定义的文本相比较来学习，但是， Text Elements 比 ABAP 程序中（比如 TEXT001）定义的文本更灵活，主要表现在：  Text Elements 的长度没有限制；  Text Elements 可以包含变量符；  在一个 Text Elements 中可以 使用几个不同的格式选项；  在 Text Elements 中可以使用 SAPscript 控制语句。 在 window中，可以使用两种不同的 Text Elements，一种叫做有名 Text Elements；另外一种叫做无名 Text Elements。 1） 有名 Text Elements 通过段落格式“ /E”来识别有名 Text Elements，在行编辑器中，看起来象这样： 字符串 NAME代表 Text Elements的名字，名字可以有 30 个长度，而且可以包含字母、数字、特殊字符。 名字后面接下来就是这个 Text Elements 的文本行。 一个 Text Elements 在下一个 Text Elements 开始处结束。 注意： Text Elements 的名字仅仅在本地有效（ LOCAL），即不同的窗口可以包含相同的 Text Elements 的名字。 SAP Script 编程指南 稀世软件系统（上海）有限公司 14/56 为了输出有名 Text Elements，必须在程序中 (ABAP)使用函数模块 WRITE_FORM。 下图说明了发票中的列头 Text Elements。 2） 无名 Text Elements 无名 Text Elements 或者叫做缺省文本元素是这样的一些文本行和控制语句， 它们显示在 相。