Programming with Reflection

image\rwnprg32.gif DefineHotspot method

 

Syntax object.DefineHotspot String, Flags, Commands

 

Description

Defines a hotspot. Starting with version 6.1 of Reflection for IBM, this method has been superceded by DefineHotspotEx. It is present for compatibility with scripts created using older versions of Reflection.

Arguments

String Argument type: String
The text on the screen that Reflection will identify as a hotspot.

Flags Argument type: Enumeration
Specifies criteria for determining if a string should be identified as a hotspot:

 rcMatchAll

 Specifies that all screen text that matches the given hotspot string should be identified as a hotspot, regardless of whether the case matches exactly or whether the string is delimited by spaces.

 rcMatchCase

 Specifies that Reflection should consider case in determining whether screen text matches the given hotspot.

 rcMatchWhole

 Specifies that Reflection should only look for strings preceded and followed by one or more spaces in determining whether screen text matches the given hotspot.

 rcMatchCaseWhole

 Specifies that Reflection should consider both case and delimiting spaces.

Commands Argument type: String
The Reflection method, or sequence of methods, to be executed when the hotspot is clicked. Methods that return values can't be used. Use a space to separate multiple methods. Use double quotation marks around string arguments. For example, the following strings are all valid for this argument:

      "Connect"

      "TransmitAnsi ""Hello"" TransmitTerminalKey rcIBMEnterKey"

      "RunMacro ""MyMacro"", """""

 This string can be up to 260 characters long.

Note: This command is still supported, but is no longer used in recorded scripts. It has been superceded by the expanded DefineHotspotEx method

 

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command