PPJ Desktop API
HomeCurrent IssuesDownloads
  • Welcome
  • Concepts
  • PPJ.Runtime.49
    • General
      • Sal
      • Sys
      • SalApplication
      • SalNamedProperties
      • SalWindow
      • WindowActionsEventArgs
      • SalXML
    • COM
      • SalCoClass
      • SalObject
      • SalOleErrorInfo
      • SalSafeArray
      • SalVariant
    • Controls
      • SalActiveX
      • SalBackgroundText
      • SalCheckBox
      • SalComboBox
      • SalContext
      • SalCustomControl
      • SalDataField
        • DataType
      • SalFrame
        • BorderStyle
      • SalGeneralWindow
      • SalGroupBox
      • SalGroupSeparator
      • SalHorizontalScrollBar
      • SalLine
        • LineStyle
        • LineType
      • SalListBox
      • SalMultilineField
      • SalNavigationBar
      • SalOptionButton
        • OptionButtonStyle
      • SalPicture
        • ImageStorage
      • SalPushbutton
      • SalRadioButton
      • SalTableWindow
        • CellType
        • FocusRowStyle
        • RowsSizingStyle
        • SalTableColumn
        • SalTableColumnCollection
        • SalTableRow
        • SalTableRowCollection
        • SalTableWindowBase
      • SalTreeControl
        • SalTreeItem
      • SalUserControl
      • SalVerticalScrollBar
    • Forms
      • AccessoryType
      • SalDialogBox
      • SalForm
      • SalFormClientArea
      • SalFormStatusBar
      • SalFormTableWindow
      • SalFormToolBar
      • SalFormWindow
      • SalMDIWindow
      • SalRibbonBarBase
      • SalRibbonBarForm
      • SalRibbonBarMDI
      • SalRibbonStatusBar
    • Interfaces
      • ISalControl
      • ISalEditControl
      • ISalListControl
      • ISalPictureControl
      • ISalRadioButton
      • ISalReport
      • ISalType
      • ISalAccessory
      • ISalMenu
      • ISalWindow
    • Internet
      • FtpEventArgs
      • FtpEventHandler
      • HttpEventArgs
      • HttpEventHandler
      • SalFtpClient
      • SalHttpClient
      • SalQuickFTP
      • SalQuickHTTP
    • Menus
      • SalContextMenu
      • SalFormMainMenu
      • SalMenuColumn
      • SalMenuItem
      • SalMenuRow
      • SalMenuSeparator
      • SalPopupMenu
      • SalWindowsMenu
    • QO
      • QO
      • SalQuickHTML
      • SalQuickTabs
      • SalQuickTabsDialog
      • SalQuickTabsForm
      • SalQuickTabsParent
      • SalQuickTabsParentDialog
      • SalQuickTabsParentForm
      • SalQuickToolTipCheckBox
      • SalQuickToolTipChildTable
      • SalQuickToolTipComboBox
      • SalQuickToolTipDataField
      • SalQuickToolTipHScrollBar
      • SalQuickToolTipListBox
      • SalQuickToolTipMultilineField
      • SalQuickToolTipOptionButton
      • SalQuickToolTipPicture
      • SalQuickToolTipPushButton
      • SalQuickToolTipRadioButton
      • SalQuickToolTipTableWindow
      • SalQuickToolTipVScrollBar
      • SalToolTipManager
    • Sql
      • SalSqlBindVariables
      • SalSqlError
      • SalSqlHandle
      • SalSqlSessionHandle
      • Sql
      • SqlContext
      • SqlOra
      • WhenSqlError
    • Types
      • SalArray
      • SalArray<T>
      • SalBinary
      • SalBoolean
      • SalDateTime
      • SalFileHandle
      • SalFunctionalClass
      • SalNumber
      • SalResource
      • SalString
      • SalStringContext
      • SalWindowHandle
  • PPJ.Runtime.DDE.49
    • General
      • SalDDE
  • PPJ.Runtime.Vis.49
    • General
      • Vis
      • VisTblEx
    • Controls
      • VisCalendar
      • VisCalendarDropDown
      • VisColorComboBox
      • VisColorListBox
      • VisColorPalette
      • VisColorPaletteBase
      • VisColorPaletteDropDown
      • VisComboBoxBase
      • VisDesktopListBox
      • VisDirListBox
      • VisDirTreeListBox
      • VisDriveListBox
      • VisDropDownBase
      • VisFileListBox
      • VisFontComboBox
      • VisFontListBox
      • VisFontNameComboBox
      • VisFontNameListBox
      • VisListBoxBase
      • VisListBoxExtension
      • VisListView
      • VisListViewDropDown
      • VisMeter
      • VisOutlineComboBox
      • VisOutlineListBox
      • VisPictureComboBox
      • VisPictureListBox
      • VisPoint
      • VisRadioListBox
      • VisRect
      • VisRichEdit
      • VisSize
      • VisSpinField
      • VisSplitter
      • VisSplitterWindow
        • Orientation
  • PPJ.Runtime.XSal.49
    • General
      • XSal
      • XSalScript
    • Controls
      • XSalFlatButton
      • XSalHSplitter
      • XSalSeparator
      • XSalSeparatorDoubleRaised
      • XSalSeparatorEtched
      • XSalSeparatorInvisible
      • XSalSeparatorSingleRaised
      • XSalSplitter
      • XSalToolbar
      • XSalToolbox
      • XSalVSplitter
