Syntax
FileRoutingSlip [.Subject = text] [, .Message = text] [, .AllAtOnce = number] [, .ReturnWhenDone = number] [, .TrackStatus = number] [, .Protect = number] [, .AddSlip] [, .RouteDocument] [, .AddRecipient] [, .OldRecipient] [, .ResetSlip] [, .ClearSlip] [, .ClearRecipients] [, .Address = text]
Remarks
Adds, removes, or changes the routing slip for the active document, or routes the active document to the recipients specified by the routing slip. FileRoutingSlip is available only if Microsoft Mail is installed. The arguments for FileRoutingSlip correspond to the options in the Routing Slip dialog box (Add Routing Slip command, File menu).
Argument | Explanation |
.Subject | Text for the subject line of the electronic mail message |
.Message | The message you want to precede the icon for the attached document |
.AllAtOnce | Specifies how recipients receive the document: 0 (zero) Sends the document to the first recipient specified by .Address 1 Sends a copy of the document to all the recipients at the same time |
.ReturnWhenDone | If 1, sends the document back to the original sender when the last recipient chooses the Send command from the File menu |
.TrackStatus | If 1, sends a message back to the original sender each time the document is forwarded |
Argument | Explanation |
.Protect | Specifies a level of protection for the document: 0 (zero) No protection 1 All changes are tracked by revision marks. 2 Recipients can add annotations only. 3 Recipients can enter information in form fields only. |
.Address | The address of a recipient for the document you are routing. To add multiple recipients, use multiple FileRoutingSlip instructions to add them one at a time. If you are routing the document to recipients one at a time, add recipient names in the order you want to route the document. |
Only one of the following arguments can be specified for each FileRoutingSlip instruction.
Argument | Explanation | |
.AddSlip | Adds a routing slip to the active document. Note that when you close a document with an attached routing slip, Word displays a message asking if you want to route the document. To suppress this message in a macro that contains DocClose, FileClose, FileCloseAll, or FileExit instructions, set the .Save argument for those statements to 1 or 2. Word closes the document or documents without routing them. | |
.RouteDocument | Routes the active document. | |
.AddRecipient | Adds the address specified by .Address to the list of recipients. | |
.OldRecipient | Adds the address specified by .Address to the list of recipients only if the document has not already been routed. When you record a modification to a routing slip for a document that has already been routed, FileRoutingSlip instructions with .OldRecipient arguments are recorded for recipients who have already received the document. | |
.ResetSlip | Prepares the document to be rerouted to the recipients. If the document has not completed its first routing, Word displays a message. | |
.ClearSlip | Removes the routing slip from the active document. | |
.ClearRecipients | Removes all addresses from the list of recipients. | |
Example
This example adds a routing slip to the active document (which includes the current date in the subject line), adds two recipients, and then routes the document:
curdate$ = Date$(Now())
FileRoutingSlip .Subject = "Status Doc " + curdate$, \
.Message = "Please fill in your status.", .AllAtOnce = 0, \
.ReturnWhenDone = 1, .TrackStatus = 1, .Protect = 1, .AddSlip
FileRoutingSlip .Address = "Sara Levine", .AddRecipient
FileRoutingSlip .Address = "Carlos Alicea", .AddRecipient
FileRoutingSlip .RouteDocument
See Also
FileSendMail