ph_locatehandle PowerHome formula function
Description
Locates and returns the handle of a process identifed by the specified parameters.
Syntax
ph_locatehandle ( parentexe, parentclass, parenttitle, parentinstance, parentflags, childclass, childtitle, childinstance, childflags )
| Argument |
Description |
|
parentexe
|
String. A string representing the filename of the parent processes executable.
|
|
parentclass
|
String. The class of the process that is the parent of the process to be located.
|
|
parenttitle
|
String. The title of the window that is the parent of the process to be located.
|
|
parentinstance
|
Integer. The instance of the parent whose child process you're locating. The first instance is 0.
|
|
parentflags
|
Integer. Flags representing which of the previous parameters to use for locating the parent. Individual values should be added. 1 - Use parentexe, 2 - Use parentclass, 4 - Use parenttitle exact, 8 - Use parenttitle partial.
|
|
childclass
|
String. The class of the child process you're searching for.
|
|
childtitle
|
String. The title of the child process you're searching for.
|
|
childinstance
|
Integer. The instance of the child process you're searching for. The first instance is 0.
|
|
childflags
|
Integer. Flags that determine which of the child parameters to use. Individual values should be added. If the handle to locate is identified by the parent, use 0 to ignore the child parameters. 1 - Use child parameters, 2 - Use childclass, 4 - Use childtitle exact, 8 - Use childtitle partial.
|
Return value
Long. Returns the handle of the located process. Use the PowerHome "Object Spy" window for help in populating this function.