Powered by GitBook
On this page
  • Constructors
  • SalApplication()
  • SalApplication(args)
  • Properties
  • ApplicationType
  • CompanyName
  • DefaultPrinterSettings
  • FormsScaleFactor
  • Instance
  • SkinApplication
  • ThreadModel
  • Title
  • TopLevelForms
  • UseCompatibleTextRendering
  • Version
  • VisualStyler
  • VisualStyles
  • XPStyle
  • Methods
  • AddForm(form)
  • ApplySkin(form)
  • ApplySkin(control, children)
  • DelayDispose(obj)
  • Disable()
  • Enable()
  • EndTrace()
  • Find(name, activate)
  • GetProfileInt(section, entry, defaultValue, fileName)
  • GetProfileString(section, entry, defaultValue, value, fileName)
  • IdleKick()
  • IdleRegister(ctrl, msg, wParam, lParam)
  • IdleUnregister(ctrl)
  • LoadApp(name, args)
  • LoadAppAndProcessMsgs(name, mode, retCode)
  • LoadAppAndWait(name, mode, retCode)
  • LoadSkinFile(path)
  • LoadSkinResource(name)
  • LoadSkinResource(assembly, name)
  • Pause(usec)
  • Quit()
  • RemoveForm(form)
  • RemoveSkin(form)
  • RemoveSkin(control, children)
  • Run(args)
  • SetProfileString(section, entry, value, fileName)
  • StartTrace(outputType, traceFile, clear)
  • Trace(severity, text)
  • UseEventLog(useLog, logAndcontinue)
  • UseRegistry(useRegistry, companyName)
  • Events
  • SkinChanged
  1. PPJ.Runtime.49
  2. General

SalApplication

PPJ.Runtime.Windows.SalApplication

PreviousSysNextSalNamedProperties

Last updated 2 years ago

Namespace: PPJ.Runtime.Windows

Assembly: PPJ.Runtime.49 (4.9.0.0)

Base class for SAL applications.

public class SalApplication
Public Class SalApplication

Constructors

SalApplication()

Default constructor.

SalApplication(args)

Constructs a new SalApplication instance and processes the startup arguments.

Name
Type
Description

args

Properties

ApplicationType

: Returns the type of the application.

CompanyName

Methods

Increase the reference count for the application object. It is called every time a new SalForm is created.

Parameter
Type
Description

form

Enables skinning for the form.

Parameter
Type
Description

form

Enables skinning for the control.

Parameter
Type
Description

control

children

Queue the object to be disposed at the next idle notification.

Parameter
Type
Description

obj

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.

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.

Stops all tracing. Any calls to SalTrace() occurring after SalEndTrace() will be ignored.

Finds a visible top-level window for the specified application. its window handle.

Parameter
Type
Description

name

activate

Retrieves the integer value of an entry in the specified section of an initialization file or registry.

Parameter
Type
Description

section

entry

defaultValue

fileName

Parameter
Type
Description

section

entry

defaultValue

value

fileName

Generate an idle cycle.

Registers a control to receive the specified message when there is an idle state.

Parameter
Type
Description

ctrl

Target control on which to execute the call.

msg

wParam

lParam

Stops sending idle messages to a control.

Parameter
Type
Description

ctrl

Target control on which to execute the call.

Starts an application.

Parameter
Type
Description

name

args

Parameter
Type
Description

