命令函数教学课件.ppt
几个重要的命令函数,MailSendImplodeExplodeReplaceElementsMemberWordSelectSubsetTrimPromptReturnDialogBoxDbColumn DbLookupPickList,MailSend,有两种使用方法：1,不带参数,将当前文档邮寄给Sendto域中指定的收件人.(该文档必须建立Sendto域) MailSend2,带参数,按照参数列表所提供的信息构造一个新的邮件. MailSend (sendto;copyto;blindcopyto;subject;remark;bodyfields;flags)注意:在BODYFIELDS中域名用引号,多个用冒号作为列表,flag标志,表明信笺的优先级和安全级别,sign用标识符进行电子签名Priorityhigh优先级别高ReturnReceipt接受者看到信息时通知发送者Encrypt用接受者的公用密匙加密文档,只有持有与之相匹配的个人密匙的接受者才能访问该文档.DeliverReportConfirmed通知发送者邮件传送是否成功.IncludeDocLink在信息中包含一个文档链接,指向使用此函数时已经打开或选定的文档,Implode,连接文本列表中的所有成员并返回一个文本字符串。Implode( textlistValue ) orImplode( textlistValue ; separator )textListValue文本或文本列表。包含您想连接到一单个字符串中的条目列表。如果您发送单个文本而不是列表的话，Implode 返回该文本不变。separator文本。用于在连接字符串中分隔值的分隔符。如果您没有指定分隔符separator，则使用一个空格作为分隔符。返回值implodedString文本。包含 textListValue 中每个成员的字符串，由分隔符separator分开。,Explode,返回由文本串或日期范围元素组成的文本列表。 如果您指定一个文本串，元素被定义为单词（如果它们被空格分开）或由指定分隔符分隔的从句。 如果您指定一个时间-日期范围，元素被定义为在该范围内的某些天。 语法Explode( dateRange )Explode( string )Explode( string ; separator )Explode( string ; separator ; includeEmpties ),当 Explode 用于日期范围，别忘了一定要指定一个有效的时间-日期范围，而不是用字符串表示。例如，Explode（ "05/01/96 - 05/02/96"）是不正确的，因为其参数是字符串。 应使用 Explode（ 05/01/96 - 05/02/96 ）,Replace在文本列表中执行查找-替换操作。,语法Replace( sourcelist ; fromlist ; tolist )参数sourcelist文本列表。您想扫描其值的列表。fromlist文本列表。包含您想要替换的值的列表。tolist文本列表。包含替换数值的列表。 返回值replacedList文本列表。包含有与 fromlist 中的值相匹配的 sourcelist 被对应在 tolist 中的值替换。如果在 fromlist 中的值没有与 sourcelist 的值相匹配的，则返回未改变的 sourcelist 。,sourcelistfromlisttolistresultRedOrange Black RedOrange Blue Brown Black (替换"Orange")Yellow YellowGreen Green,Elements计算列表中文本、数字、时间-日期的个数。该函数总是返回一个数字以指明在列表中的项目个数。,语法Elements( list )参数list文本列表，数字列表，或时间-日期列表。返回值numElements数字。在列表中元素的个数。如果域值是一个空字符串，Elements（列表）返回数字0。,Member给定一个值，在文本列表中找到该值的位置。,语法Member( value ; stringlist )参数value文本。您想在 stringlist 中找到其位置的值。stringlist文本列表。返回值position数字。如果 value 不包含在 stringlist 中，则返回 0；如果 value 包含在 stringlist 中，则返回 1 到 n ， 1 到 n 是 value 在 stringlist 中的位置。,Word 从一个字符串里返回指定的单词。单词是字符串的一部分，用定义的分隔符分开。例如，如果你定义一个空格作为分隔符，那么一个单词是前面和后面各跟一个空格的任意字符系列（或者用引号指出字符串的起始位置）。,Word( string ; separator ; number )语法string文本或文本表。要扫描的字符串。separator文本。用来分隔 string 里的单词的字符。number数字。指出你想从 string 返回的那个单词的位置。返回值word文本或文本表。string 里由 number 指定位置的单词；例如，如果 number 为 3，Word 返回 string 里的第三个单词。如果扫描的是一个文本表，Word 按列表格式返回文本表里各项在指定位置的单词。,Select返回出现在数字所指定的位置上的值。如果数字本身大于值的数量，则 Select 返回值列表的最后一个。如果在数字指定的位置上是一个值的列表，则返回整个列表。,语法Select( number ; values )参数number数字。您想取得的值所在的位置编号。values由逗号分开的任意多的值。该值可以是数字、文本、时间日期、或数字列表、文本列表、时间日期列表。,Subset从左到右搜索一个列，并返回您所指定数量的的值。如果您指定了一个负数，Subset 将从右到左搜索，但结果却是按从头到尾的次序排列。,语法Subset( list ; number )Parameterslist文本列表，数字列表，或者时间-日期列表。您想抽取子集的一个列表。number数字。您想从列表中取得的值的数目。返回值subsetList文本列表，数字列表，或者时间-日期列表。您所抽取的列表子集。,Trim删除文本字符串或文本列表的每一个元素中的开头、结尾、和多余的空格。,语法Trim( string )参数string文本或文本列表。返回值trimmedString文本或文本列表。删去多余的空格的 string。 用法如果一个文本字符串都是空格，Trim 将返回一个空字符串（长度为 0 ）。如果一个文本列表的一个元素都是空格，Trim 将删除该元素。如果一个文本列表的所有元素都是空格，Trim 将返回一个空字符串。,Prompt为用户显示一个对话框，并返回文本值，该值基于用户在对话框中采取的操作。Prompt 用来给用户提示信息并根据用户的输入确定操作过程。Prompt( style : No Sort ; title ; prompt ; defaultChoice ; choiceList ),参数style 常量。指示您想显示的对话框样式。可以是以下中的任意项：OK YesNo YesNoCancel OkCancelEditOkCancelList OkCancelCombo OkCancelEditComboOkCancelListMult Password NoSorttitle 文本。您想显示在对话框标题栏的文本。Prompt 文本。您想显示在对话框中的文本。对任何一种样式都需要。如果您对 prompt 使用公式并且该公式返回一个列表，则只有列表中的第一项作为提示prompt 被显示。为了能显示全部的列表，使用 Implode。NewLine 不能用于 prompt 中。defaultChoice 文本。该值用做用户输入的缺省值。对话框的输入部分必须先灌入该值；用户既可以选择“确定”接受它也可以用其它值替换它。不应用于确定, 是否, 是否取消, 密码样式的对话框。对其它样式需要。对于确定取消列表多项，您可以指定多个缺省值作为文本列表 “item1”：“item2”。 choiceList 文本列表。您想显示在对话框中列表框的值。用户可以选择其中之一作为输入。用冒号将这些值分开，如 揚HONE.NSF?MailDbName。在您列表中的每个值可以是文本串， “函数”返回文本串。只对于样式确定取消列表, 确定取消组合,确定取消编辑组合, 确定取消列表多项需要。,返回值choice如果用户输入一值，返回该值作为文本。如果用户选择“是”，返回1（真）。如果用户选择“否”，返回0（假）。如果用户选择“取消”，公式判定停止。异常情况是是否取消，如果用户选择“取消”，返回 -1。 用法在域公式、按钮、快捷键、手工代理、表单操作、视图操作公式中使用 Prompt。该函数不工作于列、选择、邮件代理，或定时代理公式中，并在窗口标题和表单公式中有一定作用。,Return立即停止公式的执行并返回指定值。当如果某个条件为真，您只想要执行公式的剩余部分时，该公式很有用。,语法Return( value )参数value您想返回的值。您可以指定另一个“函数”，如 Error，或者一个文本串 ，如揊ormula stopped，或者一个布尔值（真或假）。如果您不想返回任何值，则使用空串（“”）。返回值result返回 value 。用法Return 主要用于域公式、运行公式的代理、按钮、快捷键。通常地，您使用它和 If 以确定是否执行 Return 或执行一个或多个语句。,DialogBox弹出一个对话框显示当前正使用你指定表单的文档。用户和平常一样与表单和文档交互，不需要时选择“确定”或“取消”。,DialogBox( form ; AutoHorzFit : AutoVertFit : NoCancel : NoNewFields : NoFieldUpdate : ReadOnly ; title )参数form 文本。表单名字。AutoHorzFit关键字。可选。水平缩放对话框以适应布局区域。AutoVertFit关键字。可选。垂直缩放对话框以适应布局区域。NoCancel关键字。可选。显示仅仅带有“确定”按钮的对话框。如果这个关键字被忽略，对话框就包含“确定”和“取消”按钮。NoNewFields关键字。可选。不将文件添加到在对话框表单而不是基准表单中的基准文档。NoFieldUpdate关键字。可选。从对话框中的域到基准文档，没有通过编辑（例如，如果在 Queryclose script 中为对话框正在别的地方通过通过编辑）。ReadOnly关键字。可选。禁止编写对话框（例如，您正在使用对话框显示帮助信息界面）。如果关键字被忽略，对话框是读 - 写的。这个关键字的使用请参阅 NoCancel。title文本。对话框的标题。缺省为“Lotus Notes”。,DbColumn (Notes 数据库)从当前数据库或别的 Notes 数据库的视图或文件夹里查找并返回一个完整的列值。,DbColumn( class : "NoCache" ; server : database ; view ; columnNumber )select columnnumber from database.view参数class文本。指出你正在存取的数据库的类型。你可以用“”或“Notes”来说明一个 Notes 数据库。"NoCache"关键字。 可选。如果你不用“NoCache”，查询结果将被缓存，即结果将保存以备重用。只要执行该查询的数据库仍然打开，以后对同一位置的查询将重用这些信息。如果你忽略该选项，你不必用其它东西来代替。查询将自动缓存，但你也可以定义“Cache”以增强可读性。,server : database文本表。服务器的位置和数据库的文件名。请参阅“定义服务器和数据库”。view文本。进行搜索的视图或文件夹名。视图名必须和视图属性框里定义的全名一样（可以忽略同义词）。如果视图从菜单上的另一个名字层叠下来，将那个名字也包含进来。请参阅下面的“定义视图名字”。columnNumber数字。当你使用一个列号时，Notes 找出视图里所有和指定的关键字匹配的文档，并对各文档返回在指定列显示的值，而不关心显示这些数据用到的公式。请参阅“定义列号”。返回值valuesFound文本或文本表。返回值由你指定的视图列确定。请参阅下面的“存取找到的值”。,DbLookup (Notes 数据库)给定一个关键字值，在一个指定的视图（或文件夹）里查找，找出视图里的第一个排序列里包含关键字值的所有文档。对每个选中文档，DbLookup 返回视图里指定列的内容或者一个指定域的内容。,语法DbLookup( class : "NoCache" ; server : database ; view ; key ; fieldName ) 或DbLookup( class : "NoCache" ; server : database ; view ; key ; columnNumber )select fieldname(or columnnumber) from database.view where key in (column1),PickList显示一个模型窗口，包含您指定的视图，用户可从中选择一个或多个文档。 PickList 返回选择的文档中的列值。地址对话框，从可获得的通讯录中显示信息。用户可以选择一个或多个人、组、服务器名， PickList 返回这些名字。语法PickList( Custom ; server : file ; view ; title ; prompt ; column )或PickList( Name : Single )select column from database.view,尽管 Picklist(Custom) 操作与 DbColumn 和 DbLookup 相似，PickList 更可取，这是因为它存储更多的数据它执行查询的速度更快它允许您通过键入开始的几个字符快速定位到想要的文档PickList 不象 DbColumn 和 DbLookupdoesn't 能提供一个 NoCache 选项，因为查询结果从来不被存储。每执行一次 PickList，就执行一个新的查询。 在日历视图，PickList 显示从今天开始的两天，没有时间跟踪.。用户可以单击日期搜集按钮导航另的日子。,
