Private c'tor - initialize using NewLC()

Destructor. Frees resources owned by the object prior to deletion.

Gets the command code from the launch information.

See the description of SetCommandL.

SetCommandL TApaCommand

Acts as a second constructor and completes a commandline object from the aMessage object.

Extracts and returns the default (startup) screen that was specified in the command line.

Gets the document name from the launch information.

Returns the index of a process environment-slot for public use (in other words, one that is not used internally by CApaCommandLine). The number of slots available for public use is returned from NumberOfEnvironmentSlotsForPublicUse(), (this value may be increased over time). The returned value can then be passed into any of the Open(TInt,...) functions on RSessionBase, RMutex, RChunk, RCondVar, etc, or into User::GetTIntParameter(), User::GetDesParameter(), etc, depending on the type of the object in that environment slot.

Gets the executable name from the launch information.

Constructs a command line object.

If command line information is provided in the environment-slots it creates command line object from process environment-slots, else creates it from the information returned by User::CommandLine().

It can be called from a context where there is no CTrapCleanup.

Calling this function more than once in a process is not supported and will result in an empty command line being returned. If an application wants to inspect any part of its command line, it should override CEikAppUi::ProcessCommandParametersL(CApaCommandLine& aCommandLine) and call the base class implementation if required.

CEikAppUi::ProcessCommandParametersL(CApaCommandLine& aCommandLine).

Opens (by handle) the file that was passed into SetFileByHandleL by the process launching the local application.

On entering this function, aFile must be non-open. It is recommended that aFile is pushed onto the cleanup-stack (via CleanupClosePushL()) before this function is called.

Get the name of the executable from the command line string.

Creates an empty command line object.

Creates an empty command line object, and puts a pointer to it onto the cleanup stack.

The number of process environment-slot available for public use.

Gets the opaque-data from the launch information.

See the description of SetOpaqueDataL. By default, this attribute is an empty descriptor.

SetOpaqueDataL

Gets the Parent Process ID of the Child Process launched with this command line.

See the description of SetParentProcessId.

SetParentProcessId

Returns the ID of the parent window-group - the application should create its own window-group as a child of this parent.

Gets the server differentiator.

See the description of SetServerRequiredL.

SetServerRequiredL REikAppServiceBase::LaunchAppL()

Sets the command code.

The command code is used to indicate how an application is to be launched.

TApaCommand

Provides support for devices with more than one screen. A number representing the default or startup screen may be passed to an application. Screen numbers and characteristics are defined in the window server initialisation file (wsini.ini).

Sets the document name from the specified descriptor.

If the document name has embedded spaces, then it must be enclosed within quotation marks.

Sets the executable name from the specified descriptor.

Sets the file to be passed into the application (by handle). This will then be retrieved by that application-process calling GetFileByHandleL().

Sets the opaque-data from the specified 8-bit descriptor.

This is called internally and populated from the data in the application's registration resource file, i.e. from the resource indicated by the opaque_data field of the APP_REGISTRATION_INFO resource (if the opaque_data field was non-zero).

Sets the Parent Process ID for the Child Process launched with this command line.

This establishes a Parent-Child relationship which ensures that the child process is terminated when the parent terminates.

Sets the ID of the parent window-group - the application should create its own window-group as a child off this parent.

Assigns a command line to a process (EKA2 only).

This replaces the EKA1 method which involved retrieving the full command line (using CApaCommandLine::FullCommandLine()) and passing it to the process (or thread on the emulator).

Note that this sequence of steps bypasses the application architecture, and is not recommended. RApaLsSession::StartApp() is the recommended way to launch an application with a command line.

REikAppServiceBase::LaunchAppL()

Sets that no server is required.

The value of server differentiator is set to zero, to indicate that no server is required.

See the description of SetServerRequiredL. SetServerRequiredL

Sets the required server.

The server differentiator is a number generated by the client that helps to uniquely identify the server. It is used by an application to indicate whether a server should be created and how it should be named.

REikAppServiceBase::LaunchAppL()

Sets the trailing data.

The UI Framework provides a specific set of pre-defined command line options. Additional user defined or pre-defined command line options, may be passed to an application by setting the TailEnd.

Strip all quates from the string.

Gets the trailing data from the launch information.

See the description of SetTailEndL.

SetTailEndL