Run Event

Applies To   See Also

Occurs when an Active Document is ready to run user code.

Syntax

PROCEDURE ActiveDoc.Run
LPARAMETERS cHyperlinkTarget

Parameters

cHyperlinkTarget

cHyperlinkTarget is a parameter that is passed to the Run event from a URL (Universal Resource Locator) when HTTP (Hypertext Transfer Protocol) is used to run an Active Document. The parameter is passed as character data, and is appended in the URL to the name of the Active Document with a pound sign (#). For example, the following URL passes the character string “TargetString” to the Run event in an Active Document named MyActiveDoc:

Http://MyServer/MyActiveDoc.APP#TargetString

Note that the pound sign (#) is passed as the first character to cHyperlinkTarget. You can use SUBSTR( ) to remove the leading pound sign, as in the following Run event code:

LPARAMETERS cHyperLinkTarget
cNewTarget = SUBSTR(cHyperLinkTarget, 2, LEN(cHyperLinkTarget))

Remarks

The Run event should be the starting point for your Active Document application. Typically, the Run event contains code that executes your menu code, executes the main form in the application, and contains READ EVENTS to start event processing.

You can put setup code in your Active Document’s Init event, but if the code takes too long to execute, the Active Document container may generate a time out error. If you do put setup code in the Init event, it should not require user interaction or create a user interface.