Sal
PPJ.Runtime.Sal
Namespace: PPJ.Runtime
Assembly: PPJ.Web.49 (4.9.0.0)
Contains all Sal.* static functions.
Properties
ScriptEngine: Returns the instance of the interpreter used by SalCompileAndEvaluate.
Type: Returns/Sets the type of the ISalReport implementation.
Methods
Halts processing of the current menu action, message action, or application action.
Parameter | Type | Description |
---|---|---|
exitCode |
Returns: SalBoolean.
Disables input to all open forms.
Returns: SalBoolean.
Enables input to all open forms that were disabled.
Returns: SalBoolean.
Finds a visible top-level window.
Parameter | Type | Description |
---|---|---|
name | ||
activate |
Returns: SalWindowHandle.
Returns the average value of all the numbers in an array.
Parameter | Type | Description |
---|---|---|
array | The name of an array of numbers. |
Returns: SalNumber. nAvg
Parameter | Type | Description |
---|---|---|
array | ||
dim |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
array | ||
dim | ||
bound |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
array | ||
dim | ||
bound |
Returns: SalBoolean.
Determines if a dynamic array contains data.
Parameter | Type | Description |
---|---|---|
array | The name of the array to query. |
Returns: SalBoolean. bData
Returns the maximum value in an array of numbers.
Parameter | Type | Description |
---|---|---|
array |
Returns: SalNumber.
Returns the minimum value in an array of numbers.
Parameter | Type | Description |
---|---|---|
array |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
array | ||
min | ||
max |
Returns: SalNumber.
Sets the lower and upper bound of an array for the first dimension only. NOTE: In SAL this function was named SalSetArrayBounds().
Parameter | Type | Description |
---|---|---|
array | The name of the array to query. | |
lower | The new lower bound. | |
upper | The new upper bound or AC_Dynamic. |
Returns: SalBoolean. bOk
Sets the upper bound of an array. The first dimension is 1.
Returns: SalBoolean.
Returns the sum of the elements in an array of numbers.
Parameter | Type | Description |
---|---|---|
array | The name of an array of numbers. |
Returns: SalNumber. nSum
Brings a window to the top of all overlapping windows.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Centers a window. If the window is a top-level window, it centers it on the desktop. If the window is a child window, it centers it on top of its parent.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Clears the value from a data field, multiline field, or table window column.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Composes a color from red, green, and blue values.
Parameter | Type | Description |
---|---|---|
red | A number from 0 to 255. | |
green | A number from 0 to 255. | |
blue | A number from 0 to 255. |
Returns: SalNumber. colorValue
Gets a window's color.
Returns: SalNumber.
Gets a system color.
Parameter | Type | Description |
---|---|---|
colorIndex | The color of a part of the window, represented by one of these constants: COLOR_SysWindow COLOR_SysWindowFrame COLOR_SysWindowText |
Returns: SalNumber. colorValue
Sets a window's color.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
colorIndex | ||
colorValue |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
colorValue | ||
red | ||
green | ||
blue |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
color | ||
red | ||
green | ||
blue |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
sExpression | ||
nError | ||
nErrorPos | ||
numReturn | ||
sReturn | ||
dtReturn | ||
windowReturn | ||
bInhibitErrors | ||
context |
Returns: SalNumber.
Returns: SalString.
Returns an instance of SalStringContext wrapping the current context reference.
Parameter | Type | Description |
---|---|---|
context |
Returns: SalStringContext.
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
menuName | ||
flags |
Returns: SalBoolean.
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
menuType | ||
flags |
Returns: SalBoolean.
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
Returns: SalWindowHandle.
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
Returns: SalWindowHandle.
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
Returns: SalWindowHandle.
Creates a form window, dialog box, or table window as a child of another form window,
Parameter | Type | Description |
---|---|---|
tWndToCreate | ||
parent | ||
left | ||
top | ||
width | ||
height | ||
flags | ||
Parameters |
Returns: SalWindowHandle.
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 |
---|---|---|
formName | ||
parent | ||
left | ||
top | ||
width | ||
height | ||
flags |
Returns: SalWindowHandle.
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 |
---|---|---|
formName | ||
parent | ||
left | ||
top | ||
width | ||
height | ||
flags |
Returns: SalWindowHandle.
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
Returns: SalWindowHandle.
Clears a window's cursor.
Returns: SalBoolean.
Sets a window's cursor.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
resourceId | ||
type |
Returns: SalBoolean.
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 | Target control on which to execute the call. | |
fileName | ||
type |
Returns: SalBoolean.
Sets a window's cursor from a string variable.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
blob | ||
type |
Returns: SalBoolean.
Returns the date/time constructed from the parameters year, nMonth, nDay, nHour, minute, and nSecond.
Parameter | Type | Description |
---|---|---|
year | ||
month | ||
day | ||
hour | ||
minute | ||
second |
Returns: SalDateTime.
Returns the PC's current date/time.
Returns: SalDateTime.
Returns the day portion (1 to 31) of a date/time value or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the hour portion (0 to 23) of a date/time value or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the minute portion (0 to 59) of a date/time value or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the month portion (1 to 12) of a date/time value or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the date of the first day of the month or it returns DATETIME_Null if the value you specify is null. For example, if dateTime is December 25, 1992, SalDateMonthBegin returns December 1, 1992.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalDateTime.
Returns the quarter of the year (1 to 4) of a date/time value or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the date of the first day of the quarter of a date/time value or it returns DATETIME_Null if the value you specify is null.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalDateTime.
Returns the seconds portion (0 to 59) of a date/time value or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
date | ||
target |
Returns: SalNumber.
Returns the date of the previous Monday or the current day if it is a Monday or it returns DATETIME_Null if the value you specify is null.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalDateTime.
Returns the day of the week as a number between 0 and 6 or returns -1 if you specify DATETIME_Null as a parameter. 0 represents Saturday, 1 represents Sunday, and so on.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the year portion of a date or returns -1 if you specify DATETIME_Null as a parameter.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalNumber.
Returns the date of the first day of the year or it returns DATETIME_Null if the value you specify is null.
Parameter | Type | Description |
---|---|---|
dateTime |
Returns: SalDateTime.
Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
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 | Target control on which to execute the call. |
Returns: SalBoolean.
Disables keyboard and mouse input to a window and grays out its associated label. A label is the label control that immediately precedes the window. The label control must have a mnemonic. 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 | Target control on which to execute the call. |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
title | ||
colorValue |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
name | ||
size | ||
enhancements | ||
color |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
windowDlg | ||
orientation |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
dialogTitle | ||
roots | ||
filters | ||
filtersCount | ||
filterIndex | ||
fileName | ||
filePath |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
dialogTitle | ||
roots | ||
filters | ||
filtersCount | ||
filterIndex | ||
fileNames | ||
filePaths | ||
fileCount |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
dialogTitle | ||
roots | ||
filters | ||
filtersCount | ||
filterIndex | ||
fileName | ||
filePath |
Returns: SalBoolean.
Causes a dialog box to dock or undock with a parent window.
Parameter | Type | Description |
---|---|---|
windowDlg | ||
orientation |
Returns: SalBoolean.
Disables dropping while in drag mode.
Returns: SalBoolean.
Enables dropping while in drag mode.
Returns: SalBoolean.
Returns the IDataObject being dropped.
Returns: IDataObject.
Parameter | Type | Description |
---|---|---|
window | ||
x | ||
y |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
windowTarget | ||
x | ||
y |
Returns: SalBoolean.
Initiates drag mode.
Parameter | Type | Description |
---|---|---|
ctrl |
Returns: SalBoolean.
Ends drag mode.
Returns: SalBoolean.
Redraws the menu bar for a given form window or top-level table window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Retrieves the uploaded file.
Parameter | Type | Description |
---|---|---|
nFileIndex | Index of the file stream to retrieve. |
Returns: Stream.
Indicates whether a window can accept a file from Windows' File Manager.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
bAccept |
Returns: SalBoolean.
Retrieves the names of the files dropped on a window. Receipt of the SAM_DropFiles message indicates that the user dropped files onto the window.
Parameter | Type | Description |
---|---|---|
sArrayFiles |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
x | ||
y |
Returns: SalBoolean.
Indicates whether you can copy from the currently selected control on the clipboard.
Returns: SalBoolean. bOk
Returns: SalBoolean.
Indicates whether you can cut from the currently selected control on the clipboard.
Returns: SalBoolean. bOk
Returns TRUE if there is data on the Clipboard that can be pasted into the currently selected control
Returns: SalBoolean. bOk
Returns: SalBoolean.
Returns TRUE if the if there is any editing of the currently selected control that can be undone.
Returns: SalBoolean. bOk
Deletes selected data from the currently selected control
Returns: SalBoolean. bOk
Copies selected data from the currently selected control and puts it on the Clipboard.
Returns: SalBoolean. bOk
Copies a string to the Clipboard as text.
Parameter | Type | Description |
---|---|---|
str | The string to copy to the Clipboard. |
Returns: SalBoolean. bOk
Returns: SalBoolean.
Cuts selected data from the currently selected control and puts it on the Clipboard.
Returns: SalBoolean. bOk
Pastes data from the Clipboard into the currently selected control
Returns: SalBoolean. bOk
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalBoolean.
Undoes the last edit to the currently selected control Editing that you can undo includes inserting text, cutting text, clearing text, and pasting text.
Returns: SalBoolean.
Enables keyboard and mouse input to a window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
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.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Destroys a modal dialog box and returns control to the caller of SalModalDialog.
Returns: SalBoolean.
Stops tracing.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
file |
Returns: SalBoolean.
Copies the contents of one file (source) to another file (destination).
Parameter | Type | Description |
---|---|---|
sourcePath | The full path name of the source file. | |
destPath | The full path name of the destination file. | |
overwrite | Specifies whether (TRUE) or not (FALSE) to overwrite the destination file. If the destination file already exists and overwrite is FALSE, then SalFileCopy fails, and returns FILE_CopyExist. If the destination file already exists and overwrite is TRUE, then SalFileCopy succeeds and the destination file is overwritten. |
Returns: SalNumber. nStatus
Creates a directory.
Parameter | Type | Description |
---|---|---|
directory | The full path name of the new directory. |
Returns: SalBoolean. bOk
Parameter | Type | Description |
---|---|---|
file | ||
charValue |
Returns: SalBoolean.
Returns the next character in an open file.
Parameter | Type | Description |
---|---|---|
file | The handle of the open file. |
Returns: SalNumber. charValue
Parameter | Type | Description |
---|---|---|
path |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
fileName | ||
dateTime |
Returns: SalBoolean.
Gets the letter of the default (current) disk drive.
Returns: SalString. sDriveLetter
Parameter | Type | Description |
---|---|---|
file | ||
buffer | ||
bufferSize |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
file | ||
fileName | ||
style |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
file | ||
fileName | ||
style | ||
encoding |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
file | ||
fileName | ||
style | ||
reopen |
Returns: SalBoolean.
Writes a character to an open file.
Parameter | Type | Description |
---|---|---|
file | ||
charValue |
Returns: SalBoolean.
Writes a string to an open file and appends a carriage return/line feed character to the string.
Parameter | Type | Description |
---|---|---|
file | ||
str |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
file | ||
buffer | ||
bufferLength |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
file | ||
buffer | ||
bufferLength |
Returns: SalNumber.
Deletes a directory.
Parameter | Type | Description |
---|---|---|
directory |
Returns: SalBoolean.
Positions the file pointer in an open file.
Parameter | Type | Description |
---|---|---|
file | ||
bytes | ||
position |
Returns: SalBoolean.
Changes the current working directory. If the specified path does not contain a drive letter, the default drive's current directory is changed. Otherwise, the specified drive's current directory is changed and the specified drive is made the current drive.
Parameter | Type | Description |
---|---|---|
path | The path name of the new current working directory. |
Returns: SalBoolean. bOk
Sets the modification date and time of the specified file.
Parameter | Type | Description |
---|---|---|
fileName | The name of the file whose modification date you want to set. | |
dateTime | The modification date and time. |
Returns: SalBoolean. bOk
Sets the current disk drive to the specified drive letter.
Parameter | Type | Description |
---|---|---|
sDriveLetter | The new disk drive letter. The length of this parameter's value is one character. If you specify a value larger than this, reads only the first character. |
Returns: SalBoolean. bOk
Returns the current position in an open file.
Parameter | Type | Description |
---|---|---|
file | The handle of an open file. |
Returns: SalNumber. nPos
Writes a string to an open file.
Parameter | Type | Description |
---|---|---|
file | The handle of an open file. fileFile Handle. The handle of an open file. | |
buffer | The string to write to file. | |
bufferLength | The number of bytes to write. |
Returns: SalNumber. nResult
Writes a binary buffer to an open file.
Parameter | Type | Description |
---|---|---|
file | The handle of an open file. fileFile Handle. The handle of an open file. | |
buffer | The string to write to file. | |
bufferLength | The number of bytes to write. |
Returns: SalNumber. nResult
This function finds a child window of a given name in the specified window.
Returns: SalWindowHandle.
Dispatches the specified message (Window Actions) directly to the control's WindowActions event handlers, without going through Windows message loop.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nAction | Action type to send to ctrl . | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Returns: SalNumber.
Dispatches the specified message (Window Actions) directly to the children's WindowActions event handlers, without going through Windows message loop.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nAction | Action type to send to the direct children of ctrl . | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Returns: SalBoolean.
Copies the specified profile to the custom profile for the specified field. The control must use the customized profile set using FMT_Profile_Program.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
text | ||
bFormat |
Returns: SalBoolean.
Formats a date/time value using a given date/time picture format. If you do not specify a picture format or the one you specify is invalid, the default local settings are used
Parameter | Type | Description |
---|---|---|
dateTime | The date/time value to format. | |
sPicture | The date/time picture format. |
Returns: SalString. sDateTime
Formats a number value using a number picture format. If you do not specify a picture format or the one you specify is invalid, the default local settings are used
Parameter | Type | Description |
---|---|---|
num | The number value to format. | |
sPicture | The number picture format. |
Returns: SalString. sNumber
Returns the current format of a data field or table window column.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
sMask |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
nParm | ||
nValue |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
nParm | ||
value |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
sFormat |
Returns: SalBoolean.
Returns the culture profile for the specified field.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber.
Validates the contents of a data field or table window column using the current profile.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Validates the input mask of a data field or table window column.
Parameter | Type | Description |
---|---|---|
sMask | An input mask. |
Returns: SalBoolean. bOk
Validates a numeric or date/time picture format.
Returns: SalBoolean.
Turns on/off the flag that indicates whether to keep the mask when reading the text from masked edit controls.
Parameter | Type | Description |
---|---|---|
bKeep |
Returns: SalBoolean.
Sets a data field's or table window column's format.
Returns: SalBoolean.
Sets the input mask of a data field or table window column.
Returns: SalBoolean.
Modifies the specified formatting rule on the control. The control must use the customized profile set using FMT_Profile_Program.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nParm | ||
nValue |
Returns: SalBoolean.
Modifies the specified formatting rule on the control. The control must use the customized profile set using FMT_Profile_Program.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nParm | ||
value |
Returns: SalBoolean.
Sets the picture format of a data field or table window column.
Returns: SalBoolean.
Changes the culture profile for the specified field.
Returns: SalBoolean.
Copies a string to a data field or table window column. After copying the string to the field, formats the string.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
value | ||
bFormat |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
text |
Returns: SalBoolean.
Validates and formats a data field's or table window column's contents.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
name | ||
size | ||
nEnhancement |
Returns: SalBoolean.
Gets the names of the screen or printer fonts.
Parameter | Type | Description |
---|---|---|
nType | A constant that specifies whether to get the screen or printer fonts: FONT_GetPrinter FONT_GetScreen | |
sFonts | The name of an array of strings that contains the font names returned. |
Returns: SalNumber. nNames
Parameter | Type | Description |
---|---|---|
get | ||
fontName | ||
fontSizes |
Returns: SalNumber.
Sets a window's font, font size, and font enhancements.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
name | ||
size | ||
nEnhancement |
Returns: SalBoolean.
Computes the number of pixels in the number of form units. Form units are a unit of measurement used by functions which move and position objects. Form units are computed using physical units (pixels) in conjunction with the window's font size.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
formUnits | ||
vertical |
Returns: SalNumber.
Returns the current buffer length of a binary variable.
Parameter | Type | Description |
---|---|---|
buffer |
Returns: SalNumber.
Returns the current buffer length of a string.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalNumber.
Returns a data field's or table window column's data type.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber.
Returns the handle of the default push button on a form window or dialog box. The default push button is the one that has the focus by default.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalWindowHandle.
Returns the handle of the first child window of the specified type. You can use this function to get the handles of MDI child windows.
Returns: SalWindowHandle.
Returns the handle of the window with the focus.
Returns: SalWindowHandle. windowFocus
Parameter | Type | Description |
---|---|---|
ctrl | ||
name |
Returns: SalBoolean.
Returns the maximum length of a data field, multiline text field, or table window column.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber.
Returns the handle of the next child window that matches a specified type.
Returns: SalWindowHandle.
Retrieves the integer value of an entry in the specified section of an initialization file or registry.
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
section | ||
entry | ||
defaultValue | ||
value | ||
fileName |
Returns: SalNumber.
Returns the instance of ISalReport that is identified by the handle.
Parameter | Type | Description |
---|---|---|
handle | The reference handle to the ISalReport object. |
Returns: ISalReport.
Returns the version of the library.
Returns: SalNumber.
Retrieves the window handle of the label (label control) that is associated with the windowTarget parameter. There must be a mnemonic in that label, and it must immediately precede windowTarget, or this function will fail.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
ctrl | ||
text | ||
maxLength |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
x | ||
y |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
width | ||
height |
Returns: SalBoolean.
Returns a window's current state.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
text | ||
maxLen |
Returns: SalNumber.
Hides a window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Hides a window and its associated label.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Converts a string to a number so you can pass it as a message parameter.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalNumber.
Causes a window to be repainted.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Determines whether a radio button is set or a check box is checked.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Verifies whether a data field, multiline text field, or table window column is null or empty.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Verifies whether a data field, multiline text field, or table window column contains a valid date/time value. For multiline text fields, the date/time value must be the only item in the field.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Verifies whether a data field, multiline text field, or table window column contains a valid decimal value. For multiline text fields, the decimal value must be the only item in the field.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
precision | ||
scale |
Returns: SalBoolean.
Verifies whether a data field, multiline text field, or table window column contains a valid integer value. For multiline text fields, the integer value must be the only item in the field.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Verifies whether a data field, multiline text field, or table window column contains a valid numeric value. Valid numbers are integers or floating point numbers, negative and positive. For multiline text fields, the numeric value must be the only item in the field.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Determines whether a window is enabled for mouse and keyboard input.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Determines whether a window is currently visible.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Adds a string to a list box or combo box.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
text | Text of the item to add to the list. |
Returns: SalNumber. Index of the added item.
Deletes all entries from a list box or combo box.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Deletes a list box or combo box entry.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
index | Index of the item to remove from the list. |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
ctrlPath | ||
pathName | ||
attributes |
Returns: SalBoolean.
Returns an array of index numbers of selected list box entries.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
selectedArray | Array to receive the list of selected indices. |
Returns: SalBoolean. True if at least 1 item selected, otherwise false.
Inserts an entry into a list box or combo box at a specified position.
Parameter | Type | Description |
---|---|---|
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. |
Returns: SalNumber. The index of the added item or Sys.LB_Err (-1) if there is an error.
Populates a list box or combo box with a result set. SalListPopulate overrides any settings made with SalListSetTabs. If the SELECT statement returns data from multiple columns, each column's data displayed in a list box is separated by tabs.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
sql | A SalSqlHandle to execute the sql command. | |
select | SQL command to execute. |
Returns: SalBoolean.
Populates a list box or combo box with a result set. If the SELECT statement returns data from multiple columns, each column's data displayed in the list box is separated by tabs.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
sql | A SalSqlHandle to execute the sql command. | |
select | SQL command to execute. | |
errorHandler | SQL error handler callback. |
Returns: SalBoolean.
Returns the number of list box or combo box entries.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber. Number of items in the list.
Parameter | Type | Description |
---|---|---|
ctrl | ||
fileName |
Returns: SalBoolean.
Returns the number of selected entries in a multiple-selection list box. Specify single-selection or multiple-selection in the list box's customizer.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber. Number of selected items.
Returns the index of the selected entry in a combo box or single-selection list box.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber. Index of the currently selected item in the list, or -1 for no selection.
Determines whether the specified list box or combo box entry is selected.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
index | Index of the item to query. |
Returns: SalBoolean. True is the specified item is selected.
Parameter | Type | Description |
---|---|---|
ctrl | ||
index | ||
text |
Returns: SalNumber.
Returns the length of a list box or combo box entry.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
index | Index of the item to retrieve the text length for. |
Returns: SalNumber. Length of the text of the specified item.
Returns the text of the specified item.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
index | Index of the item to retrieve the text for. |
Returns: SalString. Text of the specified item.
Finds and selects a combo box or single-selection list box entry.
Parameter | Type | Description |
---|---|---|
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. |
Returns: SalNumber. Index of the first item that matches the text or -1 if not found.
Selects or deselects a combo box or multiple-selection list box entry.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
index | Index of the item to select or deselect. Use -1 for all the items in the list. | |
select | True to select, or false to deselect the item. |
Returns: SalBoolean.
Selects or deselects a combo box or single-selection list box entry.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
index | Index of the item to select. Use -1 for all the items in the list. |
Returns: SalBoolean.
Starts an application.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
name | ||
mode | ||
retCode |
Returns: SalBoolean.
Appends the string to the file.
Returns: SalBoolean.
Appends the string and a new line to the file.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
fileName |
Returns: SalBoolean.
Changes the behavior of the Enter key from executing the default button on a window to moving the focus to the next field.
Parameter | Type | Description |
---|---|---|
bState | True or false to enable or disable using the Enter key to tab to the next field. |
Returns: SalBoolean. The value of MapEnterToTab.
Generates a sound on the computer's speaker.
Parameter | Type | Description |
---|---|---|
sSoundBase64 | The beep to play in base64 wav format. The default is null to play the built-in beep. |
Returns: SalBoolean. Always True.
Displays a message box and returns a number that indicates the user's response. You can customize the message box push buttons and icons. The active parent window, whose value is hWndForm, creates the message box.
Parameter | Type | Description |
---|---|---|
text | The message text. | |
callback | Optional callback handler. When set, the messagebox is not modal. |
Returns: SalNumber. One of Sys.IDOK, Sys.IDCANCEL, Sys.IDRETRY, Sys.IDNO, Sys.IDYES, Sys.IDIGNORE, Sys.IDABORT.
Displays a message box and returns a number that indicates the user's response. You can customize the message box push buttons and icons. The active parent window, whose value is hWndForm, creates the message box.
Parameter | Type | Description |
---|---|---|
text | The message text. | |
title | The message box title. | |
flags | The message box style. Combine the MB_* options using the OR (|) operator. | |
callback | Optional callback handler. When set, the messagebox is not modal. |
Returns: SalNumber. One of Sys.IDOK, Sys.IDCANCEL, Sys.IDRETRY, Sys.IDNO, Sys.IDYES, Sys.IDIGNORE, Sys.IDABORT.
Displays a message box and returns a number that indicates the user's response. You can customize the message box push buttons and icons.
Parameter | Type | Description |
---|---|---|
owner | The owner of the message box. | |
text | The message text. | |
title | The message box title. | |
flags | The message box style. Combine the MB_* options using the OR (|) operator. | |
callback | Optional callback handler. When set, the messagebox is not modal. |
Returns: SalNumber. One of Sys.IDOK, Sys.IDCANCEL, Sys.IDRETRY, Sys.IDNO, Sys.IDYES, Sys.IDIGNORE, Sys.IDABORT.
Creates a modal dialog box.
Parameter | Type | Description |
---|---|---|
dialogType | The dialog to create. | |
owner | Owner of the dialog. | |
parameters | Optional parameter list. |
Returns: SalNumber. The value set when closing the dialog using EndDialog.
Creates a modal dialog box and returns the value asynchronously calling the provided callback function.
Parameter | Type | Description |
---|---|---|
dialogType | The dialog to create. | |
owner | Owner of the dialog. | |
callback | Callback method, invoked when the dialog is closed. | |
parameters | Optional parameter list. |
Creates a modal dialog box.
Parameter | Type | Description |
---|---|---|
dialogName | Name of the dialog to create. | |
owner | Owner of the dialog. | |
parameters | Optional parameter list. |
Returns: SalNumber.
Creates a modal dialog box.
Parameter | Type | Description |
---|---|---|
dialogName | Name of the dialog to create. | |
owner | Owner of the dialog. |
Returns: SalNumber.
Creates a modal dialog box asynchronously.
Parameter | Type | Description |
---|---|---|
dialogType | The dialog to create. | |
owner | Owner of the dialog. | |
parameters | Optional parameter list. |
Returns: Task<Int32>. The value set when closing the dialog using EndDialog.
Creates a modal dialog box asynchronously.
Parameter | Type | Description |
---|---|---|
dialogName | Name of the dialog to create. | |
owner | Owner of the dialog. | |
parameters | Optional parameter list. |
Returns: Task<Int32>.
Creates a modal dialog box.
Parameter | Type | Description |
---|---|---|
dialogName | Name of the dialog to create. | |
owner | Owner of the dialog. |
Returns: SalNumber.
Moves a window a given number of form units on the X and Y axes relative to its current position.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
xOffset | ||
yOffset |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
oObj |
Returns: SalBoolean.
Indicates that the object's transactional updates cannot be committed in the present time until SalMTSEnableCommit() or SalMTSSetComplete() is called. For non-MTS components the SalMTSDisableCommit() will fail (returns FALSE).
Returns: SalBoolean. bOk
Indicates that the object’s work is not necessarily done, but that its transactional updates can be committed in their current form (stateful object). EnableCommit is the default state when an object is activated. For non-MTS components the SalMTSEnableCommit() will fail (returns FALSE).
Returns: SalBoolean. bOk
Parameter | Type | Description |
---|---|---|
obj | ||
context |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
strRole | ||
bInRole |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
bIsInTransaction |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
bIsSecurityEnabled |
Returns: SalBoolean.
Indicates that the object’s work can never be committed. The entire transaction is aborted. The object is deactivated upon return from the method. For non-MTS components the SalMTSSetAbort() will fail (returnS FALSE).
Returns: SalBoolean. bOk
Indicates that the object has successfully completed its work for the transaction. The object is deactivated upon return from the method that first entered the context (stateless object). For non-MTS components the SalMTSSetComplete() will fail (returns FALSE).
Returns: SalBoolean. bOk
Adds a new group to the specified pane of a navigation bar.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane to which you want to add a group. | |
groupIndex | Zero-based index that the new group will occupy. | |
groupTitle | The title of the new group. | |
height | The height of the new group in form units. |
Returns: SalBoolean.
Inserts a pane into the navigation bar control.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Indicates a zero-based pane index. The new pane will be inserted after the pane indicated by nPaneIndex. Use -1 to append as the last pane. | |
name | Name of the new pane (object title) | |
image | File name of the image to display for the new pane. |
Returns: SalBoolean.
Associates a control to a pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane. | |
groupIndex | Zero-based index of the group. If the pane has no groups, use zero. | |
child | the control you're associating to the pane. |
Returns: SalBoolean.
Disassociates a control from a pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane | |
child | The control you're disassociating |
Returns: SalBoolean.
Enables or disables a pane on the navigation bar.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Index for the pane to enable (start at 0). | |
enable | Set TRUE to enable pane, FALSE to disable. |
Returns: SalBoolean.
Expands or collapses a group.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane | |
groupIndex | Zero-based index of the group | |
expand | Set to TRUE to expand, FALSE to collapse |
Returns: SalBoolean.
Returns the index of the currently selected pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. |
Returns: SalNumber. The zero-based index of the currently selected pane.
Parameter | Type | Description |
---|---|---|
control | ||
paneIndex | ||
image |
Returns: SalBoolean.
Finds the pane by its name and returns a zero-based index of the pane if successful or -1 if the pane is not found.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
name | The name of the pane (object title) |
Returns: SalNumber. the zero-based index of the pane. If the pane is not found, index is -1.
Parameter | Type | Description |
---|---|---|
control | ||
paneIndex | ||
title |
Returns: SalBoolean.
Returns the title of a pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Index for the pane whose title you want to get (start at 0) |
Returns: SalString.
Retrieves the group status. The function returns true if the group is expanded; false if collapsed.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane | |
groupIndex | Zero-based index of the group |
Returns: SalBoolean.
Restore the settings of a navigation bar from an XML string.
Returns: SalBoolean.
Returns true if the pane is enabled (visible in the pane navigator); false if disabled (not visible).
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Index of pane (start at 0). |
Returns: SalBoolean.
Removes a group from the navigation bar control.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane to be removed. | |
groupIndex | Zero-based index of the group to remove. |
Returns: SalBoolean.
Removes a pane from the navigation bar control.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Zero-based index of the pane to be removed. |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
control | ||
xml |
Returns: SalBoolean.
Activates the indicated pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | The zero-based index of the pane to activate. |
Returns: SalBoolean.
Sets the title of a pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Index for the pane. | |
image | File name of the image to display for the pane. |
Returns: SalBoolean.
Sets the title of a pane.
Parameter | Type | Description |
---|---|---|
control | The NavBar control. | |
paneIndex | Index for the pane whose title you want to get (start at 0). | |
title | The new title for the pane. |
Returns: SalBoolean.
Computes the absolute num.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes the arc cosine of a num in the range 0 to 1.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes a num's arc sine.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes a num's arc tangent.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes the arc tangent of two nums. This function uses the signs of both parameters to determine the quadrant of the return num.
Returns: SalNumber.
Computes an angle's cosine.
Parameter | Type | Description |
---|---|---|
angle |
Returns: SalNumber.
Computes an angle's hyperbolic cosine.
Parameter | Type | Description |
---|---|---|
angle |
Returns: SalNumber.
Computes a num's exponential function.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Returns a number's high-order word num (most significant 16 bits).
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes the length of the hypotenuse of a right triangle, given the lengths of the other two sides.
Returns: SalNumber.
Computes a number's natural logarithm.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes a number's base -10 logarithm.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Returns a number's low-order word num (least significant 16 bits).
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Returns the greater of two numbers.
Returns: SalNumber.
Returns the lesser of two numbers.
Returns: SalNumber.
Returns a number's modulo.
Returns: SalNumber.
Multiples a number by Pi.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes x raised to the power of y.
Returns: SalNumber.
Sets the starting point for generating a series of pseudo-random numbers using SalNumberRandom.
Parameter | Type | Description |
---|---|---|
seed |
Returns: SalBoolean.
Generates a pseudo-random number. The numbers generated by this function are integers in the range 0 to 32767.
Returns: SalNumber.
Returns a rounded number. If the fractional part of a number is greater than or equal to .5, rounds the number up. For example, the number 1.4 returns 1; the number 1.5 returns 2.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes an angle's sine.
Parameter | Type | Description |
---|---|---|
angle |
Returns: SalNumber.
Computes an angle's hyperbolic sine.
Parameter | Type | Description |
---|---|---|
angle |
Returns: SalNumber.
Computes a number's square root.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalNumber.
Computes an angle's tangent.
Parameter | Type | Description |
---|---|---|
angle |
Returns: SalNumber.
Computes an angle's hyperbolic tangent.
Parameter | Type | Description |
---|---|---|
angle |
Returns: SalNumber.
Converts a decimal num to a UNICODE character.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalString.
Converts a string handle to the corresponding string instance.
Parameter | Type | Description |
---|---|---|
handle |
Returns: SalString.
Parameter | Type | Description |
---|---|---|
num | ||
nDecimalPlaces | ||
str |
Returns: SalNumber.
Converts a number to a string.
Returns: SalString.
Converts a number to a window handle.
Parameter | Type | Description |
---|---|---|
num |
Returns: SalWindowHandle.
Truncates a number.
Returns: SalNumber.
Creates an instance of the class.
Parameter | Type | Description |
---|---|---|
className | Class name |
Returns: SalFunctionalClass.
This function returns the name of the class for the object.
Parameter | Type | Description |
---|---|---|
userObject |
Returns: SalString.
Returns true if the object is derived from the class specified.
Parameter | Type | Description |
---|---|---|
userObject | ||
className |
Returns: SalBoolean.
This function checks to see if the variable of a functional, coclass, or interface class is null.
Parameter | Type | Description |
---|---|---|
userObject |
Returns: SalBoolean.
Determine whether className holds a valid user-defined class name.
Parameter | Type | Description |
---|---|---|
className |
Returns: SalBoolean.
Returns the handle of an object's parent window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalWindowHandle.
Pauses the execution for the specified number of milliseconds.
Parameter | Type | Description |
---|---|---|
milliseconds |
Returns: Boolean.
Deletes the contents of a picture.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
description | ||
maxLen |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
buffer | ||
type |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
buffer | ||
type |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
format | ||
buffer |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
ctrl | ||
format | ||
buffer |
Returns: SalNumber.
Inserts a resource into a picture.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
resourceType | ||
format |
Returns: SalBoolean.
Inserts a file's contents into a picture.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | A SalPicture control. | |
fit | One of PIC_FitBestFit, PIC_FitScale, PIC_FitSizeToFit. | |
scaleWidth | Not supported. | |
scaleHeight | Not supported. |
Returns: SalBoolean.
Sets the fit for a picture.
Parameter | Type | Description |
---|---|---|
ctrl | A SalPicture control. | |
fit | One of PIC_FitBestFit, PIC_FitScale, PIC_FitSizeToFit. |
Returns: SalBoolean.
Sets the picture image of a picture window with the handle of a bitmap (HBITMAP) or icon (HICON). Usually, HBITMAPs and HICONs are loaded from DLLs.
Parameter | Type | Description |
---|---|---|
ctrl | An image control. | |
type | One of PIC_FormatIcon or PIC_FormatBitmap. | |
handle | HICON or HBITMAp handle of the image. |
Returns: SalBoolean.
Inserts the contents of a picture to an image without the image header.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
buffer | ||
type |
Returns: SalBoolean.
Inserts the contents of a string into a picture.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
format | ||
buffer |
Returns: SalBoolean.
Inserts the contents of a binary buffer into a picture.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
format | ||
buffer |
Returns: SalBoolean.
Computes the number of form units based on the number of pixels. Form units are a unit of measurement used by functions that move and position objects. Form units are computed using physical units (pixels) in conjunction with a window's font sizes.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nNumPixels | ||
vertical |
Returns: SalNumber.
Posts the specified message to a window by adding nMsg to windowReceiver's message queue.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nMsg | ||
wParam | ||
lParam |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
lParam | ||
left | ||
top | ||
right | ||
bottom |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
sDevice | ||
sDriver | ||
sPort |
Returns: SalBoolean.
Returns the list of installed printers.
Parameter | Type | Description |
---|---|---|
refresh | True to rebuild the list of printers. |
Returns: String[].
Parameter | Type | Description |
---|---|---|
nParm | ||
nValue |
Returns: SalBoolean.
Prints a form window, table window, or dialog box, including its contents and row header flags.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean. bOk
Prints a form window, table window, or dialog box, including its contents and row header flags.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean. bOk
Sets the default device (printer), driver, and port.
Parameter | Type | Description |
---|---|---|
sDevice | The default device. | |
sDriver | Not used. | |
sPort | Not used. |
Returns: SalBoolean. bOk
Resets print parameters back to their default values.
Returns: SalBoolean. bOk
Sets the value of a print parameter. The print parameters are a set of global variables which are initialized to default values and can be set using SalPrtSetParmNum, retrieved using SalPrtGetParmNum or reinitialized using SalPrtSetParmDefaults.
Parameter | Type | Description |
---|---|---|
nParm | A constant that represents the parameter to set; one of the PRT_* constants. | |
nValue | The parameter value. |
Returns: SalBoolean. bOk
Parameter | Type | Description |
---|---|---|
sDevice | ||
sDriver | ||
sPort | ||
bActiveOnly |
Returns: SalBoolean.
Returns the setting of the Field Edit Flag for a data field, multiline field, combo box, table window's context row cell, or picture.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Exits an application.
Returns: SalBoolean.
Closes a report window.
Parameter | Type | Description |
---|---|---|
reportWindow | Reference to the report window to close. |
Returns: SalBoolean. True if successful.
Sends a command to an open report window.
Parameter | Type | Description |
---|---|---|
reportWindow | Reference to the report window to send the command to. | |
command | The identifier of the command to send to the report window, one of: RPT_CmdFirstPage, RPT_CmdGoToPageRPT_CmdLastPageRPT_CmdNextPage, RPT_CmdPrevPage, RPT_CmdPrint, RPT_CmdPrinterSetup, RPT_CmdSizeActual, RPT_CmdSizeFit. Not all commands are implemented by all reporting engines/ |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
fileName | ||
variableNames | ||
inputs | ||
defaultReport | ||
error |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
fileName | ||
variableNames | ||
inputs | ||
defaultReport | ||
error | ||
template |
Returns: SalBoolean.
Sets the options for the report printing dialog box.
Parameter | Type | Description |
---|---|---|
reportWindow | Reference to the report window to configure. | |
caption | Title of the progress dialog. | |
line1 | Line 1 below the title of the progress dialog. | |
line2 | Line 2 below the title of the progress dialog. | |
docName | The of the document being printed to display on the progress dialog. |
Returns: SalBoolean. True if successful.
Parameter | Type | Description |
---|---|---|
reportWindow | ||
variableName | ||
value |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
reportWindow | ||
variableName | ||
value |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
reportWindow | ||
variableName | ||
value |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
windowReport | ||
printerName | ||
orientation | ||
paperType | ||
width | ||
height |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
reportWindow | ||
variableName | ||
value |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
owner | ||
template | ||
variableNames | ||
inputs | ||
flags |
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
owner | ||
template | ||
variableNames | ||
inputs | ||
copies | ||
options | ||
firstPage | ||
lastPage | ||
error |
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
owner | ||
template | ||
destFile | ||
variableNames | ||
inputs | ||
copies | ||
options | ||
firstPage | ||
lastPage | ||
rtfFormat | ||
error |
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
owner | ||
template | ||
destFile | ||
variableNames | ||
inputs | ||
options | ||
firstPage | ||
lastPage | ||
error |
Returns: SalWindowHandle.
Sets the value of a date/time report variable.
Parameter | Type | Description |
---|---|---|
windowReport | ||
variableName | ||
value |
Returns: SalBoolean.
Sets the value of a numeric report variable.
Returns: SalBoolean.
Sets the value of an object report variable.
Parameter | Type | Description |
---|---|---|
windowReport | The window handle of the report window. | |
variableName | The name of the variable whose value you want to set. | |
value | The value of variableName. |
Returns: SalBoolean. bOk
Sets the printer properties at runtime. This function should be called wile processing the SAM_ReportStart event.
Parameter | Type | Description |
---|---|---|
windowReport | ||
printerName | Friendly name of the printer. Pass STRING_Null or an empty string if you do not want to switch the printer. | |
orientation | Paper Orientation. Use one of the following constants: * RPT_Portrait for portrait mode. * RPT_Landscape for landscape mode. * Use -1 if you do not want to change the orientation. | |
paperType | Paper type. Use one of the RPT_Paper* constants or the PaperKind enum. | |
width | Paper width in milli-inches. This value is ignored for all paper types except for RPT_PaperCustom. | |
height | Paper height in milli-inches. This value is ignored for all paper types except for RPT_PaperCustom. |
Returns: SalBoolean.
Sets the value of a string report variable.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
fileName | ||
table | ||
error |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
fileName | ||
table | ||
error | ||
template |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
sTemplate | ||
nParamArray | ||
nError |
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
table | ||
parent | ||
sTemplate | ||
nError |
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
owner | ||
parent | ||
template | ||
variableNames | ||
inputs | ||
flags |
Returns: SalWindowHandle.
Finds the type in any loaded assembly. The first specified assembly argument has the precedence.
Returns: Type.
Parameter | Type | Description |
---|---|---|
ctrl | ||
nPos |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
min | ||
max | ||
line | ||
page |
Returns: SalBoolean.
Sets the scrollbar's value.
Returns: SalBoolean.
Sets a scroll bar's range, line increment, and page increment.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
min | ||
max | ||
line | ||
page |
Returns: SalBoolean.
Sends a message to all top-level windows in the system, including disabled or invisible unowned windows, overlapped windows, and pop-up windows; but the message is not sent to child windows.
Parameter | Type | Description |
---|---|---|
nMsg | Message code to send. | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Invokes the message actions implemented or inherited by an object's class when called from either a derived class or from an object that is an instance of a class.
Parameter | Type | Description |
---|---|---|
message | Message code to send. | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Returns: SalNumber. nMsgReturn
Invokes the message actions implemented or inherited by an object's class when called from either a derived class or from an object that is an instance of a class. Use this function instead of SalSendClassMessage with a class that is the result of multiple inheritance. It lets you specify which base class message action you want to execute.
Parameter | Type | Description |
---|---|---|
type | The ancestor's class name. | |
nMsg | Message code to send. | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Returns: SalNumber. nMsgReturn
Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nMsg | Message code to send. | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Returns: SalNumber.
Sends a message to all child items of a form window, dialog box, table window, or MDI window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
nMsg | Message code to send. | |
wParam | First argument value to send with the action message. | |
lParam | second argument value to send with the action message. |
Returns: SalBoolean.
Sends a SAM_Validate message to the object with the focus data field, multiline field, or table window column if it was edited and sets the wParam and lParam message variables to zero (0).
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
buffer | ||
length |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
str | ||
length |
Returns: SalBoolean.
Sets the default push button of a form window or dialog box.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Sets COM error information.
Returns: SalBoolean.
Sets or clears the field edit flag for an editable data field, combo box, multiline text field, table window column, or picture.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
set |
Returns: SalBoolean.
Sets the focus to a specified window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalWindowHandle.
Sets a limit on the number of characters that a user can enter into a data field, multiline text field, or table window column.
Returns: SalBoolean.
Set the value of an entry in the specified section of an initialization file or registry.
Returns: SalBoolean.
Sets the text of the label associated to a control. To be associated with a specific window, the background text (label control) must immediately precede the window in the tab index sequence. Important: The label control does not require a mnemonic for the function to operate.
Returns: SalBoolean.
Moves a window to a new position (x, y) on the X and Y axes.
Returns: SalBoolean.
Resizes a window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
width | ||
height |
Returns: SalBoolean.
Sets the text of a window.
Returns: SalBoolean.
Makes a window visible.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Makes a window and its associated label visible. A label is the label control that immediately precedes the window in the outline.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Begins tracing.
Parameter | Type | Description |
---|---|---|
outputType | ||
traceFile | ||
clearExisting |
Returns: SalBoolean.
Returns a "handle" to the first static on a window
Parameter | Type | Description |
---|---|---|
form |
Returns: SalNumber.
Gets the static "handle" if the label for a specified control
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
form | ||
handle | ||
x | ||
y |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
form | ||
handle | ||
width | ||
height |
Returns: SalBoolean.
Hides a static
Returns: SalBoolean.
Determines whether a static is visible.
Returns: SalBoolean.
Returns a "handle" to the last static on a window
Returns: SalNumber.
Sets the location coordinates of a static
Returns: SalBoolean.
Sets the size of a static
Returns: SalBoolean.
Shows a static
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
text | ||
maxLen |
Returns: SalNumber.
Displays specified text in the status bar of a top-level or MDI window.
Returns: SalBoolean.
Shows or hides the status bar on a top-level or MDI window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
show |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
str | ||
charCode |
Returns: SalBoolean.
Returns the current buffer length of a string.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalNumber.
Verifies that a string represents a valid currency value.
Returns: SalBoolean.
Verifies that string represents a valid date/time value.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalBoolean.
Verifies that an entire character string represents a valid decimal value.
Returns: SalBoolean.
Returns TRUE if the string is a valid identifier.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalBoolean.
Verifies that a string represents a valid number value.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
source | ||
length | ||
target |
Returns: SalNumber.
Returns a substring of a specified length starting at position zero.
Returns: SalString.
Returns a string's length.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
source | ||
target |
Returns: SalNumber.
Converts a string to lowercase.
Parameter | Type | Description |
---|---|---|
source |
Returns: SalString.
Parameter | Type | Description |
---|---|---|
source | ||
startPos | ||
length | ||
target |
Returns: SalNumber.
Returns a substring, starting at a specified position and containing a specified number of characters.
Returns: SalString.
Parameter | Type | Description |
---|---|---|
source | ||
target |
Returns: SalNumber.
Converts a string to a proper name.
Parameter | Type | Description |
---|---|---|
source |
Returns: SalString.
Parameter | Type | Description |
---|---|---|
source | ||
times | ||
target |
Returns: SalNumber.
Concatenates a string with itself a specified number of times.
Returns: SalString.
Parameter | Type | Description |
---|---|---|
source | ||
startPos | ||
length | ||
replace | ||
target |
Returns: SalNumber.
Replaces characters in one string with characters from another string.
Returns: SalString.
Parameter | Type | Description |
---|---|---|
source | ||
length | ||
target |
Returns: SalNumber.
Returns a string of specified length, starting with the last character in the string.
Returns: SalString.
Returns the offset of a specified substring.
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
str | ||
length |
Returns: SalBoolean.
Converts a string to a date/time value.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalDateTime.
Parses a string into substrings (tokens) based on specified start and end delimiters.
Parameter | Type | Description |
---|---|---|
source | ||
startDel | ||
endDel | ||
target |
Returns: SalNumber.
Converts a string to a number.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
source | ||
target |
Returns: SalNumber.
Strips leading and trailing blanks and compresses multiple spaces and tabs within a string to single spaces.
Parameter | Type | Description |
---|---|---|
source |
Returns: SalString.
Parameter | Type | Description |
---|---|---|
str |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
source | ||
target |
Returns: SalNumber.
Converts a string to uppercase.
Parameter | Type | Description |
---|---|---|
source |
Returns: SalString.
Adds a tab page at a valid index position.
Returns: SalBoolean.
Adds a tab page at a valid index position. You can include an image and a tooltip.
Parameter | Type | Description |
---|---|---|
control | ||
pageIndex | ||
pageName | ||
imageFile | ||
tooltip |
Returns: SalBoolean.
Associates a child to a tab page.
Returns: SalBoolean.
Assigns a child window created at runtime to the specified tab page as its container window. You can programmatically create a Form Window or Dialog Box as child and assign it to a tab page by using this function.
Returns: SalBoolean.
Detaches a child window from the specified tab control.
Returns: SalWindowHandle.
Disables a tab page.
Returns: SalBoolean.
Disassociates a child with a tab page.
Returns: SalBoolean.
Enables a tab page
Returns: SalBoolean.
Gets the current active tab page.
Parameter | Type | Description |
---|---|---|
control |
Returns: SalNumber.
Gets the tab page index as specified by the tab name.
Returns: SalNumber.
ets the name of the tab page (not the title that appears on the tab page at runtime).
Returns: SalString.
Gets the tab page title as specified by the tab index.
Returns: SalString.
Gets the window handle of the specified tab page.
Returns: SalWindowHandle.
Parameter | Type | Description |
---|---|---|
control | ||
pageIndex | ||
tooltip | ||
maxLength |
Returns: SalNumber.
Hides a tab page.
Returns: SalBoolean.
Hides the tab page selector inside the specified tab control. While the tab selector strop is hidden, you can change the active tab page by using SalTabSetActivePage.
Parameter | Type | Description |
---|---|---|
control |
Returns: SalBoolean.
Returns the number of tab pages.
Parameter | Type | Description |
---|---|---|
control |
Returns: SalNumber.
Removes a tab page.
Returns: SalBoolean.
Renames a tab page.
Returns: SalBoolean.
Activates a tab specified by a particular tab index.
Returns: SalBoolean.
Sets the title of the specified tab page.
Returns: SalBoolean.
Sets the tooltip text on the specified tab page. Tooltip text appears only on tab selector, not on a tab container window.
Returns: SalBoolean.
Shows a tab page
Returns: SalBoolean.
Shows the tab page selector inside the specified tab control.
Parameter | Type | Description |
---|---|---|
control |
Returns: SalBoolean.
Updates the Tab bar after a SalTabAssociateChild or SalTabDisassociateChild is called.
Parameter | Type | Description |
---|---|---|
control |
Returns: SalBoolean.
Shows or hides the tool bar on a top-level or MDI window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
show |
Returns: SalBoolean.
Determines whether any rows in the specified table window match certain flags.
Returns: SalBoolean.
Deselects all rows of a table window.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalBoolean.
Computes the average of all column values or only specified column values in a table window.
Returns: SalNumber.
Computes the sum of all column values or only specified column values in a table window.
Returns: SalNumber.
Copies the contents of the specified table window rows to the Clipboard in text format.
Returns: SalBoolean.
Creates a table window column of string data type at runtime.
Parameter | Type | Description |
---|---|---|
table | ||
columnPos | ||
displayWidth | ||
maxChars | ||
title |
Returns: SalNumber.
Creates a table window column using a given data type at runtime. Allowed types are DT_String, DT_Number and DT_DateTime
Parameter | Type | Description |
---|---|---|
table | ||
columnPos | ||
displayWidth | ||
title | ||
maxChars | ||
dataType |
Returns: SalNumber.
Define a column as a check box.
Returns: SalBoolean.
Define a column as a drop down list.
Returns: SalBoolean.
Define a column as a popup edit window.
Returns: SalBoolean.
Defines the appearance and behavior of a table window's row header.
Parameter | Type | Description |
---|---|---|
table | The table window or grid. | |
title | The title of the row header column. | |
width | The width of the row header in pixels. | |
flags | The row header attributes. You can combine these flags using the OR (|) operator. | |
column | The column that the row header mirrors. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Splits a table window horizontally.
Parameter | Type | Description |
---|---|---|
table | ||
rowsLowerHalf | ||
dragAdjust |
Returns: SalBoolean.
Deletes a row from a table window but not from the database.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
nRow | ||
nFlag |
Returns: SalBoolean.
Applies a SQL DELETE statement to all table window rows with the ROW Selected flag.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql |
Returns: SalBoolean.
Applies a SQL DELETE statement to all table window rows with the ROW Selected flag.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql | ||
errorHandler |
Returns: SalBoolean.
Destroys all automatic columns created by SalTblCreateColumn or SalTblPopulate at runtime. This function only works on table windows that contain only automatic columns.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. |
Returns: SalBoolean.
Applies a SQL DELETE statement to all table window rows that have flagsOn flags.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql | ||
flagsOn |
Returns: SalBoolean.
Applies a SQL DELETE statement to all table window rows that have flagsOn flags.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql | ||
flagsOn | ||
errorHandler |
Returns: SalBoolean.
Applies a SQL INSERT statement to all the rows in a table window that have the ROW New flag.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql | ||
clearFlags |
Returns: SalBoolean.
Applies a SQL INSERT statement to all the rows in a table window that have the ROW New flag.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql | ||
clearFlags | ||
errorHandler |
Returns: SalBoolean.
Applies a SQL UPDATE statement to all table window rows with the Row Edited flag.
Parameter | Type | Description |
---|---|---|
table | ||
sql | ||
clearFlags | ||
errorHandler |
Returns: SalBoolean.
Applies a SQL UPDATE statement to all table window rows with the Row Edited flag.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
sql | ||
clearFlags |
Returns: SalBoolean.
Sends a SAM_FetchRow message to a table window if the row you specify is not currently in the table window cache.
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
table | ||
row | ||
flagsOn | ||
flagsOff |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
row | ||
flagsOn | ||
flagsOff |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
columnId | ||
text |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
column | ||
text | ||
maxLen |
Returns: SalNumber.
Gets the handle of a table window column.
Parameter | Type | Description |
---|---|---|
table | Target control on which to execute the call. | |
col | ||
flags |
Returns: SalWindowHandle.
Inserts a new blank row into a table window.
Returns: SalNumber.
Takes a row out of edit mode and selects the row. This causes the row to receive both SAM_Validate and SAM_KillFocus messages.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalBoolean.
Turns off the table window's focus frame.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
x | ||
y | ||
row | ||
column | ||
flags |
Returns: SalBoolean.
Pastes the contents of the Clipboard to the specified table window. Assumes the Clipboard data is in text format with cells delimited by tab characters and rows delimited by end-of-line characters. Inserts the new rows into the table window without overwriting existing rows, and converts the data to the data types of the corresponding table window columns.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalBoolean.
Compiles, binds, and executes a SQL SELECT statement, then fetches the rows of the result set and populates a table window with them.
Parameter | Type | Description |
---|---|---|
table | ||
sql | ||
select | ||
method |
Returns: SalBoolean.
Compiles, binds, and executes a SQL SELECT statement, then fetches the rows of the result set and populates a table window with them.
Parameter | Type | Description |
---|---|---|
table | ||
sql | ||
select | ||
method | ||
errorHandler |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
column | ||
flags | ||
checkedValue | ||
uncheckedValue |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
column | ||
type |
Returns: SalBoolean.
Tests the state of a table window column's flags.
Returns: SalBoolean.
Gets a table window column's identifier.
Parameter | Type | Description |
---|---|---|
column |
Returns: SalNumber.
Gets a table window column's relative position.
Parameter | Type | Description |
---|---|---|
column |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
column | ||
width |
Returns: SalBoolean.
Returns a table window's current context row. Before sending a SAM_FetchRow message, automatically sets the context row so that assignments made while processing the message reference the correct row.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
column | ||
flags | ||
lines |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
row | ||
column |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
nLines |
Returns: SalBoolean.
Retrieves the number of locked table window columns.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalNumber.
Parameter | Type | Description |
---|---|---|
column | ||
flags | ||
lines |
Returns: SalBoolean.
Queries a row's flags.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
title | ||
maxTitle | ||
width | ||
flags | ||
windowCol |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
position | ||
minRange | ||
maxRange |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
rowsLowerHalf | ||
dragAdjust |
Returns: SalBoolean.
Tests the state of a table window's flags.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
table | ||
minRange | ||
maxRange |
Returns: SalBoolean.
Clears a table window by discarding all rows from the table window cache and setting the table range to 0, -1.
Parameter | Type | Description |
---|---|---|
table |
Returns: SalBoolean.
Scrolls a table window to the specified row and column.
Returns: SalBoolean.
Scrolls a table window to the specified row and column.
Returns: SalBoolean.
Changes a table window cell's text color.
Parameter | Type | Description |
---|---|---|
column | ||
colorValue | ||
discardable |
Returns: SalBoolean.
Changes a table window cell's text color.
Returns: SalBoolean.
Sets or clears a table window column's flags.
Parameter | Type | Description |
---|---|---|
column | ||
flags | ||
set |
Returns: SalBoolean.
Moves a table window column to a new position.
Returns: SalBoolean.
Assigns data to a column of a table window's context row.
Returns: SalBoolean.
Sets the title of a table window column.
Returns: SalBoolean.
Sets a table window column's display width.
Returns: SalBoolean.
Sets a table window's context row. Setting the context row does not send a SAM_FetchRow message. If the row is not currently in memory, creates a new row in memory and sets its cell values to null.
Returns: SalBoolean.
Sets or clears row flags.
Parameter | Type | Description |
---|---|---|
table | ||
flags | ||
set | ||
flagsOn | ||
flagsOff |
Returns: SalBoolean.
Sets the focus to the specified table window cell (row and column). Puts the table window into edit mode and lets the user select a portion of the data in the cell.
Returns: SalBoolean.
Sets a table window's focus frame row.
Returns: SalBoolean.
Sets the height of a row in lines.
Returns: SalBoolean.
Sets the number of locked table window columns.
Returns: SalBoolean.
Defines the minimum and maximum rows (range) of a table.
Returns: SalBoolean.
Sets the focus to the first, last, next, or previous row in a table window.
Returns: SalNumber.
Sets or clears a table window row's flags.
Parameter | Type | Description |
---|---|---|
table | ||
row | ||
flags | ||
set |
Returns: SalBoolean.
Sets or clears a table window's flags.
Parameter | Type | Description |
---|---|---|
table | ||
flags | ||
set |
Returns: SalBoolean.
Sorts the rows of a table window based on the values in one of the table window's columns.
Returns: SalBoolean.
Destroys an object's system timer.
Returns: SalBoolean.
Creates a system timer for a given object. When a timer event occurs, sends SAM_Timer messages to the object in specified intervals. Timers are a limited global resource. Your application must check the value returned by SalTimerSet to verify that the timer was created.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
eventId | ||
milliseconds |
Returns: SalBoolean.
Outputs a string to the trace output target.
Returns: SalBoolean.
Creates pop-up menus at runtime.
Parameter | Type | Description |
---|---|---|
owner | ||
menuName | ||
flags | ||
x | ||
y | ||
callback |
Returns: SalBoolean.
Creates pop-up menus at runtime.
Parameter | Type | Description |
---|---|---|
owner | ||
menuType | ||
flags | ||
x | ||
y | ||
callback |
Returns: SalBoolean.
Collapse a tree item. If the tree item handle is 0, then the top level tree items of the tree control are collapsed.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Removes a tree item from a tree control. All child items of the tree item are also removed.
Returns: SalBoolean. TRUE if the item was deleted successfully.
Moves a tree item so it becomes the child of its previous sibling. This function will fail if the tree item has no previous sibling.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Allows the user to edit the value of the tree item's label. SAM_Validate is sent to the tree control when the edit control loses focus with wParam indicating the handle to the tree item.
Returns: SalBoolean. TRUE if edit has been activated.
Enables the tree item when bEnable is true, disables the tree item when bEnable is false.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bEnable | Set to TRUE to enable the item. Set to FALSE to disable the item. |
Returns: SalBoolean. previous state of the item before this function was called. TRUE if it was enabled, FALSE if it was disabled.
Expand a tree item. If the tree item handle is 0, then the top level tree items of the tree control are expanded.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Finds a tree item by its Object Data. Returns 0 if not found. Searches the child items of the tree item handle argument(hItem). If the handle is 0, searches the top level tree items.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
nData | Data of the item to find. |
Returns: SalNumber. Handle of the tree item whose Data matches the nData parameter.
Finds a tree item by its object title. Returns 0 if not found. Searches the child items of the tree item handle argument. If the handle is 0, searches the top level tree items.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
sTitle | Title of the item to find. |
Returns: SalNumber. Handle of the item whose title matches the sTitle parameter.
Gets the first child tree item of the passed tree item handle. Returns 0 if not found. If the handle is 0, returns the first child of the tree control. If the ShowRootLines attribute is set to Yes, and 0 is passed in, returns the root node of the tree control.
Returns: SalNumber. Handle of the tree item.
Gets the number of child items. If the handle argument is 0, then number of first level child items is returned.
Returns: SalNumber. Number of items.
Returns the numeric value assigned to the tree item.
Returns: SalNumber. Numeric value assigned to the tree item.
Returns the handle of hItem's parent, or 0 if hItem is a top level child of the tree control.
Returns: SalNumber. Handle of hItem's parent.
Returns the string title of the item.
Returns: SalString. String title of the item.
Returns the current tooltip for the tree item.
Returns: SalString. Current tooltip for the tree item.
Gets the next sibling tree item of the passed tree item handle. Returns 0 if there are no more sibling tree items.
Returns: SalNumber. Handle of the next tree item.
Gets the previous sibling tree item of the passed tree item handle. Returns 0 if there are no more sibling items.
Returns: SalNumber. Handle of the previous tree item.
Returns the handle to the selected tree item, or 0 if no item is selected.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. |
Returns: SalNumber. Handle to the selected tree item, or 0 if no item is selected.
Inserts a tree item into the tree control. The new item will be a child of nItem.If nItem is 0, the tree item is added as a top level child of the tree control. If nIndex is greater than or equal to the number of child items, or if nIndex is less than zero, the new item is appended.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle of the tree item which will be the parent of the new item. | |
nIndex | Index to insert (starting at zero). | |
sTitle | Title of the new item. |
Returns: SalNumber. Handle of the newly created item.
Returns true if the tree item has a checkbox displayed.
Returns: SalBoolean. TRUE if the item has a checkbox displayed, FALSE if not.
Returns true if the item checkbox is checked. Returns false if the checkbox is not displayed.
Returns: SalBoolean. TRUE if the checkbox is checked. If the checkbox is not checked, or is not displayed, bIsChecked is FALSE.
Returns whether the item is expanded.
Returns: SalBoolean. TRUE if the item is expanded, FALSE if not.
Returns whether the item is selected.
Returns: SalBoolean. TRUE if the item is selected, FALSE if not.
Returns true if the tree shows checkboxes next to the items.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. |
Returns: SalBoolean. TRUE if the items have a checkbox displayed, FALSE if not.
Moves a tree item downward. This functions fails if the tree item is the last child of its parent.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Moves a tree node and all its sub-nodes to a new location in the tree control.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
hParentItem | Handle to the new parent tree item. | |
nPosition | Position in the new parents list of children to place the new child (0-n). |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Moves a tree item upward . This functions fails if the tree item is the first child of its parent.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Moves a tree item so it becomes the sibling of its parent. This functions fails if the tree item has no grandparent.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Clears a tree control with the option to retain or destroy design-time nodes.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
bRemove | TRUE = Remove all nodes. FALSE = Remove nodes created dynamically; the tree goes back to the initial state. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it does not succeed.
Sets or clears the checkbox. If the checkbox is not displayed, this function has no effect.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bChecked | TRUE to set the box as checked, FALSE to clear the checkbox. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the numeric value of the tree item.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
nValue | Value to set. |
Returns: SalNumber. Value that was previously assigned to the tree item.
Sets whether the tree item's label can be edited. If bEditable is true, the label can be edited.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bEditable | Whether to enable or disable editing. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the font enhancement for a tree item.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
nFontEnh |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the image of a tree item. If the bSelected parameter is true, the selected image is set; otherwise the non-selected image is set.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bSelected | If TRUE, use selected image. If FALSE, use non-selected image. | |
sImageFile | Filename of the image. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the image of a tree item. If the bSelected parameter is true, the selected image is set; otherwise the non-selected image is set.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bSelected | If TRUE, use selected image. If FALSE, use non-selected image. | |
nFormat | The format of the picture contents: PIC_FormatBitmap, PIC_FormatIcon, PIC_FormatObject | |
bPicture | The image data to be assigned to the tree node. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the image of a tree item. If the bSelected parameter is true, the selected image is set; otherwise the non-selected image is set.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bSelected | If TRUE, use selected image. If FALSE, use non-selected image. | |
tResource | Resource object. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the title of the item.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
sText | Text to set as the title for this tree item. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the text color of the tree item.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
nColor | Color to set. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Sets the tooltip for the tree item.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
sTooltip | Tooltip text. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Selects a tree item.
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Shows or hides the checkbox for a tree item.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
hItem | Handle to the tree item. | |
bShow | TRUE to show the checkbox, FALSE to hide it. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Shows or hides the checkboxes for a tree control.
Parameter | Type | Description |
---|---|---|
ctrl | Tree control. | |
bShow | TRUE to show the checkboxes, FALSE to hide them. |
Returns: SalBoolean. TRUE if the function succeeds and FALSE if it fails.
Forces the update of a window.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalBoolean.
Enables logging of unhandled exceptions in the event log.
Parameter | Type | Description |
---|---|---|
useLog | ||
resume |
Returns: SalBoolean.
Redirects all SalProfile* functions to use the Registry.
Parameter | Type | Description |
---|---|---|
useRegistry | ||
companyName |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
window | ||
state | ||
lParam |
Returns: SalBoolean.
Displays or removes the hourglass cursor.
Parameter | Type | Description |
---|---|---|
bOn |
Returns: SalBoolean.
Return the name of a window's class as a string.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. |
Returns: SalString.
Parameter | Type | Description |
---|---|---|
window | ||
orientation |
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
ctrl | ||
name | ||
value |
Returns: SalBoolean.
Converts a SalWindowHandle to a number.
Parameter | Type | Description |
---|---|---|
window | The handle to convert. |
Returns: SalNumber. nWnd
Converts a SalFileHandle to a number.
Parameter | Type | Description |
---|---|---|
file |
Returns: SalNumber.
Converts a SalSqlHandle to a number.
Parameter | Type | Description |
---|---|---|
sql |
Returns: SalNumber.
Converts a SalSqlSessionHandle to a number.
Parameter | Type | Description |
---|---|---|
session |
Returns: SalNumber.
Determines whether a window is an instance of the specified class.
Returns: SalBoolean.
Sets the value of a named property.
Parameter | Type | Description |
---|---|---|
ctrl | Target control on which to execute the call. | |
name | ||
value | ||
length |
Returns: SalBoolean.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
errorCode | ||
errorMessage |
Returns: SalBoolean.
Serializes the object to a XML file.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
set |
Returns: SalBoolean.
Returns: SalBoolean.
Parameter | Type | Description |
---|---|---|
window |
Returns: SalBoolean.
Returns: SalBoolean.
Last updated