---
title: "Application"
canonical: "https://docs.cuesystem.com/space/CVCHELP/555843654/Application"
format: markdown
---
> Macro (toc)

---

# GetProcessesCount

This function returns the count of running processes in the CUEunit.** ** 

#### Syntax 

```visualbasic
Function GetProcessesCount(ByRef info As _ProcessesCount) As Boolean
```

#### Parameters 

info 

<u>[_ProcessesCount](/wiki/spaces/CVCHELP/pages/555843654/Application#Structure-_ProcessesCount)</u><u> </u>- the destination structure. 

#### Return value 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u> 

***True*** All done. 

***False***  

# GetRunningApplicationName

This function returns the name of the running application.** ** 

#### Syntax 

```visualbasic
Function GetRunningApplicationName(ByRef applicationname As Text) As Boolean
```

#### Parameters 

applicationname 

<u>[Text](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Text)</u> - the destination of the applicationname text. 

#### Return value 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u>

***True*** All done. 

***False*** The parameter applicationname is too short. 

# Structure _ProcessesCount

This structure is predefined in the firmware of all units, which supports functions with ith _ProcessesCount structure. 

#### Syntax 

```visualbasic
Structure _ProcessesCount 
  Var RunningProcesses As Long 
  Var MaxOfRunnningProcesses As Long 
  Var RunningRemotelyStartedFunctions As Long 
  Var MaxOfRunnningRemotelyStartedFunctions As Long 
  Var RunningSystemProcesses As Long 
End Structure
```

RunningProcesses

Number of users running processes 

MaxOfRunnningProcesses

Maximum number of running user’s processes allowed by firmware 

RunningRemotelyStartedFunctions

Number of running remotely started function 

MaxOfRunnningRemotelyStartedFunctions

Maximum number of running remotely started function allowed by firmware 

RunningSystemProcesses

Number of running system processes  

# HideApplication

This function hides (minimizes) the application window on the pcCUE or ipCUE-omega. See ShowApplication. 

#### Syntax 

```visualbasic
Function HideApplication()
```

# IsDesignLayoutMode

This function returns true* *if* *the XPL code is interpreted in the design layout mode in IDE.  

#### Syntax 

```visualbasic
Function IsDesignLayoutMode()As Boolean
```

#### Return value 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u> Function returns true if the XPL code is running in the design layout mode in IDE. 

# IsSimulationMode

This function returns ***True*** when the controller is running in the simulation mode. That means a virtual controller on the PC. 

#### Syntax 

```visualbasic
Function IsSimulationMode()As Boolean
```

#### Return value 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u>

***True ***Controller is running in the simulation mode on the PC. 

***False*** Controller is running on the real machine (for example on the ipCUE alpha). 

# OnBecomeActive

This event is generated on aCUE or iCUE in the situation when the XPL application goes to the front. 

#### Syntax* *

```visualbasic
Event OnBecomeActive As Process ()
```

#### Example 

```visualbasic
Process OnBecomeActiveHandler() Link OnBecomeActive 
  // some activities 
End Process
```

# RunExe

This function starts the external application. This command is available only in appCUE on Windows OS. 

#### Syntax 

```visualbasic
Function RunExe(
  exefile As Text, 
  Optional parameters As Text := "", 
  Optional showwindow As Boolean := True) 
As Boolean
```

#### Parameters 

exefile 

<u>[Text](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Text)</u> – executable application filename.  

parameters 

<u>[Text](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Text)</u> – application parameters. 

showwindow 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u> – If True window with the application will be visible. If False window with the application will be hidden (it is useful for command line application)  

#### Return value 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u>

***True***  Application has been successfully started. 

#### Example 

```visualbasic
RunExe("C:\\Program Files\\Internet Explorer\\iexplore.exe","www.google.com")
```

# StartApplication

This function stops running application and starts the application entered in the parameter.** ** 

#### Syntax 

```visualbasic
Function StartApplication(
  applicationname As Text, 
  Optional setasautorun As Boolean := False) 
As Boolean
```

#### Parameters 

applicationname 

<u>[Text](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Text)</u> - application to start.  applicationname is case sensitive and could be entered with extension cvca or without. If StartApplication is called within appCUE, the applicationname parameter must be set to the Site name defined in the [appCUE settings](https://cue.atlassian.net/wiki/spaces/ACSG/pages/319029269).

setasautorun 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u> – The default value is False. If it is True command starts the application and sets it as autorun. 

#### Note 

The function always returns False in Simulation mode. 

#### Return value 

<u>[Boolean](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean)</u> This function returns True on success or False if an error occurs. 

The function GetLastError returns the error number. The errors that can happen: <u>[217](https://cue.atlassian.net/wiki/spaces/CVCHELP/pages/510525445/Command+errors#217)</u>.  

***Examples**** *

```visualbasic
StartApplication("Controller1_secondapplication")
```

```visualbasic
StartApplication("Controller1_secondapplication.cvca")
```

# ShowApplication

The function can be used for showing the application on the display. Only in the pcCUE or ipCUE-omega. See HideApplication. 

#### Syntax 

```visualbasic
Function ShowApplication ()
```