Difference between revisions of "Extensions.HMI.ScreenClosedEventSource"

From emotive
Jump to navigation Jump to search
Line 1: Line 1:
 
{{DISPLAYTITLE:  ''' ScreenClosedEventSource'''}}[[Category:HMI]]
 
{{DISPLAYTITLE:  ''' ScreenClosedEventSource'''}}[[Category:HMI]]
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | ScreenClosedEventSource | Screen used as an event source when the window | [[Term]] | [[Extensions.HMI|OTX HMI extension]] | [[HMI related terms]] | - | - }}
+
{{ClassificationActivity | ScreenClosedEventSource |Accepts a Screen object that is to be made an event source| [[Term]] | [[Extensions.HMI|OTX HMI extension]] | [[Extensions.HMI#Terms|HMI related terms]] | - | - }}
  
 
== OTL Syntax ==
 
== OTL Syntax ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
EventSourceTerm = Hmi.ScreenClosedEventSource(ScreenHandle);
+
EventSource = HMI.ScreenClosedEventSource(ScreenTerm);
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== Description ==
 
== Description ==
The '''ScreenClosedEventSource''' term takes a ''screen'' to object, from an event source is made. This term allows for OTX sequence a ''screen'' as an event source in connection with the OTX [[Extensions.EventHandling|EventHandling]] library to use. A ''screen'' will trigger an event if the specified ''screen'' is closed.
+
The '''ScreenClosedEventSource''' term accepts a ''Screen'' object that is to be made an event source. This term enables an OTX sequence to use a ''Screen'' as a source for events in the context of [[Extensions.EventHandling|the OTX EventHandling extension]]. A ''Screen'' shall trigger an event every when the specified screen is closed. This can be used within a '''event:WaitForEventAction''' to continue execution after a screen was closed.
 +
 
  
 
{{TermReturnValue| [[Extensions.EventHandling.EventSource|EventSource]] | Event source from a screen object.}}
 
{{TermReturnValue| [[Extensions.EventHandling.EventSource|EventSource]] | Event source from a screen object.}}
Line 16: Line 17:
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| Screen | [[Extensions.HMI.Screen|Screen]] | [[Term]] | - | [1] | The screen, which is connected the event source}}
+
{{TableRowPropertie1| Screen | [[Extensions.HMI.Screen|Screen]] | [[Term]] | - | [1] | Represents the Screen that shall be connected to the event source.}}
 
|}
 
|}
  
 
== OTL Examples ==
 
== OTL Examples ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
package Hmi.ScreenSignature ScreenSignature1(ref Integer ScreenInOutParameter1);
+
package HMI.ScreenSignature ScreenSignature1(ref Integer ScreenInOutParameter1);
 +
 
 +
/// Global Declarations
  
 
public procedure main()
 
public procedure main()
 
{
 
{
  Hmi.Screen ScreenHandle1;
+
/// Local Declarations
  Integer ScreenInOut1;
+
 
  EventHandling.EventSource EventSource1;
+
HMI.Screen ScreenHandle1;
 +
Integer Integer1;
 +
EventHandling.EventSource EventSource1;
 +
 
 +
/// Flow
  
  Hmi.OpenScreen(ScreenSignature1, false, {ref ScreenInOutParameter1 = ScreenInOut1}, ScreenHandle1);
+
HMI.OpenScreen(ScreenHandle1, ScreenSignature1, {ScreenInOutParameter1 = Integer1}, false);
  Hmi.CloseScreen(ScreenHandle1);
+
HMI.CloseScreen(ScreenHandle1);
  EventSource1 = Hmi.ScreenClosedEventSource(ScreenHandle1);
+
EventSource1 = HMI.ScreenClosedEventSource(ScreenHandle1);
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 08:30, 28 September 2018

Classification

Name ScreenClosedEventSource
Short Description Accepts a Screen object that is to be made an event source
Class Term
Extension OTX HMI extension
Group HMI related terms
Exceptions -
Checker Rules -
Standard Compliant Yes

OTL Syntax

EventSource = HMI.ScreenClosedEventSource(ScreenTerm);

Description

The ScreenClosedEventSource term accepts a Screen object that is to be made an event source. This term enables an OTX sequence to use a Screen as a source for events in the context of the OTX EventHandling extension. A Screen shall trigger an event every when the specified screen is closed. This can be used within a event:WaitForEventAction to continue execution after a screen was closed.


Return Value

The Term returns the value, see table below.

Icons Note.png In OTX, Terms are categorized according to its return data type!
Data Type Description
EventSource Event source from a screen object.

Properties

Name Data Type Class Default Cardinality Description
Screen Screen Term - [1] Represents the Screen that shall be connected to the event source.

OTL Examples

package HMI.ScreenSignature ScreenSignature1(ref Integer ScreenInOutParameter1);

/// Global Declarations

public procedure main()
{
	/// Local Declarations

	HMI.Screen ScreenHandle1;
	Integer Integer1;
	EventHandling.EventSource EventSource1;

	/// Flow

	HMI.OpenScreen(ScreenHandle1, ScreenSignature1, {ScreenInOutParameter1 = Integer1}, false);
	HMI.CloseScreen(ScreenHandle1);
	EventSource1 = HMI.ScreenClosedEventSource(ScreenHandle1);
}

See also

IsScreenClosedEvent
ScreenIsOpen