name

mode

retCode

Parameter
Type
Description

name

mode

retCode

Loads the specified skin file. When loading a skin file, skinning is enabled automatically.

Parameter
Type
Description

path

Loads the specified skin file from the application's embedded resources. When loading a skin file, skinning is enabled automatically.

Parameter
Type
Description

name

Loads the specified skin file from the assembly's embedded resources. When loading a skin file, skinning is enabled automatically.

Parameter
Type
Description

assembly

name

Pauses the application for the specified number of milliseconds while dispatching messages.

Parameter
Type
Description

usec

Forces the termination of the application.

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 every time 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.

Parameter
Type
Description

form

Disables skinning for the form.

Parameter
Type
Description

form

Disables skinning for the control.

Parameter
Type
Description

control

children

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:


public static int Main(string[] args)
{
    return new PortedSalApplication().Run(args);
}
Parameter
Type
Description

args

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 .

Parameter
Type
Description

section

The section heading.

entry

The entry whose associated value is being set.

value

The value of sEntry.

fileName

The name of the initialization file or company name depending on the settings made using the SalUseRegistry function. If you are searching for an INI file and do not specify the full path, searches for the file in the Windows subdirectory.

Allows tracing to begin.

Parameter
Type
Description

outputType

traceFile

clear

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 text string such as "Warning".

Parameter
Type
Description

severity

text

Enables logging of unhandled exceptions in the event log.

Parameter
Type
Description

useLog

logAndcontinue

This function is used to re-direct all SalProfile* functions to use the Registry. All values for the SalProfile* functions are saved as strings. The INI file name used as the last parameter of the SalProfile* functions will be used as the application name. The resulting path will be: \HKEY_CURRENT_USER\Software&lt;company name>&lt;application name>&lt;section>&lt;setting>\

Parameter
Type
Description

useRegistry

companyName

Events

: 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. VisualStyler can be used directly to set advanced properties.

VisualStyles

: Enables disables Windows visual styles.

XPStyle

Deprecated: This property has been deprecated. Use SalApplication.VisualStyles. : Enables disables XP visual styles.

AddForm(form)

Returns: . Updated reference count

ApplySkin(form)

ApplySkin(control, children)

DelayDispose(obj)

Disable()

Returns: . bOk

Enable()

Returns: . bOk

EndTrace()

Returns: .

Find(name, activate)

Returns: . hWnd

GetProfileInt(section, entry, defaultValue, fileName)

Returns: .

GetProfileString(section, entry, defaultValue, value, fileName)

Returns: .

IdleKick()

Returns: . bOk

IdleRegister(ctrl, msg, wParam, lParam)

Returns: .

IdleUnregister(ctrl)

Returns: .

LoadApp(name, args)

Returns: .

LoadAppAndProcessMsgs(name, mode, retCode)

Returns: .

LoadAppAndWait(name, mode, retCode)

Returns: .

LoadSkinFile(path)

LoadSkinResource(name)

LoadSkinResource(assembly, name)

Pause(usec)

Quit()

RemoveForm(form)

Returns: .

RemoveSkin(form)

RemoveSkin(control, children)

Run(args)

Returns: .

SetProfileString(section, entry, value, fileName)

Returns: . bOk

StartTrace(outputType, traceFile, clear)

Returns: .

Trace(severity, text)

Returns: .

UseEventLog(useLog, logAndcontinue)

Returns: .

UseRegistry(useRegistry, companyName)

Returns: . bOk

SkinChanged

Fired when the loaded skin changes.

String
PrinterSettings
SizeF
SalApplication
Boolean
ApartmentState
String
Form[]
Boolean
Int32
VisualStyler
Boolean
Int32
Boolean
Boolean
Boolean
IntPtr
UInt32
Int32
Boolean
Boolean
Boolean
Boolean
Boolean
Boolean
Int32
Int32
Boolean
Boolean
Boolean
Boolean
Boolean
EventHandler
String[]
Form
Form
Control
Boolean
IDisposable
String
Boolean
String
String
UInt32
String
String
String
String
SalString&
String
Control
Int32
Int32
Int32
Control
String
String
String
Int32
SalNumber&
String
Int32
SalNumber&
String
String
Assembly
String
Int32
Form
Form
Control
Boolean
String[]
String
String
String
String
Int32
String
Boolean
Int32
String
Boolean
Boolean
Boolean
String
Type
Boolean