GetContextService PowerScript function
Description
Returns a reference to a context-specific instance of the
specified service.
Controls
Any object
Syntax
|
1 |
<span>GetContextService</span> ( <span>servicename</span>, <span>servicereference</span> ) |
|
Argument |
Description |
|---|---|
|
servicename |
String specifying the service object.
|
|
servicereference |
PowerObject into which the function places |
Return Values
Integer. Returns 1 if the function succeeds
and a negative integer if an error occurs. The return value -1 indicates
an unspecified error.
Usage
Call this function to establish a reference to a service object,
allowing you to access methods and properties in the service object.
You must call this function before calling service object functions.
In Windows applications, you can use ContextKeyword or Keyword
as the servicename argument when you get an instance of the ContextKeyword service.
On all EAServer platforms
except AIX, you must use Keyword.
Using a CREATE statement
You can instantiate these objects with a PowerScript CREATE statement. However,
this always creates an object for the default context (native PowerBuilder
execution environment), regardless of where the application is running.
Examples
This example calls the GetContextService function
and displays the class of the service in a single line edit box:
|
1 |
Integer li_return |
|
1 |
ContextKeyword lcx_key |
|
1 |
|
1 |
li_return = this.<span>GetContextService</span> & |
|
1 |
("Keyword", lcx_key) |
|
1 |
sle_classname.Text = ClassName(lcx_key) |
|
1 |
... |