SalWindow
PPJ.Runtime.Windows.SalWindow
Last updated
PPJ.Runtime.Windows.SalWindow
Last updated
Namespace: PPJ.Runtime.Windows
Assembly: PPJ.Runtime.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.
Creates a new instance of SalWindow and saves the control that is bound to this instance.
salWnd
: Returns/Sets the DesignMode flag.
: Enables/Disables the dispatching of Windows messages to the SAL MessageActions handler. This is used to suppress message dispatching when there is a potential recursive loop that will cause a stack overflow. For example, when setting the cursor .NET causes the WM_SETCURSOR message to be sent which might cause stack overflow if the function was originally called in response to WM_SETCURSOR.
Adds a string to the list control.
ctrl
Target control on which to execute the call.
text
Text to add to the list.
handler
target
Adds the specified handler to the list of delegates registered to handle the WindowActions event.
handler
Adds the handlers from the target window to the list of delegates registered to received the WindowActions event.
target
Brings a window to the top of all overlapping windows.
ctrl
Target control on which to execute the call.
Returns true of the selection in the control with the focus can be copied.
Returns true of the selection in the control with the focus can be cut.
Returns true if there is the control with the focus can paste the text in the clipboard.
Returns true if the control with the focus can undo the last edit operation.
Centers a window relative to the parent, or the owner, or the screen.
ctrl
Target control on which to execute the call.
Deletes the selection in the control with the focus.
Clears the value from a data field, multi line field, or table window column.
ctrl
Target control on which to execute the call.
Clears a window's cursor.
ctrl
Target control on which to execute the call.
type
Deletes all entries from the list control.
ctrl
Target control on which to execute the call.
Copies the selection from the control with the focus to the clipboard.
Clones the specified profile into the custom profile associated to the specified field.
ctrl
Target control on which to execute the call.
profile
Copies the text to the clipboard.
text
Creates a Font object from the specified parameters.
name
size
enhancement
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
type
owner
args
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
typeName
parent
args
Creates a form window, dialog box, or table window as a child of another form window, dialog box, or toolbar at runtime.
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.
typeName
parent
left
top
width
height
flags
Deletes the selected from the control with the focus and places it in the clipboard.
Deletes a list box or combo box entry.
ctrl
Target control on which to execute the call.
index
Index of the item to remove from the list.
Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.
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.
ctrl
Target control on which to execute the call.
Disables keyboard and mouse input to a window and grays out its associated label.
ctrl
Target control on which to execute the call.
Indicates whether a window can accept a file from Windows' File Manager.
ctrl
Target control on which to execute the call.
accept
Initiates drag-drop mode.
Initiates drag-drop mode.
pt
data
Aborts drag mode.
Enables keyboard and mouse input to a window.
ctrl
Target control on which to execute the call.
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.
ctrl
Target control on which to execute the call.
Destroys a modal dialog box and returns control to the caller of SalModalDialog.
ctrl
Target control on which to execute the call.
value
Draws a double gradient background.
g
start
middle
end
bounds
firstGradientSize
secondGradientSize
vertical
If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.
Draws a gradient background.
g
start
end
bounds
vertical
If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.
Finds a child window of a given name in the specified window.
ctrl
Target control on which to execute the call.
name
Finds a child window of a given type in the specified window.
ctrl
Target control on which to execute the call.
type
Finds a member control in the specified control. Used as a helper functions to resolve unqualified references.
ctrl
The control that owns the member to find.
name
Name of the member control to find.
throwIfNotFound
When true, throws a MissingMemberException if the member is not found. The default is true.
Find a member in the specified control. Used as a helper functions to resolve unqualified references.
ctrl
The control that owns the member to find.
name
The name of the member to find.
throwIfNotFound
When true, throws a MissingMemberException if the member is not found. The default is true.
Dispatches a Sal messages directly to the control's WindowActions handlers.
ctrl
Target control on which to execute the call.
msgCode
wParam
lParam
Dispatches the specified message (Window Actions) directly to the children's WindowActions event handlers, without going through Windows message loop.
ctrl
Target control on which to execute the call.
msg
wParam
lParam
Computes the number of pixels in the number form units.
ctrl
Target control on which to execute the call.
units
vertical
If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.
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.
handle
type
Return the name of a window's class as a string.
ctrl
Target control on which to execute the call.
Returns the SalClientArea panel.
ctrl
Target control on which to execute the call.
Gets the name of a control.
ctrl
Target control on which to execute the call.
ctrl
sName
Returns the type of control (TYPE_*).
ctrl
Target control on which to execute the call.
Returns the maximum length of a data field, multi line text field, or table window column.
ctrl
Target control on which to execute the call.
Returns a data field's or table window column's data type (DT_*).
ctrl
Returns the default push button on a form window or dialog box.
ctrl
Target control on which to execute the call.
Returns the first child window of the specified type.
parent
typeMask
One or more window types combined (using the OR (|) operator) to create a mask of child window types.
Returns the handle of the control with the focus.
ctrl
sName
nSize
nEnhancement
font
name
size
enhancement
Gets the names of the screen or printer fonts.
Gets the format of a data field or table window column.
ctrl
Target control on which to execute the call.
Returns the current format of a data field or table window column.
ctrl
Target control on which to execute the call.
Returns the contents of a data field or table window column.
ctrl
Target control on which to execute the call.
format
ctrl
paramType
value
Gets the input mask of a data field or table window column.
ctrl
Target control on which to execute the call.
Finds the Label assigned the specified control. Labels are assigned at startup using the TabIndex preceding the control.
ctrl
Target control on which to execute the call.
Retrieves the label text of a control.
ctrl
Target control on which to execute the call.
Returns the text of the label associated to the specified control.
ctrl
Target control on which to execute the call.
maxLen
ctrl
sText
maxLen
Returns the number of list box or combo box entries.
ctrl
Target control on which to execute the call.
Determines whether the specified list box or combo box entry is selected.
ctrl
Target control on which to execute the call.
index
Index of the item to check the state for.
Returns an entry in the list box or combo box.
ctrl
Target control on which to execute the call.
index
Index of the item to retrieve the text from.
ctrl
index
text
Returns the length of a list box or combo box entry.
ctrl
Target control on which to execute the call.
index
Index of the item to return the length for.
ctrl
fileName
Fetches the selected directory or file name from a list box or combo box.
ctrl
Target control on which to execute the call.
Returns the index of the selected entry in a combo box or single-selection list box.
ctrl
Target control on which to execute the call.
Fills the target array with the indexes of the selected entries in the list box.
ctrl
Target control on which to execute the call.
selectedArray
Array to receive the list of selected indices.
Returns the number of selected entries in a multiple-selection list box.
ctrl
Target control on which to execute the call.
Returns a window's current position on the X and Y axes.
ctrl
Target control on which to execute the call.
Returns the MDI client area of the MDI container.
ctrl
Target control on which to execute the call.
msg
Converts Windows' LParam value to the corresponding signed X,Y mouse coordinates.
lParam
Returns the next child control in the tab order that matches a specified type.
ctrl
Target control on which to execute the call.
typeMask
One or more window types combined (using the OR (|) operator) to create a mask of child window types.
Returns the handle of an object's parent window.
ctrl
Target control on which to execute the call.
Returns the code of the custom profile associated with the specified field.
ctrl
Target control on which to execute the call.
ctrl
paramCode
paramValue
ctrl
paramCode
paramValue
Gets the value of a named property for a control.
ctrl
Target control on which to execute the call.
name
ctrl
name
sValue
Returns the name of a SAM message.
msg
Returns the current scroll bar value.
ctrl
Target control on which to execute the call.
ctrl
nMin
nMax
nLine
nPage
Returns a window's size.
ctrl
Target control on which to execute the call.
Returns the collection of controls sorted by the TabIndex.
parent
Returns a window's current state.
ctrl
Target control on which to execute the call.
Returns the SalStatusBar control.
ctrl
Target control on which to execute the call.
Gets the text displayed in the status bar of a top-level or MDI window.
ctrl
Target control on which to execute the call.
Gets a system color.
colorValue
Retrieves the text of a control.
ctrl
Target control on which to execute the call.
ctrl
text
maxLen
Returns the string value of the specified control.
ctrl
Target control on which to execute the call.
maxLen
Returns the unmasked content of a data field or table window column.
ctrl
Target control on which to execute the call.
Returns the SalToolbar control.
ctrl
Target control on which to execute the call.
Gets a window's color.
ctrl
Target control on which to execute the call.
colorIndex
Returns true if the form has the accessories panels.
ctrl
Target control on which to execute the call.
Hides a control. Returns false if the control is already hidden.
ctrl
Target control on which to execute the call.
Hides a control and its associated label.
ctrl
Target control on which to execute the call.
Inserts an entry into a list box or combo box at a specified position.
ctrl
Target control on which to execute the call.
index
Position in the list where to insert the text .
text
Text of the item to insert in the list.
Causes a window to be repainted.
ctrl
Target control on which to execute the call.
Determines whether a radio button is set or a check box is checked.
ctrl
Target control on which to execute the call.
Returns true if a control is an instance of the class.
ctrl
Target control on which to execute the call.
type
Verifies whether a data field, multi line text field, or table window column is null or empty.
ctrl
Target control on which to execute the call.
Determines whether a window is enabled for mouse and keyboard input.
ctrl
Returns true if the message code is a mouse or a keyboard message.
msg
Returns the setting of the modified flag for a data field, multi line field, combo box, table window's context row cell.
ctrl
Target control on which to execute the call.
Returns true if the message code is a mouse or a keyboard message.
msg
Returns true if the message is a known SAM message.
msg
Returns true if the requested scrollbar is visible on the control.
control
bars
Validates the contents of a data field or table window column using the current profile.
ctrl
Target control on which to execute the call.
Verifies whether a data field, multi line text field, or table window column contains a valid date/time value.
ctrl
Target control on which to execute the call.
Verifies whether a data field, multi line text field, or table window column contains a valid decimal value.
ctrl
Target control on which to execute the call.
precision
scale
Validates the input mask of a data field or table window column.
mask
Validates a numeric or date/time picture format.
format
code
Verifies whether a data field, multi line text field, or table window column contains a valid integer value.
ctrl
Target control on which to execute the call.
Verifies whether a data field, multi line text field, or table window column contains a valid numeric value..
ctrl
Target control on which to execute the call.
Determines whether a window is currently visible.
ctrl
Target control on which to execute the call.
Destroys an control's system timer.
ctrl
Target control on which to execute the call.
id
Returns an array of index numbers of selected list box entries.
ctrl
Target control on which to execute the call.
Arranges minimized child window icons in an MDI window.
ctrl
Target control on which to execute the call.
Cascades all non-iconized child windows of an MDI window.
ctrl
Target control on which to execute the call.
Tiles all non-iconized child windows of an MDI window. Windows that are not sizable will not be tiled.
ctrl
Target control on which to execute the call.
vertical
If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.
Plays a waveform sound that corresponds to a given system alert level.
alert
Displays a message box and returns a number that indicates the user's response.
owner
text
title
flags
type
owner
args
typeName
owner
args
Moves a window a given number of form units on the X and Y axes relative to its current position.
ctrl
Target control on which to execute the call.
offset
Pastes the text in the clipboard to the control with the focus.
text
Computes the number of form units based on the number of pixels.
ctrl
Target control on which to execute the call.
pixels
vertical
If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.
Populates a list box or combo box with a result set.
ctrl
Target control on which to execute the call.
hSql
sql
SQL command to execute to populate the list.
Populates a list box or combo box with a result set.
ctrl
Target control on which to execute the call.
hSql
sql
SQL command to execute to populate the list.
errorHandler
Error handle callback.
ctrl
ctrlPath
pathName
attributes
Posts the specified message to a window by adding nMsg to handleReceiver's message queue.
ctrl
Target control on which to execute the call.
msg
wParam
lParam
Prints a form window, table window, or dialog box, including its contents and row header flags.
ctrl
Target control on which to execute the call.
Prints a form window, table window, or dialog box, including its contents and row header flags.
ctrl
Target control on which to execute the call.
m
handler
Removes the specified handler from the list.
handler
Scales the specified pixels by converting to form units first and then back to pixels using the new scaling factor.
size
oldScale
newScale
Scales the specified pixels by converting to form units first and then back to pixels using the new scaling factor.
point
oldScale
newScale
Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.
ctrl
Target control on which to execute the call.
msg
wParam
lParam
Sends a message to all child items of a form window, dialog box, table window, or MDI window.
ctrl
Target control on which to execute the call.
msg
wParam
lParam
ctrl
Target control on which to execute the call.
msgCode
wParam
lParam
Sends a SAM_Validate message to the object with the focus.
Defines the context menu for a control.
ctrl
Target control on which to execute the call.
menuName
flags
Defines the context menu for a control.
ctrl
Target control on which to execute the call.
menuType
flags
Sets a window's cursor.
ctrl
Target control on which to execute the call.
cursor
type
Sets a window's cursor.
ctrl
Target control on which to execute the call.
cursorId
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
Sets an application-defined cursor for the specified window. Use this function to set the cursor from an image stored in a file.
ctrl
Target control on which to execute the call.
fileName
The name of a cursor or an icon file.
type
Sets a window's cursor from a string variable.
ctrl
Target control on which to execute the call.
blob
type
Sets a limit on the number of characters that a user can enter into a data field, multi line text field, or table window column.
ctrl
Target control on which to execute the call.
maxLength
Sets the default push button of a form window or dialog box.
ctrl
Target control on which to execute the call.
Sets the focus to a specified window.
ctrl
Target control on which to execute the call.
Sets a window's font, font size, and font enhancements.
ctrl
Target control on which to execute the call.
name
size
enhancement
Sets the picture format of a data field or table window column.
ctrl
Target control on which to execute the call.
format
Sets a data field's or table window column's format.
ctrl
Target control on which to execute the call.
format
Copies a formatted string to a data field or table window column.
ctrl
Target control on which to execute the call.
text
applyFormat
Sets the input mask of a data field or table window column.
ctrl
Target control on which to execute the call.
mask
Changes the Label assigned to the specified control.
ctrl
Target control on which to execute the call.
label
Sets the label text of a control.
ctrl
Target control on which to execute the call.
text
Turns off or on redrawing on the list box or combo box.
ctrl
Target control on which to execute the call.
redraw
True to redraw the control.
Selects or deselects a combo box or single-selection list box entry. If the list box is multi select using -1 as the index value selects all items, while using any other invalid index value deselects all items. For normal list box, using -1 always deselects all items.
ctrl
Target control on which to execute the call.
index
Index of the item to select. Use -1 to select all items and -2 to deselect all items.
Selects or deselects a combo box or multiple-selection list box entry.
ctrl
Target control on which to execute the call.
index
Index of the item to select or deselect. Use -1 to select or deselect all the items in the list.
select
True to select the specified item(s), false to deselect the item(s).
Finds and selects a combo box or single-selection list box entry.
ctrl
Target control on which to execute the call.
startIndex
Position where to start the search for text .
text
Text to search for in the list.
Sets tabs in a list box. List boxes use tabs to align columns of data.
ctrl
Target control on which to execute the call.
tabStops
Array of tab stop position.
Moves a window to a new position (x, y) on the X and Y axes.
ctrl
Target control on which to execute the call.
pos
Sets or clears the field modified flag for an editable data field, combo box, multi line text field, table window column.
ctrl
Target control on which to execute the call.
modified
Changes the custom profile of the specified field.
ctrl
Target control on which to execute the call.
profile
Alters the specified parameter for the custom profile associated to the specified field.
ctrl
Target control on which to execute the call.
paramCode
paramValue
Alters the specified parameter for the custom profile associated to the specified field.
ctrl
Target control on which to execute the call.
paramCode
paramValue
Sets the value of a named property for a control.
ctrl
Target control on which to execute the call.
name
value
Sets a scroll bar's position.
ctrl
Target control on which to execute the call.
pos
Sets a scroll bar's range, line increment, and page increment.
ctrl
Target control on which to execute the call.
min
max
line
page
Resizes a window.
ctrl
Target control on which to execute the call.
size
Updates the status bar of the top level form that owns the specified control.
ctrl
Target control on which to execute the call.
text
Updates the status bar of the form that owns the menu item.
menu
text
Sets the text of a control to a specified string.
ctrl
Target control on which to execute the call.
text
Creates a system timer for a given control.
ctrl
Target control on which to execute the call.
id
millisec
Sets a window's color.
ctrl
Target control on which to execute the call.
colorIndex
nColor
Shows or hides the status bar on a top-level or MDI window.
ctrl
Target control on which to execute the call.
visible
Shows or hides the tool bar on a top-level or MDI window.
ctrl
Target control on which to execute the call.
visible
Makes a control visible.
ctrl
Target control on which to execute the call.
Makes a control and its associated label visible.
ctrl
Target control on which to execute the call.
Shows context popup menu at runtime.
ctrl
Target control on which to execute the call.
menuName
flags
pos
Shows context popup menu at runtime.
ctrl
Target control on which to execute the call.
menuType
flags
pos
Converts .NET colors to the corresponding SAL color constant.
color
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
ctrl
Target control on which to execute the call.
Translates CTD profile codes to the equivalent .NET CultureInfo.
profile
Converts SAL colors to a .NET Color.
colorValue
Undoes the last edit in the control with the focus.
Forces the repaint of a control.
ctrl
Target control on which to execute the call.
Updates the form's main menu.
form
Validates and formats a data field's or table window column's contents.
ctrl
Target control on which to execute the call.
showErrorMessage
Displays or removes the hourglass cursor.
wait
Starts the Windows help system.
ctrl
Target control on which to execute the call.
file
command
index
key
Processes messages in the message loop. This function replaces all SalYield* functions. It must be placed in the loop that block execution.
ctrl
Target control on which to execute the call.
: Returns the location of the mouse, in client's coordinates, when the drag-drop mode was initiated.
: Returns the source control for the drag-drop operations.
: Enables/Disables drag-drop operations.
: Returns the location of the mouse (in client's coordinates), when the mouse was released the drag-drop operation terminated.
: Returns the drop target control.
: Enables/Disables keeping the mask when reading the text from a masked edit control.
: Enables/Disables the mapping of the enter key to the tab key.
: Returns the collection of named properties.
: Returns the shared instance of the ProfessionalColors table. This is used by components that want to use colors similar to WinForms tool strip controls. Currently we use it for SalFormToolBar, XSalToolbar, XSalSeparator, XSalToolbox.
Returns: . The index of the added item or Sys.LB_Err (-1) if there is an error.
Deprecated: Deprecated. Use AddWindowActions() Adds the specified handler to the list of delegates registered to received the MessageActions event.
Deprecated: Deprecated. Use AddWindowActions(). Adds the handlers from the target window to the list of delegates registered to received the MessageActions event.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . DT_*
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . Number of items in the list.
Returns: . True if the item at the index position is selected, otherwise false.
Returns: . Text of the specified item.
Returns: .
Returns: . Length of the text of the specified item.
Returns: .
Returns: . Name of the selected file in t he control.
Returns: . Index of the first selected item.
Returns: . Number of selected items, which is the number of elements in selectedArray .
Returns: . Number of selected items in the list.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . Color
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . True if the control was previously visible.
Returns: .
Returns: . The index of the added item or Sys.LB_Err (-1) if there is an error.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . List of selected indices.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Creates a modal dialog box. See also:
Returns: .
Creates a modal dialog box. See also:
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
to use to execute the sql command.
Returns: .
to use to execute the sql command.
Returns: .
Returns: .
Returns: .
Deprecated: Deprecated. Use RemoveWindowActions() Removes the specified handler from the list.
Returns: .
Returns: .
Returns: .
Returns: .
Deprecated: Deprecated. Use SalWindow.FireWindowActions(). Dispatches a Sal messages directly to the control's WindowActions handlers.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . Index of the first item that matches the text or -1 if not found.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . True if the control was previously visible.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . Color
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
