SalWindow

PPJ.Runtime.Windows.SalWindow

Namespace: PPJ.Runtime.Windows

Assembly: PPJ.Web.49 (4.9.0.0)

Delegate class for Sal windows functionality. Since we cannot inherit from .NET controls and from our class we need to implement all common functionality here and then delegate calls using method wrappers.

C#

public class SalWindow

VB.NET

Constructors

SalWindow(salWnd)

Creates a new instance of SalWindow and saves the control that is bound to this instance.

Name	Type	Description
salWnd	ISalWindow

Properties

DesignMode

Boolean: Returns/Sets the DesignMode flag.

DragLocation

Point: Returns the location of the mouse, in client's coordinates, when the drag-drop mode was initiated.

DragSource

Control: Returns the source control for the drag-drop operations.

DropData

IDataObject: Returns the data object bring dropped for the drag-drop operations.

DropDisabled

Boolean: Enables/Disables drag-drop operations.

DropLocation

Point: Returns the location of the mouse (in client's coordinates), when the mouse was released the drag-drop operation terminated.

DropTarget

Control: Returns the drop target control.

KeepMask

Boolean: Enables/Disables keeping the mask when reading the text from a masked edit control.

MapEnterToTab

Boolean: Enables/Disables the mapping of the enter key to the tab key.

NamedProperties

SalNamedProperties: Returns the collection of named properties.

Methods

AddListItem(ctrl, text)

Adds a string to the list control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
text	String	Text to add to the list.

Returns: Int32. The index of the added item or Sys.LB_Err (-1) if there is an error.

AddMessageActions(handler)

Deprecated: Deprecated. Use AddWindowActions() Adds the specified handler to the list of delegates registered to received the MessageActions event.

Parameter	Type	Description
handler	Delegate

AddMessageActions(target)

Deprecated: Deprecated. Use AddWindowActions(). Adds the handlers from the target window to the list of delegates registered to received the MessageActions event.

Parameter	Type	Description
target	ISalWindow

AddWindowActions(handler)

Adds the specified handler to the list of delegates registered to handle the WindowActions event.

Parameter	Type	Description
handler	Delegate

AddWindowActions(target)

Adds the handlers from the target window to the list of delegates registered to received the WindowActions event.

Parameter	Type	Description
target	ISalWindow

AddWinSDKCriticalEvents(events)

Returns critical events for the WinSDK messages emulation.

Parameter	Type	Description
events	WiredEvents

BringToTop(ctrl)

Brings a window to the top of all overlapping windows.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

CanCopy()

Returns true of the selection in the control with the focus can be copied.

Returns: Boolean.

CanCut()

Returns true of the selection in the control with the focus can be cut.

Returns: Boolean.

CanPaste()

Returns true if there is the control with the focus can paste the text in the clipboard.

Returns: Boolean.

CanUndo()

Returns true if the control with the focus can undo the last edit operation.

Returns: Boolean.

Center(ctrl)

Centers a window relative to the parent, or the owner, or the screen.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

Clear(ctrl)

Clears the value from a data field, multiline field, or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

Clear()

Deletes the selection in the control with the focus.

Returns: Boolean.

ClearCursor(ctrl, type)

Clears a window's cursor.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
type	Int32

Returns: Boolean.

ClearList(ctrl)

Deletes all entries from the list control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

Copy()

Copies the selection from the control with the focus to the clipboard.

Returns: Boolean.

CopyProfile(ctrl, profile)

Clones the specified profile into the custom profile associated to the specified field.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
profile	Int32

Returns: Boolean.

CopyString(text)

Copies the text to the clipboard.

Parameter	Type	Description
text	String

CreateFont(name, size, enhancement)

Creates a Font object from the specified parameters.

Parameter	Type	Description
name	String
size	Single
enhancement	Int32

Returns: Font.

CreateWindow(type, owner, args)

Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.

Parameter	Type	Description
type	Type
owner	Control
args	Object[]

Returns: Control.

CreateWindow(typeName, parent, args)

Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.

Parameter	Type	Description
typeName	String
parent	Control
args	Object[]

Returns: Control.

CreateWindow(type, parent, left, top, width, height, flags, args)

Creates a form window, dialog box, or table window as a child of another form window, dialog box, or toolbar at runtime.

Parameter	Type	Description
type	Type
parent	Control
left	Single
top	Single
width	Single
height	Single
flags	Int32
args	Object[]

Returns: Control.

CreateWindow(typeName, parent, left, top, width, height, flags)

Creates a form window, dialog box, or table window as a child of another form window, dialog box, or toolbar at runtime.

Parameter	Type	Description
typeName	String
parent	Control
left	Single
top	Single
width	Single
height	Single
flags	Int32

Returns: Control.

Cut()

Deletes the selected from the control with the focus and places it in the clipboard.

Returns: Boolean.

DeleteListItem(ctrl, index)

Deletes a list box or combo box entry.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Index of the item to remove from the list.

Returns: Int32.

Destroy(ctrl)

Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.

Parameter	Type	Description
ctrl	Control	Control to dispose.

Returns: Boolean.

DisableWindow(ctrl)

Disables keyboard and mouse input to a window. If the window contains text (for example, a push button), the text is grayed. If the window is a data field, it cannot receive the focus.

Parameter	Type	Description
ctrl	Control	Control to disable.

Returns: Boolean.

DisableWindowAndLabel(ctrl)

Disables keyboard and mouse input to a window and grays out its associated label.

Parameter	Type	Description
ctrl	Control	Control to disable together with its associated label.

Returns: Boolean.

DragAcceptFiles(ctrl, accept)

Indicates whether a window can accept a file from Windows' File Manager.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
accept	Boolean

Returns: Boolean.

DragDropStart(data)

Initiates drag-drop mode.

Parameter	Type	Description
data	Object

Returns: Boolean.

DragDropStop()

Aborts drag mode.

Returns: Boolean.

EnableWindow(ctrl)

Enables keyboard and mouse input to a window.

Parameter	Type	Description
ctrl	Control	Control to enable.

Returns: Boolean.

EnableWindowAndLabel(ctrl)

Enables keyboard and mouse input to a window and enables its associated label as well. A label is the label control that immediately precedes the window in the tab order.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

EndDialog(ctrl, value)

Destroys a modal dialog box and returns control to the caller of SalModalDialog.

Parameter	Type	Description
ctrl	Control	Dialog to terminate.
value	Int32	Value to assign to the dialog's ReturnValue field.

Returns: Boolean.

FindChild(ctrl, name)

Finds a child window of a given name in the specified window.

Parameter	Type	Description
ctrl	Control	Container control.
name	String	The name of the child control to find.

Returns: Control.

FindChild(ctrl, type)

Finds a child window of a given type in the specified window.

Parameter	Type	Description
ctrl	Control	Container control.
type	Type	The Type of the child control to find.

Returns: Control.

FindControl(ctrl, name)

Finds a member control in the specified control. Used as a helper functions to resolve unqualified references.

Parameter	Type	Description
ctrl	Control	Container control.
name	String	The name of the member control to find.

Returns: Control.

FindMember(ctrl, name)

Find a member in the specified control. Used as a helper functions to resolve unqualified references.

Parameter	Type	Description
ctrl	Control	Container control.
name	String	The name of the member to find.

Returns: ReferenceInfo.

FireWindowActions(ctrl, msgCode, wParam, lParam)

Dispatches a Sal messages directly to the control's WindowActions handlers.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
msgCode	Int32
wParam	SalNumber
lParam	SalNumber

Returns: WindowActionsEventArgs.

FireWindowActionsToChildren(ctrl, msg, wParam, lParam)

Dispatches the specified message (Window Actions) directly to the children's WindowActions event handlers, without going through Windows message loop.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
msg	Int32
wParam	SalNumber
lParam	SalNumber

Returns: Boolean.

FireWinSDKEvent(e)

Processes the client event to generate the equivalent WinSDK message.

Parameter	Type	Description
e	WisejEventArgs

Returns: Boolean.

FormUnitsToPixels(ctrl, units, vertical)

Computes the number of pixels in the number form units.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
units	Single
vertical	Boolean

Returns: Int32.

FromHandle(handle, type)

Retrieves the control associated with the handle and casts it to the target type. If the target type is a second-base class in multiple inheritance tree, uses reflection to cast the control to the second-base instance.

Parameter	Type	Description
handle	SalWindowHandle
type	Type

Returns: Object.

GetClassName(ctrl)

Return the name of a window's class as a string.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetClientArea(form)

Returns the SalClientArea panel.

Parameter	Type	Description
form	Control

Returns: SalFormClientArea.

GetControlName(ctrl)

Gets the name of a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetControlName(ctrl, sName)

Parameter	Type	Description
ctrl	Control
sName	SalString&

Returns: Boolean.

GetControlType(ctrl)

Returns the type of control (TYPE_*).

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32.

GetDataLength(ctrl)

Returns the maximum length of a data field, multiline text field, or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32.

GetDataType(ctrl)

Returns a data field's or table window column's data type (DT_*).

Parameter	Type	Description
ctrl	Control

Returns: Int32. DT_*

GetDefaultButton(ctrl)

Returns the default push button on a form window or dialog box.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Control.

GetFirstChild(parent, typeMask)

Returns the first child window of the specified type.

Parameter	Type	Description
parent	Control	Parent control.
typeMask	Int32

Returns: Control.

GetFocus()

Returns the control with the focus.

Returns: SalWindowHandle.

GetFont(ctrl, sName, nSize, nEnhancement)

Parameter	Type	Description
ctrl	Control
sName	SalString&
nSize	SalNumber&
nEnhancement	SalNumber&

Returns: Boolean.

GetFont(font, name, size, enhancement)

Parameter	Type	Description
font	Font
name	String&
size	Single&
enhancement	Int32&

Returns: Boolean.

GetFontNames()

Gets the names of the screen or printer fonts.

Returns: String[].

GetFormat(ctrl)

Gets the format of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetFormatCode(ctrl)

Returns the current format of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32.

GetFormattedText(ctrl, format)

Returns the contents of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
format	Boolean

Returns: String.

GetInputMask(ctrl)

Gets the input mask of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetLabel(ctrl)

Finds the Label assigned the specified control. Labels are assigned at startup using the TabIndex preceding the control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Control.

GetLabelText(ctrl)

Retrieves the label text of a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetLabelText(ctrl, maxLen)

Returns the text of the label associated to the specified control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
maxLen	Int32

Returns: String.

GetLabelText(ctrl, sText, maxLen)

Parameter	Type	Description
ctrl	Control
sText	SalString&
maxLen	Int32

Returns: SalNumber.

GetListItemsCount(ctrl)

Returns the number of list box or combo box entries.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32. Number of items in the list.

GetListItemState(ctrl, index)

Determines whether the specified list box or combo box entry is selected.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Index of the item to check the state for.

Returns: Boolean. True if the item at the index position is selected, otherwise false.

GetListItemText(ctrl, index)

Returns an entry in the list box or combo box.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Index of the item to retrieve the text from.

Returns: String. Text of the specified item.

GetListItemText(ctrl, index, text)

Parameter	Type	Description
ctrl	Control
index	Int32
text	SalString&

Returns: Int32.

GetListItemTextLength(ctrl, index)

Returns the length of a list box or combo box entry.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Index of the item to return the length for.

Returns: Int32. Length of the text of the specified item.

GetListSelectedFile(ctrl)

Fetches the selected directory or file name from a list box or combo box.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetListSelectedFile(ctrl, fileName)

Parameter	Type	Description
ctrl	Control
fileName	SalString&

Returns: Boolean.

GetListSelectedIndex(ctrl)

Returns the index of the selected entry in a combo box or single-selection list box.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32. Index of the first selected item.

GetListSelectedItems(ctrl, selectedArray)

Fills the target array with the indexes of the selected entries in the listbox.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
selectedArray	SalArray<SalNumber>	Array to receive the list of selected indices.

Returns: Boolean. Number of selected items, which is the number of elements in selectedArray .

GetListSelectedItemsCount(ctrl)

Returns the number of selected entries in a multiple-selection list box.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32. Number of selected items in the list.

GetLocation(ctrl)

Returns a window's current position on the X and Y axes.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: PointF.

GetMdiClient(form)

Returns the MDI client area of the MDI container.

Parameter	Type	Description
form	Form

Returns: MdiClient.

GetMessageName(msg)

Parameter	Type	Description
msg	Int32

Returns: String.

GetNextChild(ctrl, typeMask)

Returns the next child control in the tab order that matches a specified type.

Parameter	Type	Description
ctrl	Control	Precedent control.
typeMask	Int32

Returns: Control.

GetParent(ctrl)

Returns the handle of an object's parent window.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Control.

GetProfile(ctrl)

Returns the code of the custom profile associated with the specified field.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32.

GetProfileParameter(ctrl, paramCode, paramValue)

Parameter	Type	Description
ctrl	Control
paramCode	Int32
paramValue	SalNumber&

Returns: Boolean.

GetProfileParameter(ctrl, paramCode, paramValue)

Parameter	Type	Description
ctrl	Control
paramCode	Int32
paramValue	SalString&

Returns: Boolean.

GetProperty(ctrl, name)

Gets the value of a named property for a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
name	String

Returns: String.

GetProperty(ctrl, name, sValue)

Parameter	Type	Description
ctrl	Control
name	String
sValue	SalString&

Returns: Boolean.

GetSalMessageName(msg)

Returns the name of a SAM message.

Parameter	Type	Description
msg	Int32

Returns: String.

GetScrollBarPosition(ctrl)

Returns the current scroll bar value.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32.

GetScrollBarRange(ctrl, nMin, nMax, nLine, nPage)

Parameter	Type	Description
ctrl	Control
nMin	SalNumber&
nMax	SalNumber&
nLine	SalNumber&
nPage	SalNumber&

Returns: Boolean.

GetSize(ctrl)

Returns a window's size.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: SizeF.

GetSortedControls(parent)

Returns the collection of controls sorted by the TabIndex.

Parameter	Type	Description
parent	Control

Returns: Control[].

GetState(ctrl)

Returns a window's current state.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Int32.

GetStatusBar(form)

Returns the SalStatusBar control.

Parameter	Type	Description
form	Control

Returns: SalFormStatusBar.

GetStatusBarText(ctrl)

Gets the text displayed in the status bar of a top-level or MDI window.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetSysColor(colorIndex)

Gets a system color.

Parameter	Type	Description
colorIndex	Int32

Returns: Int32. nColor

GetText(ctrl)

Retrieves the text of a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: String.

GetText(ctrl, text, maxLen)

Parameter	Type	Description
ctrl	Control
text	SalString&
maxLen	Int32

Returns: Int32.

GetText(ctrl, maxLen)

Returns the string value of the specified control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
maxLen	Int32

Returns: SalString.

GetTextUnmasked(ctrl)

Returns the unmasked content of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: SalString.

GetToolBar(form)

Returns the SalToolbar control.

Parameter	Type	Description
form	Control

Returns: SalFormToolBar.

GetWindowColor(ctrl, colorIndex)

Gets a window's color.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
colorIndex	Int32

Returns: Int32.

HasAccessories(ctrl)

Returns true if the form has the accessories panels.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

HideWindow(ctrl)

Hides a control. Returns false if the control is already hidden.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean. True if the control was previously visible.

HideWindowAndLabel(ctrl)

Hides a control and its associated label.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

InsertListItem(ctrl, index, text)

Inserts an entry into a list box or combo box at a specified position.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Position in the list where to insert the text .
text	String	Text of the item to insert in the list.

Returns: Int32. The index of the added item or Sys.LB_Err (-1) if there is an error.

Invalidate(ctrl)

Causes a window to be repainted.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsChecked(ctrl)

Determines whether a radio button is set or a check box is checked.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsDerivedFrom(ctrl, type)

Returns true if a control is an instance of the class.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
type	Type

Returns: Boolean.

IsEmpty(ctrl)

Verifies whether a data field, multiline text field, or table window column is null or empty.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsEnabled(ctrl)

Determines whether a window is enabled for mouse and keyboard input.

Parameter	Type	Description
ctrl	Control

Returns: Boolean.

IsKeyboardMessage(msg)

Returns true if the message code is a mouse or a keyboard message.

Parameter	Type	Description
msg	Int32

Returns: Boolean.

IsModified(ctrl)

Returns the setting of the modified flag for a data field, multiline field, combo box, table window's context row cell.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsMouseMessage(msg)

Returns true if the message code is a mouse or a keyboard message.

Parameter	Type	Description
msg	Int32

Returns: Boolean.

IsSalMessage(msg)

Returns true if the message is a known SAM message.

Parameter	Type	Description
msg	Int32

Returns: Boolean.

IsScrollBarVisible(control, bars)

Returns true if the requested scrollbar is visible on the control.

Parameter	Type	Description
control	Control
bars	ScrollBars

Returns: Boolean.

IsValid(ctrl)

Validates the contents of a data field or table window column using the current profile.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsValidDateTime(ctrl)

Verifies whether a data field, multiline text field, or table window column contains a valid date/time value.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsValidDecimal(ctrl, precision, scale)

Verifies whether a data field, multiline text field, or table window column contains a valid decimal value.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
precision	Int32
scale	Int32

Returns: Boolean.

IsValidEditMask(mask)

Validates the input mask of a data field or table window column.

Parameter	Type	Description
mask	String

Returns: Boolean.

IsValidFormat(format, code)

Validates a numeric or date/time picture format.

Parameter	Type	Description
format	String
code	Int32

Returns: Boolean.

IsValidInteger(ctrl)

Verifies whether a data field, multiline text field, or table window column contains a valid integer value.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsValidNumber(ctrl)

Verifies whether a data field, multiline text field, or table window column contains a valid numeric value..

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

IsVisible(ctrl)

Determines whether a window is currently visible.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

KillTimer(ctrl, id)

Destroys an control's system timer.

Parameter	Type	Description
ctrl	Control
id	Int32

Returns: Boolean.

ListGetMultiSelect(ctrl)

Returns an array of index numbers of selected list box entries.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: IList. List of selected indices.

MessageBox(owner, text, title, flags, callback)

Displays a message box and returns a number that indicates the user's response.

Parameter	Type	Description
owner	Control	Owner of the message box.
text	String	Message text to display in the message box.
title	String	Title to display in the caption area.
flags	Int32	Combination of the Sys.MB_* flags to set the buttons and icons of the message box.
callback	Action<Int32>	Optional callback handler. When set, the MessageBox is not modal.

Returns: SalNumber.

ModalDialog(type, owner, args)

Creates a modal dialog box.

Parameter	Type	Description
type	Type	The dialog to create.
owner	Control	Owner of the dialog.
args	Object[]	Optional startup arguments.

Returns: Int32. The value set when closing the dialog using EndDialog.

ModalDialog(type, owner, callback, args)

Creates a modal dialog box.

Parameter	Type	Description
type	Type	The dialog to create.
owner	Control	Owner of the dialog.
callback	Action<Int32>	Callback method, invoked when the dialog is closed.
args	Object[]	Optional startup arguments.

ModalDialog(typeName, owner, args)

Creates a modal dialog box.

Parameter	Type	Description
typeName	String	Name of the dialog to create.
owner	Control	Owner of the dialog.
args	Object[]	Optional startup arguments.

Returns: Int32. The value set when closing the dialog using EndDialog.

ModalDialogAsync(type, owner, args)

Creates a modal dialog box asynchronously.

Parameter	Type	Description
type	Type	The dialog to create.
owner	Control	Owner of the dialog.
args	Object[]	Optional startup arguments.

Returns: Task<Int32>.

Move(ctrl, offset)

Moves a window a given number of form units on the X and Y axes relative to its current position.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
offset	PointF

Returns: Boolean.

Paste()

Pastes the text in the clipboard to the control with the focus.

Returns: Boolean.

PasteString(text)

Parameter	Type	Description
text	String&

Returns: Boolean.

PixelsToFormUnits(ctrl, pixels, vertical)

Computes the number of form units based on the number of pixels.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
pixels	Int32
vertical	Boolean

Returns: Single.

PopulateList(ctrl, hSql, sql)

Populates a list box or combo box with a result set.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
hSql	SalSqlHandle	SalSqlHandle to use to execute the sql command.
sql	String	SQL command to execute to populate the list.

Returns: Boolean.

PopulateList(ctrl, hSql, sql, errorHandler)

Populates a list box or combo box with a result set.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
hSql	SalSqlHandle	SalSqlHandle to use to execute the sql command.
sql	String	SQL command to execute to populate the list.
errorHandler	WhenSqlErrorHandler	Error handle callback.

Returns: Boolean.

PopulateListFiles(ctrl, ctrlPath, pathName, attributes)

Parameter	Type	Description
ctrl	Control
ctrlPath	Control
pathName	SalString&
attributes	Int32

Returns: Boolean.

PostMessage(ctrl, msg, wParam, lParam)

Posts the specified message to a window by adding nMsg to handleReceiver's message queue.

Parameter	Type	Description
ctrl	Control
msg	Int32
wParam	IntPtr
lParam	IntPtr

Returns: Boolean.

PreviewForm(ctrl)

Prints a form window, table window, or dialog box, including its contents and row header flags.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

PrintForm(ctrl)

Prints a form window, table window, or dialog box, including its contents and row header flags.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

RemoveMessageActions(handler)

Deprecated: Deprecated. Use RemoveWindowActions() Removes the specified handler from the list.

Parameter	Type	Description
handler	Delegate

RemoveWindowActions(handler)

Removes the specified handler from the list.

Parameter	Type	Description
handler	Delegate

SendMessage(ctrl, msg, wParam, lParam)

Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.

Parameter	Type	Description
ctrl	Control
msg	Int32
wParam	SalNumber
lParam	SalNumber

Returns: SalNumber.

SendMessageToChildren(ctrl, msg, wParam, lParam)

Sends a message to all child items of a form window, dialog box, table window, or MDI window.

Parameter	Type	Description
ctrl	Control
msg	Int32
wParam	SalNumber
lParam	SalNumber

Returns: Boolean.

SendMessageToChildrenInternal(ctrl, msg, wParam, lParam)

Sends a message to all child items of a form window, dialog box, table window, or MDI window.

Parameter	Type	Description
ctrl	Control
msg	Int32
wParam	SalNumber
lParam	SalNumber

Returns: Boolean.

SendValidateMessage()

Sends a SAM_Validate message to the object with the focus.

Returns: Int32.

SetContextMenu(ctrl, menuName, flags)

Defines the context menu for a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
menuName	String
flags	Int32

Returns: Boolean.

SetContextMenu(ctrl, menuType, flags)

Defines the context menu for a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
menuType	Type
flags	Int32

Returns: Boolean.

SetCursor(ctrl, cursor, type)

Sets a window's cursor.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
cursor	Cursor
type	Int32

Returns: Boolean.

SetCursor(ctrl, cursorId, type)

Sets a window's cursor.

Parameter	Type	Description
ctrl	Control
cursorId	Int32	Specify one of these system-supplied cursors: CURSOR_Arrow CURSOR_Cross CURSOR_IBeam CURSOR_Icon CURSOR_Size CURSOR_SizeNESW CURSOR_SizeNS CURSOR_SizeNWSE CURSOR_SizeWE CURSOR_UpArrow CURSOR_Wait
type	Int32

Returns: Boolean.

SetCursor(ctrl, fileName, type)

Sets an application-defined cursor for the specified window. Use this function to set the cursor from an image stored in a file.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
fileName	String	The name of a cursor or an icon file.
type	Int32

Returns: Boolean.

SetCursor(ctrl, blob, type)

Sets a window's cursor from a string variable.

Parameter	Type	Description
ctrl	Control
blob	Byte[]
type	Int32

Returns: Boolean.

SetDataLength(ctrl, maxLength)

Sets a limit on the number of characters that a user can enter into a data field, multiline text field, or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
maxLength	Int32

Returns: Boolean.

SetDefaultButton(ctrl)

Sets the default push button of a form window or dialog box.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

SetFocus(ctrl)

Sets the focus to a specified window.

Parameter	Type	Description
ctrl	Control

Returns: Control.

SetFont(ctrl, name, size, enhancement)

Sets a window's font, font size, and font enhancements.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
name	String
size	Int32
enhancement	Int32

Returns: Boolean.

SetFormat(ctrl, format)

Sets the picture format of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
format	String

Returns: Boolean.

SetFormatCode(ctrl, format)

Sets a data field's or table window column's format.

Parameter	Type	Description
ctrl	Control
format	Int32

Returns: Boolean.

SetFormattedText(ctrl, text, applyFormat)

Copies a formatted string to a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
text	String
applyFormat	Boolean

Returns: Boolean.

SetInputMask(ctrl, mask)

Sets the input mask of a data field or table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
mask	String

Returns: Boolean.

SetLabel(ctrl, label)

Changes the Label assigned to the specified control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
label	Control

SetLabelText(ctrl, text)

Sets the label text of a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
text	String

Returns: Boolean.

SetListSelectedIndex(ctrl, index)

Selects or deselects a combo box or single-selection list box entry. If the listbox is multiselect using -1 as the index value selects all items, while using any other invalid index value deselects all items. For normal listbox, using -1 always deselects all items.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Index of the item to select. Use -1 to select all items and -2 to deselect all items.

Returns: Boolean.

SetListSelectedItems(ctrl, index, select)

Selects or deselects a combo box or multiple-selection list box entry.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
index	Int32	Index of the item to select or deselect. Use -1 to select or deselect all the items in the list.
select	Boolean	True to select the specified item(s), false to deselect the item(s).

Returns: Boolean.

SetListSelectedText(ctrl, startIndex, text)

Finds and selects a combo box or single-selection list box entry.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
startIndex	Int32	Position where to start the search for text .
text	String	Text to search for in the list.

Returns: Int32. Index of the first item that matches the text or -1 if not found.

SetLocation(ctrl, pos)

Moves a window to a new position (x, y) on the X and Y axes.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
pos	PointF

Returns: Boolean.

SetModified(ctrl, modified)

Sets or clears the field modified flag for an editable data field, combo box, multiline text field, table window column.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
modified	Boolean

Returns: Boolean.

SetProfile(ctrl, profile)

Changes the custom profile of the specified field.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
profile	Int32

Returns: Boolean.

SetProfileParameter(ctrl, paramCode, paramValue)

Alters the specified parameter for the custom profile associated to the specified field.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
paramCode	Int32
paramValue	SalNumber

Returns: Boolean.

SetProfileParameter(ctrl, paramCode, paramValue)

Alters the specified parameter for the custom profile associated to the specified field.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
paramCode	Int32
paramValue	SalString

Returns: Boolean.

SetProperty(ctrl, name, value)

Sets the value of a named property for a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
name	String
value	String

Returns: Boolean.

SetScrollBarPosition(ctrl, pos)

Sets a scroll bar's position.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
pos	Int32

Returns: Boolean.

SetScrollBarRange(ctrl, min, max, line, page)

Sets a scroll bar's range, line increment, and page increment.

Parameter	Type	Description
ctrl	Control
min	Int32
max	Int32
line	Int32
page	Int32

Returns: Boolean.

SetSize(ctrl, size)

Resizes a window.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
size	SizeF

Returns: Boolean.

SetStatusBarText(ctrl, text)

Updates the status bar of the top level form that owns the specified control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
text	String

Returns: Boolean.

SetStatusBarText(menu, text)

Updates the status bar of the form that owns the menu item.

Parameter	Type	Description
menu	Menu
text	String

Returns: Boolean.

SetText(ctrl, text)

Sets the text of a control to a specified string.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
text	String

Returns: Boolean.

SetTimer(ctrl, id, millisec)

Creates a system timer for a given control.

Parameter	Type	Description
ctrl	Control	Control that owns the timer.
id	Int32	Unique time id, sent back in Sys.wParam.
millisec	Int32	Interval in milliseconds.

Returns: Boolean.

SetWindowColor(ctrl, colorIndex, nColor)

Sets a window's color.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
colorIndex	Int32
nColor	Int32

Returns: Boolean.

ShouldDispatch(code)

Returns true if the message should be dispatched. Messages are not dispatched if: - message dispatching is disabled - the control has not registered handlers - the control is disposed - the message is not handled by the control's handlers

Parameter	Type	Description
code	Int32

Returns: Boolean.

ShowStatusBar(ctrl, visible)

Shows or hides the status bar on a top-level or MDI window.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
visible	Boolean

Returns: Boolean.

ShowToolBar(ctrl, visible)

Shows or hides the tool bar on a top-level or MDI window.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
visible	Boolean

Returns: Boolean.

ShowWindow(ctrl)

Makes a control visible.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean. True if the control was previously visible.

ShowWindowAndLabel(ctrl)

Makes a control and its associated label visible.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

TrackPopupMenu(ctrl, menuName, flags, pos, callback)

Shows context popup menu at runtime.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
menuName	String
flags	Int32
pos	Point
callback	Action<ContextMenu>

Returns: Boolean.

TrackPopupMenu(ctrl, menuType, flags, pos, callback)

Shows context popup menu at runtime.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
menuType	Type
flags	Int32
pos	Point
callback	Action<ContextMenu>

Returns: Boolean.

TranslateColor(color)

Converts .NET colors to the corresponding SAL color constant.

Parameter	Type	Description
color	Color

Returns: Int32.

TranslateControl(ctrl)

Translate the parent control into a valid control instance: - if the ClientArea is passed returns the form - if a second base visual class is passed, returns the instance - if a embedded TableWindow control is passed, returns the parent TableWindowForm

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Control.

TranslateProfile(profile)

Translates CTD profile codes to the equivalent .NET CultureInfo.

Parameter	Type	Description
profile	Int32

Returns: CultureInfo.

TranslateSalColor(nColor)

Converts SAL colors to a .NET Color.

Parameter	Type	Description
nColor	SalNumber

Returns: Color.

Undo()

Undoes the last edit in the control with the focus.

Returns: Boolean.

Update(ctrl)

Forces the repaint of a control.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.

Returns: Boolean.

UpdateMainMenu(form)

Updates the form's main menu.

Parameter	Type	Description
form	Form

Returns: Boolean.

Validate(ctrl, showErrorMessage)

Validates and formats a data field's or table window column's contents.

Parameter	Type	Description
ctrl	Control	Target control on which to execute the call.
showErrorMessage	Boolean

Returns: Boolean.

WaitCursor(wait)

Deprecated: Sal.WaitCursor is not supported. Displays or removes the hourglass cursor.

Parameter	Type	Description
wait	Boolean

Returns: Boolean.