The SalApplication type exposes the following members.
Constructors
Name | Description | |
---|---|---|
SalApplication()()()() |
Default constructor.
| |
SalApplication(array<String>[]()[][]) |
Constructs a new SalApplication instance and processes the startup
arguments.
|
Methods
Name | Description | |
---|---|---|
AddForm |
Increase the reference count for the
application object. It is called every time
a new SalForm is created.
| |
ApplySkin(Form) |
Enables skinning for the form.
| |
ApplySkin(Control, Boolean) |
Enables skinning for the control.
| |
DelayDispose |
Queue the object to be disposed at the next idle notification.
| |
Disable |
Disables input to all open forms. Use SalAppDisable and SalAppEnable when
there are multiple applications running simultaneously and you want to control which
application receives user input.
| |
Enable |
Enables input to all open forms that were disabled by SalAppDisable. Use SalAppDisable
and SalAppEnable when there are multiple applications running simultaneously
and you want to control which application receives user input.
| |
EndTrace |
Stops all tracing. Any calls to SalTrace() occurring after SalEndTrace() will be ignored.
| |
Find |
Finds a visible top-level window for the specified application.
its window handle.
| |
GetProfileInt |
Retrieves the integer value of an entry in the specified section of an initialization
file or registry.
| |
GetProfileString |
Retrieves the string value of an entry in the specified section of an initialization
file or registry.
| |
IdleKick |
Generate an idle cicle.
| |
IdleRegister |
Registers a control to receive the specified message when there is an idle state.
| |
IdleUnregister |
Stops sending idle messages to a control.
| |
LoadApp |
Starts an application.
| |
LoadAppAndProcessMsgs |
Starts an application, then waits for it to exit before returning control to the original application.
However, the original application can continue to process messages.
| |
LoadAppAndWait |
Starts an application, then waits for it to exit before returning control to the
original application.
| |
LoadSkinFile |
Loads the specified skin file.
RemarksWhen loading a skin file, skinning is enabled automatically. | |
LoadSkinResource(String) |
Loads the specified skin file from the application's embedded resources.
RemarksWhen loading a skin file, skinning is enabled automatically. | |
LoadSkinResource(Assembly, String) |
Loads the specified skin file from the assembly's embedded resources.
RemarksWhen loading a skin file, skinning is enabled automatically. | |
OnAppCreateAutomaticForms |
Forms that have the AutomaticallyCreate property set to true
are created in the implementation of this function.
This is called after OnAppStartup.
| |
OnAppExit |
Corresponds to SAM_AppExit
| |
OnAppStartup |
Corresponds to SAM_AppStartup
| |
OnSqlError |
Corresponds to SAM_SqlError
| |
OnThreadException |
Receives unhandled exceptions from window procedures.
| |
OnUnhandledException |
Unhandled exception event.
| |
Pause |
Pauses the application for the specified number of milliseconds
while dispatching messages.
| |
Quit |
Forces the termination of the application.
| |
RemoveForm |
Decreases the reference count for the application object.
When the count drops to zero (or below if there is a bug), the
application exits. It is called everytime a Sal form is destroyed.
This should emulate SAL application's behavior with respect
to top level windows. When the last form is destroyed the app exits.
| |
RemoveSkin(Form) |
Disables skinning for the form.
| |
RemoveSkin(Control, Boolean) |
Disables skinning for the control.
| |
Run |
Main method to startup a SAL application. The SAL application
class that extends SalApplication should call this method in the
application's Main method.
Example:
CopyC# public static int Main(string[] args) { return new PortedSalApplication().Run(args); } | |
SetProfileString |
Set the value of an entry in the specified section of an initialization file or registry.
All profile information is stored as string, so if you want to store an
integer it must be converted to a string first. Then it can be retrieved as an
integer using the SalGetProfileInt- Function .
| |
StartTrace |
Allows tracing to begin.
| |
Trace |
Outputs a string to the trace output target selected earlier in the SalStartTrace function.
Note that if tracing is not already activated, this function will return TRUE even though no trace action is taken.
When writing to the event log, the severity level is kept in numeric form. When writing to any other output target, it is translated into a tex string such as "Warning".
| |
UseEventLog | ||
UseRegistry |
Properties
Name | Description | |
---|---|---|
ApplicationType |
Returns the type of the application.
| |
CompanyName |
Returns the company of the application loaded from
the AssemblyCompany attribute;
| |
DefaultPrinterSettings |
Returns the default printer settings.
This is set by SalPrt
| |
FormsScaleFactor |
Global autoscaling factor used for all forms in the application.
It is empty by default. In which case the standard scaling is used.
| |
Instance |
Returns the instance of the application
| |
SkinApplication |
Enables/Disables the skinning of the entire application.
| |
ThreadModel |
Returns the threading model.
| |
Title |
Returns the title of the application loaded from
the AssemblyTitle attribute;
| |
TopLevelForms |
Returns a list of all top-level forms that belong to this application.
| |
UseCompatibleTextRendering |
Returns the value of the internal property Control.UseCompatibleTextRendering.
| |
Version |
Returns the version of the framework.
| |
VisualStyler |
Returns the thread-safe instance of the VisualStyler component.
RemarksVisualStyler can be used directly to set advanced properties. | |
VisualStyles |
Enables disables Windows visual styles.
| |
XPStyle | Obsolete.
Enables disables XP visual styles.
|
Events
Name | Description | |
---|---|---|
SkinChanged |
Fired when the loaded skin changes.
|