SalWindowHandle

PPJ.Runtime.SalWindowHandle

Namespace: PPJ.Runtime

Assembly: PPJ.Runtime.49 (4.9.0.0)

SAL WindowHandle basic type. This class holds either a raw handle (a handle to SalSqlHandle, SalSqlSessionHandle, SalFileHandle, or a native control handle) or a weak reference to a .NET control.

public struct SalWindowHandle : ValueType, IConvertible, IComparable, ISalType, ISerializable, IXmlSerializable

Constructors

SalWindowHandle(handle)

Creates a new SalWindowHandle.

Name
Type
Description

handle

SalWindowHandle(ctrl)

Creates a new SalWindowHandle.

Name
Type
Description

Properties

Control

Control: Returns the referenced control instance.

IsNull

Boolean: Checks if this SalWindowHandle object contain a null value.

Value

IntPtr: Returns the Handle value.

Methods

AddListItem(sName)

Adds a string to a list box or combo box.

Parameter
Type
Description

Returns: SalNumber.

AnyRows(flagsOn, flagsOff)

Determines whether any rows in the specified table window match certain flags.

Parameter
Type
Description

flagsOn

flagsOff

Returns: SalBoolean.

BringWindowToTop()

Brings a window to the top of all overlapping windows.

Returns: SalBoolean.

CenterWindow()

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.

Returns: SalBoolean.

Clear()

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

Returns: SalBoolean.

ClearCursor(type)

Clears a window's cursor.

Parameter
Type
Description

Returns: SalBoolean.

ClearImage()

Deletes the contents of a picture.

Returns: SalBoolean.

ClearList()

Deletes all entries from a list box or combo box.

Returns: SalBoolean.

ClearSelection()

Deselects all rows of a table window.

Returns: SalBoolean.

ColumnAverage(nColumnID, flagsOn, flagsOff)

Computes the average of all column values or only specified column values in a table window.

Parameter
Type
Description

nColumnID

flagsOn

flagsOff

Returns: SalNumber.

ColumnSum(columnId, flagsOn, flagsOff)

Computes the sum of all column values or only specified column values in a table window.

Parameter
Type
Description

columnId

The Column Identifier.

flagsOn

The flags that the row should have. You can combine ROW* flags using the OR (|) operator.

flagsOff

The flags that the row should not have. You can combine ROW* flags using the OR (|) operator.

Returns: SalNumber. The sum of all column values or only specified column values in a table window or grid. Returns zero (0) if an error occurs.

Use row flag constants to specify the rows to use to compute the sum. For example, you can choose to sum only the values of modified rows.

CompareTo(obj)

compare to an object

Parameter
Type
Description

Returns: Int32.

CompareTo(handle)

compare to a SalWindowHandle

Parameter
Type
Description

Returns: Int32.

CopyRows(flagsOn, flagsOff)

Copies the contents of the specified table window rows to the Clipboard in text format.

Parameter
Type
Description

flagsOn

flagsOff

Returns: SalBoolean.

CreateColumn(nColumnPos, nDispWidth, nMaxChars, sTitle)

Creates a table window column of string data type at runtime.

Parameter
Type
Description

nColumnPos

nDispWidth

nMaxChars

sTitle

Returns: SalNumber.

CreateColumnEx(nColumnPos, nDispWidth, sTitle, nMaxChars, nDatatype)

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

nColumnPos

nDispWidth

sTitle

nMaxChars

nDatatype

Returns: SalNumber.

DefineCheckBoxColumn(flags, checkedValue, uncheckedValue)

Define a column as a check box.

Parameter
Type
Description

checkedValue

uncheckedValue

Returns: SalBoolean.

DefineDropDownListColumn(flags, lines)

Define a column as a drop down list.

Parameter
Type
Description

Returns: SalBoolean.

DefinePopupEditColumn(flags, lines)

Define a column as a popup edit window.

Parameter
Type
Description

Returns: SalBoolean.

DefineRowHeader(title, width, flags, column)

Defines the appearance and behavior of a table window's row header.

Parameter
Type
Description

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.

DefineSplitWindow(nRowsLowerHalf, bDragAdjust)

Splits a table window horizontally.

Parameter
Type
Description

nRowsLowerHalf

bDragAdjust

Returns: SalBoolean.

DeleteListItem(nIndex)

Deletes a list box or combo box entry.

Parameter
Type
Description

nIndex

Returns: SalNumber.

DeleteRow(nRow, nFlag)

Deletes a row from a table window but not from the database.

Parameter
Type
Description

Returns: SalBoolean.

DeleteSelected(hSql)

Applies a SQL DELETE statement to all table window rows with the ROW Selected flag.

Parameter
Type
Description

Returns: SalBoolean.

DeleteSelected(hSql, errorHandler)

Applies a SQL DELETE statement to all table window rows with the ROW Selected flag.

Parameter
Type
Description

Returns: SalBoolean.

DestroyColumns()

Destroys all automatic columns created by SalTblCreateColumn or SalTblPopulate at runtime. This function only works on table windows that contain only automatic columns.

Returns: SalBoolean.

DestroyWindow()

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

Returns: SalBoolean.

DisableWindow()

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.

Returns: SalBoolean.

DisableWindowAndLabel()

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 in the outline. 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.

Returns: SalBoolean.

DoDeletes(hSql, flagsOn)

Applies a SQL DELETE statement to all table window rows that have flagsOn flags.

Parameter
Type
Description

Returns: SalBoolean.

DoDeletes(hSql, flagsOn, errorHandler)

Applies a SQL DELETE statement to all table window rows that have flagsOn flags.

Parameter
Type
Description

Returns: SalBoolean.

DoInserts(hSql, bClearFlags)

Applies a SQL INSERT statement to all the rows in a table window that have the ROW New flag.

Parameter
Type
Description

bClearFlags

Returns: SalBoolean.

DoInserts(hSql, bClearFlags, errorHandler)

Applies a SQL INSERT statement to all the rows in a table window that have the ROW New flag.

Parameter
Type
Description

Returns: SalBoolean.

DoUpdates(hSql, bClearFlags)

Applies a SQL UPDATE statement to all table window rows with the Row Edited flag.

Parameter
Type
Description

bClearFlags

Returns: SalBoolean.

DoUpdates(hSql, bClearFlags, errorHandler)

Applies a SQL UPDATE statement to all table window rows with the Row Edited flag.

Parameter
Type
Description

Returns: SalBoolean.

DrawMenuBar()

Redraws the menu bar for a given form window or top-level table window.

Returns: SalBoolean.

EnableWindow()

Enables keyboard and mouse input to a window.

Returns: SalBoolean.

EnableWindowAndLabel()

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

Returns: SalBoolean.

EndDialog(nReturn)

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

Parameter
Type
Description

nReturn

Returns: SalBoolean.

FetchRow(nRow)

Sends a SAM_FetchRow message to a table window if the row you specify is not currently in the table window cache.

Parameter
Type
Description

Returns: SalNumber.

FindChild(windowName)

This function finds a child window of a given name in the specified window.

Parameter
Type
Description

windowName

Returns: SalWindowHandle.

FindControl(name)

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

Parameter
Type
Description

name

Returns: Control.

FindMember(name)

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

Parameter
Type
Description

name

Returns: ReferenceInfo.

FindNextRow(Row, flagsOn, flagsOff)

Parameter
Type
Description

Returns: SalBoolean.

FindPrevRow(Row, flagsOn, flagsOff)

Parameter
Type
Description

Returns: SalBoolean.

FireWindowActions(msg, mywParam, mylParam)

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

Parameter
Type
Description

mywParam

mylParam

Returns: SalNumber.

FireWindowActionsToChildren(nMsg, nMywParam, nMylParam)

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

Parameter
Type
Description

nMsg

nMywParam

nMylParam

Returns: SalBoolean.

FormUnitsToPixels(formUnits, vertical)

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

formUnits

The number of form units.

vertical

If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.

Returns: SalNumber.

GetCellType(type)

Parameter
Type
Description

Returns: SalBoolean.

GetCellType()

Indicates whether a column is a check box, drop down list, popup edit, or standard column.

Returns: SalNumber.

GetClassName()

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

Returns: SalString.

GetColumnFlags(flags)

Tests the state of a table window column's flags.

Parameter
Type
Description

Returns: SalBoolean.

GetColumnID()

Gets a table window column's identifier.

Returns: SalNumber.

GetColumnPosition()

Gets a table window column's relative position.

Returns: SalNumber.

GetColumnText(columnID, text)

Parameter
Type
Description

Returns: SalBoolean.

GetColumnText(columnID)

Gets data from a column of a table window's context row.

Parameter
Type
Description

columnID

Returns: SalString.

GetColumnTitle(text, maxLen)

Parameter
Type
Description

Returns: SalNumber.

GetColumnTitle(maxLen)

Gets the title of a table window column.

Parameter
Type
Description

maxLen

Returns: SalString.

GetColumnWidth(formUnits)

Parameter
Type
Description

formUnits

Returns: SalBoolean.

GetColumnWidth()

Returns the width (in form units) of a table window column.

Returns: SalNumber.

GetColumnWindow(col, flags)

Gets the handle of a table window column.

Parameter
Type
Description

Returns: SalWindowHandle.

GetContextRow()

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.

Returns: SalNumber.

GetControlType()

Returns an object's type.

Returns: SalNumber.

GetDataLength()

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

Returns: SalNumber.

GetDataType()

Returns a data field's or table window column's data type.

Returns: SalNumber.

GetDefaultButton()

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.

Returns: SalWindowHandle.

GetFirstChild(typeMask)

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.

Parameter
Type
Description

typeMask

One or more window types combined (using the OR (|) operator) to create a mask of child window types.

Returns: SalWindowHandle.

GetFont(name, size, enhancement)

Parameter
Type
Description

Returns: SalBoolean.

GetFormat(sPicture)

Parameter
Type
Description

sPicture

Returns: SalBoolean.

GetFormat()

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

Returns: SalString.

GetFormatCode()

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

Returns: SalNumber.

GetFormattedText(sText, bFormat)

Parameter
Type
Description

Returns: SalBoolean.

GetFormattedText(bFormat)

Copies the contents of a data field or table window column to a string. This function also lets you copy the format of the data.

Parameter
Type
Description

bFormat

Returns: SalString.

GetImageBytes(buffer, type)

Parameter
Type
Description

Returns: SalNumber.

GetImageBytes(buffer, type)

Parameter
Type
Description

Returns: SalNumber.

GetImageDescription(desc, maxLen)

Parameter
Type
Description

Returns: SalNumber.

GetImageDescription(maxLen)

Retrieves a description of a picture's contents.

Parameter
Type
Description

maxLen

Returns: SalString.

GetImageString(format, pict)

Parameter
Type
Description

Returns: SalNumber.

GetImageString(format)

Return the contents of a picture into a string.

Parameter
Type
Description

format

Returns: SalString.

GetImageString(format, buffer)

Parameter
Type
Description

Returns: SalNumber.

GetInputMask(sMask)

Parameter
Type
Description

Returns: SalBoolean.

GetInputMask()

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

Returns: SalString.

GetLabel()

Retrieves the window handle of the label (label control) that is associated with the hWndTarget parameter. There must be a mnemonic in that label, and it must immediately precede hWndTarget in the outline, or this function will fail.

Returns: SalWindowHandle.

GetLabelText(sText, nMaxLength)

Parameter
Type
Description

nMaxLength

Returns: SalNumber.

GetLabelText(nMaxLength)

Retrieves the text of the label associated to a control. Important: The label control does not require a mnemonic for the functions listed above to operate.

Parameter
Type
Description

nMaxLength

Returns: SalString.

GetLinesPerRow(lines)

Parameter
Type
Description

Returns: SalBoolean.

GetLinesPerRow()

Retrieves the height of a row in lines.

Returns: SalNumber.

GetListItemsCount()

Returns the number of list box or combo box entries.

Returns: SalNumber.

GetListItemState(nIndex)

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

Parameter
Type
Description

nIndex

Returns: SalBoolean.

GetListItemText(nIndex, sText)

Parameter
Type
Description

Returns: SalNumber.

GetListItemText(nIndex)

Returns the text of the specified item.

Parameter
Type
Description

nIndex

Returns: SalString.

GetListItemTextLength(nIndex)

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

Parameter
Type
Description

nIndex

Returns: SalNumber.

GetListSelectedFile(sFileName)

Parameter
Type
Description

sFileName

Returns: SalBoolean.

GetListSelectedFile()

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

Returns: SalString. Name of the selected file in t he control.

GetListSelectedIndex()

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

Returns: SalNumber.

GetListSelectedItems(nSelectedArray)

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

Parameter
Type
Description

nSelectedArray

Returns: SalBoolean.

GetListSelectedItemsCount()

Returns the number of selected entries in a multiple-selection list box. Specify single- or multiple-selection in the list box's customizer.

Returns: SalNumber.

GetLocation(x, y)

Parameter
Type
Description

Returns: SalBoolean.

GetLockedColumns()

Retrieves the number of locked table window columns.

Returns: SalNumber.

GetName(text)

Parameter
Type
Description

Returns: SalBoolean.

GetName()

Gets the name of an object.

Returns: SalString.

GetNextChild(typeMask)

Returns the handle of the next child window that matches a specified type.

Parameter
Type
Description

typeMask

One or more window types combined (using the OR (|) operator) to create a mask of child window types.

Returns: SalWindowHandle.

GetObjectData(info, context)

get object data

Parameter
Type
Description

GetParent()

Returns the handle of an object's parent window.

Returns: SalWindowHandle.

GetProperty(name, value)

Parameter
Type
Description

Returns: SalBoolean.

GetProperty(name)

Gets the value of a named property.

Parameter
Type
Description

Returns: SalString.

GetRowFlags(row, flags)

Queries a row's flags.

Parameter
Type
Description

Returns: SalBoolean.

GetScrollBarPosition(pos)

Parameter
Type
Description

Returns: SalBoolean.

GetScrollBarPosition()

Returns the current scroll bar value.

Returns: SalNumber.

GetScrollBarRange(min, max, line, page)

Parameter
Type
Description

Returns: SalBoolean.

GetSize(width, height)

Parameter
Type
Description

Returns: SalBoolean.

GetStatusBarText(sText, nMaxLen)

Parameter
Type
Description

Returns: SalNumber.

GetStatusBarText(nMaxLen)

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

Parameter
Type
Description

nMaxLen

Returns: SalString.

GetTableFlags(flags)

Tests the state of a table window's flags.

Parameter
Type
Description

Returns: SalBoolean.

GetText(text, maxLen)

Parameter
Type
Description

Returns: SalNumber.

GetText(maxLen)

Retrieves the text of a window.

Parameter
Type
Description

maxLen

Returns: SalString.

GetTextUnmasked(sText)

Parameter
Type
Description

Returns: SalBoolean.

GetTextUnmasked()

Unmasks the text from a masked edit control.

Returns: SalString.

GetWindowColor(colorIndex)

Gets a window's color.

Parameter
Type
Description

colorIndex

Returns: SalNumber.

GetWindowState()

Returns a window's current state.

Returns: SalNumber.

HideWindow()

Hides a window.

Returns: SalBoolean.

HideWindowAndLabel()

Hides a window and its associated label.

Returns: SalBoolean.

HitTest(x, y, row, col, flags)

Parameter
Type
Description

Returns: SalBoolean.

InsertListItem(nIndex, sAdd)

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

Parameter
Type
Description

Returns: SalNumber.

InsertRow(row)

Inserts a new blank row into a table window.

Parameter
Type
Description

Returns: SalNumber.

InvalidateWindow()

Causes a window to be repainted.

Returns: SalBoolean.

IsChecked()

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

Returns: SalBoolean.

IsDerivedFromClass(typeClass)

Determines whether a window is an instance of the specified class.

Parameter
Type
Description

typeClass

Returns: SalBoolean.

IsEmpty()

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

Returns: SalBoolean.

IsEnabled()

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

Returns: SalBoolean.

IsModified()

Returns the setting of the Field Edit Flag for a data field, multi line field, combo box, table window's context row cell, or picture.

Returns: SalBoolean.

IsValid()

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

Returns: SalBoolean.

IsValidDateTime()

Verifies whether a data field, multi line text field, or table window column contains a valid date/time value. For multi line text fields, the date/time value must be the only item in the field.

Returns: SalBoolean.

IsValidDecimal(nPrecision, nScale)

Verifies whether a data field, multi line text field, or table window column contains a valid decimal value. For multi line text fields, the decimal value must be the only item in the field.

Parameter
Type
Description

nPrecision

nScale

Returns: SalBoolean.

IsValidInteger()

Verifies whether a data field, multi line text field, or table window column contains a valid integer value. For multi line text fields, the integer value must be the only item in the field.

Returns: SalBoolean.

IsValidNumber()

Verifies whether a data field, multi line text field, or table window column contains a valid numeric value. Valid numbers are integers or floating point numbers, negative and positive. For multi line text fields, the numeric value must be the only item in the field.

Returns: SalBoolean.

IsVisible()

Determines whether a window is currently visible.

Returns: SalBoolean.

KillCellEdit()

Takes a row out of edit mode and selects the row. This causes the row to receive both SAM_Validate and SAM_KillFocus messages.

Returns: SalBoolean.

KillFocusRow()

Turns off the table window's focus frame.

Returns: SalBoolean.

KillTimer(idEvent)

Destroys an object's system timer.

Parameter
Type
Description

idEvent

Returns: SalBoolean.

MDIArrangeIcons()

Arranges minimized child window icons in an MDI window.

Returns: SalBoolean.

MDICascade()

Cascades all non-iconized child windows of an MDI window.

Returns: SalBoolean.

MDITile(bPosition)

Tiles all non-iconized child windows of an MDI window. Windows that are not sizable will not be tiled.

Parameter
Type
Description

bPosition

Returns: SalBoolean.

MoveWindow(xOffset, yOffset)

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

Parameter
Type
Description

xOffset

yOffset

Returns: SalBoolean.

Adds a new group to the specified pane of a navigation bar.

Parameter
Type
Description

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

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)

expandedImage

File name of the image to display for the new pane when it is expanded.

collapsedImage

File name of the image to display for the new pane when it is collapsed.

Returns: SalBoolean.

Associates a control to a pane.

Parameter
Type
Description

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

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

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

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.

Returns: SalNumber. The zero-based index of the currently selected pane.

Parameter
Type
Description

paneIndex

format

expanded

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

name

The name of the pane (object title)

Returns: SalNumber. the zero-based index of the pane. If the pane is not found, nIndex is -1.

Parameter
Type
Description

paneIndex

Returns: SalBoolean.

Returns the title of a pane.

Parameter
Type
Description

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

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.

Parameter
Type
Description

Returns: SalBoolean.

Returns true if the pane is enabled (visible in the pane navigator); false if disabled (not visible).

Parameter
Type
Description

paneIndex

Index of pane (start at 0).

Returns: SalBoolean.

Removes a group from the navigation bar control.

Parameter
Type
Description

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

paneIndex

Zero-based index of the pane to be removed.

Returns: SalBoolean.

Parameter
Type
Description

Returns: SalBoolean.

Activates the indicated pane.

Parameter
Type
Description

paneIndex

The zero-based index of the pane to activate.

Returns: SalBoolean.

Sets the title of a pane.

Parameter
Type
Description

paneIndex

Index for the pane.

binary

Buffer that stores the image (bmp or icon).

format

Indicates the image format. Use PIC_FormatIcon or PIC_FormatBitmap.

expanded

TRUE for "expanded" image, FALSE for "collapsed" image

Returns: SalBoolean.

Sets the title of a pane.

Parameter
Type
Description

paneIndex

Index for the pane whose title you want to get (start at 0).

title

The new title for the pane.

Returns: SalBoolean.

PasteRows()

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.

Returns: SalBoolean.

PixelsToFormUnits(numPixels, vertical)

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

numPixels

vertical

If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE.

Returns: SalNumber.

Populate(hSql, select, method)

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

Returns: SalBoolean.

Populate(hSql, select, method, errorHandler)

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

Returns: SalBoolean.

Populate(hSql, select)

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

Returns: SalBoolean.

Populate(hSql, select, errorHandler)

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

Returns: SalBoolean.

PopulateList(hSql, sSelect)

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. However, due to a Microsoft Windows limitation, each column's data displayed in a combo box is separated by a single '|' character. There is no space between one column's data, the separator character, and another column's data.

Parameter
Type
Description

Returns: SalBoolean.

PopulateList(hSql, sSelect, errorHandler)

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. However, due to a Microsoft Windows limitation, each column's data displayed in a combo box is separated by a single '|' character. There is no space between one column's data, the separator character, and another column's data.

Parameter
Type
Description

Returns: SalBoolean.

PopulateListFiles(ctrlPath, sPathName, nAttributes)

Parameter
Type
Description

ctrlPath

sPathName

nAttributes

Returns: SalBoolean.

PostMessage(msg, mywParam, mylParam)

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

Parameter
Type
Description

mywParam

mylParam

Returns: SalBoolean.

QueryCheckBoxColumn(flags, checkedValue, uncheckedValue)

Parameter
Type
Description

checkedValue

uncheckedValue

Returns: SalBoolean.

QueryDropDownListColumn(flags, lines)

Parameter
Type
Description

Returns: SalBoolean.

QueryFocusCell(nRow, hWndCol)

Parameter
Type
Description

Returns: SalBoolean.

QueryPopupEditColumn(flags, lines)

Parameter
Type
Description

Returns: SalBoolean.

QueryRowHeader(title, maxTitle, width, flags, col)

Parameter
Type
Description

Returns: SalBoolean.

QueryScroll(position, minRange, maxRange)

Parameter
Type
Description

position

minRange

maxRange

Returns: SalBoolean.

QuerySplitWindow(nRowsLowerHalf, bDragAdjust)

Parameter
Type
Description

nRowsLowerHalf

bDragAdjust

Returns: SalBoolean.

QueryVisibleRange(minRange, maxRange)

Parameter
Type
Description

minRange

maxRange

Returns: SalBoolean.

ResetTable()

Clears a table window by discarding all rows from the table window cache and setting the table range to 0, -1.

Returns: SalBoolean.

ScrollRow(row, column, flags)

Scrolls a table window to the specified row and column.

Parameter
Type
Description

Returns: SalBoolean.

ScrollRow(row, column)

Scrolls a table window to the specified row and column.

Parameter
Type
Description

Returns: SalBoolean.

SendMessage(msg, mywParam, mylParam)

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

Parameter
Type
Description

mywParam

mylParam

Returns: SalNumber.

SendMessageToChildren(msg, mywParam, mylParam)

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

Parameter
Type
Description

mywParam

mylParam

Returns: SalBoolean.

SetCellTextColor(color, discardable)

Changes a table window cell's text color.

Parameter
Type
Description

discardable

Returns: SalBoolean.

SetCellTextColor(color)

Changes a table window cell's text color.

Parameter
Type
Description

Returns: SalBoolean.

SetColumnFlags(flags, set)

Sets or clears a table window column's flags.

Parameter
Type
Description

Returns: SalBoolean.

SetColumnPos(pos)

Moves a table window column to a new position.

Parameter
Type
Description

Returns: SalBoolean.

SetColumnPosition(pos)

Moves a table window column to a new position.

Parameter
Type
Description

Returns: SalBoolean.

SetColumnText(columnID, text)

Assigns data to a column of a table window's context row.

Parameter
Type
Description

columnID

Returns: SalBoolean.

SetColumnTitle(title)

Sets the title of a table window column.

Parameter
Type
Description

Returns: SalBoolean.

SetColumnWidth(formUnits)

Sets a table window column's display width.

Parameter
Type
Description

formUnits

The number of form units.

Returns: SalBoolean.

SetContextMenu(sMenuName, nFlags)

Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.

Parameter
Type
Description

sMenuName

nFlags

Returns: SalBoolean.

SetContextMenu(menuType, flags)

Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.

Parameter
Type
Description

menuType

Returns: SalBoolean.

SetContextRow(row)

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.

Parameter
Type
Description

Returns: SalBoolean.

SetCursor(resource, type)

Sets a window's cursor.

Parameter
Type
Description

Returns: SalBoolean.

SetCursor(resourceId, type)

Sets a window's cursor.

Parameter
Type
Description

resourceId

Returns: SalBoolean.

SetCursor(blob, type)

Sets a window's cursor from a string variable.

Parameter
Type
Description

Returns: SalBoolean.

SetCursorFile(file, type)

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

Parameter
Type
Description

Returns: SalBoolean.

SetDataLength(length)

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

Parameter
Type
Description

length

Returns: SalBoolean.

SetDefaultButton()

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

Returns: SalBoolean.

SetFlagsAnyRows(flags, set, flagsOn, flagsOff)

Sets or clears row flags.

Parameter
Type
Description

Returns: SalBoolean.

SetFocus()

Sets the focus to a specified window.

Returns: SalWindowHandle.

SetFocusCell(row, column, editMin, editMax)

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.

Parameter
Type
Description

column

editMin

editMax

Returns: SalBoolean.

SetFocusRow(row)

Sets a table window's focus frame row.

Parameter
Type
Description

Returns: SalBoolean.

SetFont(name, size, enhancement)

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

Parameter
Type
Description

enhancement

Returns: SalBoolean.

SetFormat(sPicture)

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

Parameter
Type
Description

sPicture

Returns: SalBoolean.

SetFormatCode(nFormat)

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

Parameter
Type
Description

nFormat

Returns: SalBoolean.

SetImageBytes(imageBytes, type)

Inserts the contents of a picture to an image without the image header.

Parameter
Type
Description

imageBytes

Returns: SalBoolean.

SetImageFile(fileName)

Inserts a file's contents into a picture.

Parameter
Type
Description

fileName

Returns: SalBoolean.

SetImageFit(fit, scaleWidth, scaleHeight)

Sets the fit for a picture.

Parameter
Type
Description

scaleWidth

scaleHeight

Returns: SalBoolean.

SetImageHandle(type, handle)

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

Returns: SalBoolean.

SetImageResource(resource, format)

Inserts a resource into a picture.

Parameter
Type
Description

resource

format

Returns: SalBoolean.

SetImageString(format, picture)

Inserts the contents of a string into a picture.

Parameter
Type
Description

format

picture

Returns: SalBoolean.

SetImageString(format, buffer)

Inserts the contents of a binary buffer into a picture.

Parameter
Type
Description

format

buffer

Returns: SalBoolean.

SetInputMask(sMask)

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

Parameter
Type
Description

Returns: SalBoolean.

SetLabelText(sText)

Sets the text of the associated label control.

Parameter
Type
Description

Returns: SalBoolean.

SetLinesPerRow(lines)

Sets the height of a row in lines.

Parameter
Type
Description

Returns: SalBoolean.

SetListRedraw(bRedraw)

Redraws entries in a list box or combo box, or prevents them from being redrawn.

Parameter
Type
Description

bRedraw

Returns: SalBoolean.

SetListSelectedIndex(nIndex)

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

Parameter
Type
Description

nIndex

Returns: SalBoolean.

SetListSelectedItems(nIndex, bSelect)

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

Parameter
Type
Description

nIndex

bSelect

Returns: SalBoolean.

SetListSelectedText(nIndexStart, sText)

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

Parameter
Type
Description

nIndexStart

Returns: SalNumber.

SetListTabStops(nTabStops)

Sets tabs in a list box.

Parameter
Type
Description

Returns: SalBoolean.

SetLocation(x, y)

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

Parameter
Type
Description

Returns: SalBoolean.

SetLockedColumns(lockedColumns)

Sets the number of locked table window columns.

Parameter
Type
Description

lockedColumns

Returns: SalBoolean.

SetModified(bSet)

Sets or clears the field edit flag for an editable data field, combo box, multi line text field, table window column, or picture.

Parameter
Type
Description

Returns: SalBoolean.

SetProperty(name, value, length)

Sets the value of a named property.

Parameter
Type
Description

Returns: SalBoolean.

SetRange(min, max)

Defines the minimum and maximum rows (range) of a table.

Parameter
Type
Description

Returns: SalBoolean.

SetRow(rowPos)

Sets the focus to the first, last, next, or previous row in a table window.

Parameter
Type
Description

rowPos

Returns: SalNumber.

SetRowFlags(row, flags, set)

Sets or clears a table window row's flags.

Parameter
Type
Description

Returns: SalBoolean.

SetScrollBarPosition(pos)

Sets the scrollbar's value.

Parameter
Type
Description

Returns: SalBoolean.

SetScrollBarRange(min, max, line, page)

Sets a scroll bar's range, line increment, and page increment. When the scroll bar is created, assigns it these values: Minimum scroll position0 Maximum scroll position100 Line Increment1 Page Increment10 If the scroll bar's current position is outside the new range, its position changes to one within the new range. The range of a scroll bar is -32,767 to 32,767.

Parameter
Type
Description

Returns: SalBoolean.

SetSize(width, height)

Resizes a window.

Parameter
Type
Description

Returns: SalBoolean.

SetStatusBarText(sText)

Displays specified text in the status bar of a top-level or MDI window.

Parameter
Type
Description

Returns: SalBoolean.

SetTableFlags(flags, set)

Sets or clears a table window's flags.

Parameter
Type
Description

Returns: SalBoolean.

SetText(text)

Sets the text of a window.

Parameter
Type
Description

Returns: SalBoolean.

SetText(sValue, bFormat)

Copies a string to a data field or table window column. After copying the string to the field, formats the string.

Parameter
Type
Description

sValue

bFormat

Returns: SalBoolean.

SetTimer(idEvent, elapseMilliSec)

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

idEvent

elapseMilliSec

Returns: SalBoolean.

SetWindowColor(colorIndex, color)

Sets a window's color.

Parameter
Type
Description

colorIndex

Returns: SalBoolean.

ShowStatusBar(bShow)

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

Parameter
Type
Description

Returns: SalBoolean.

ShowToolBar(bShow)

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

Parameter
Type
Description

Returns: SalBoolean.

ShowWindow()

Makes a window visible.

Returns: SalBoolean.

ShowWindowAndLabel()

Makes a window and its associated label visible. A label is the label control that immediately precedes the window in the outline.

Returns: SalBoolean.

SortRows(columnID, order)

Sorts the rows of a table window based on the values in one of the table window's columns.

Parameter
Type
Description

columnID

Returns: SalBoolean.

ToControl()

Returns the Control associated with this handle.

Returns: Control.

ToInt32()

Converts a window handle to a number.

Returns: Int32. nWnd

ToIntPtr()

Returns the IntPtr value.

Returns: IntPtr.

ToNumber()

Returns the value converted to SalNumber.

Returns: SalNumber.

TrackPopupMenu(menuName, flags, x, y)

Creates pop-up menus at runtime.

Parameter
Type
Description

Returns: SalBoolean.

TrackPopupMenu(menuType, flags, x, y)

Creates pop-up menus at runtime.

Parameter
Type
Description

Returns: SalBoolean.

UpdateWindow()

Forces the update of a window.

Returns: SalBoolean.

Validate()

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

Returns: SalBoolean.

Validate(validate)

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

Parameter
Type
Description

validate

Returns: SalBoolean.

WinHelp(file, command, numData, strData)

Starts the Windows help system.

Parameter
Type
Description

command

numData

strData

Returns: SalBoolean.

Yield()

Processes messages for this control.

Used By

Name
Description

Not supported.

Gets the handle of a table window column.

Converts a number to a window handle.

Gets the handle of a table window column.

Sets the context to the specified form.

This function finds a child window of a given name in the specified window.

Retrieves the window handle of the label (label control) that is associated with the hWndTarget parameter. There must be a mnemonic in that label, and it must immediately precede hWndTarget in the outline, or this function will fail.

This function finds a child window of a given name in the specified window.

This function finds a child window of a given name in the specified window.

Returns the handle of an object's parent window.

Retrieves the window handle of the label (label control) that is associated with the hWndTarget parameter. There must be a mnemonic in that label, and it must immediately precede hWndTarget in the outline, or this function will fail.

This function finds a child window of a given name in the specified window.

This function finds a child window of a given name in the specified window.

This function finds a child window of a given name in the specified window.

This function finds a child window of a given name in the specified window.

Sets the focus to a specified window.

This function finds a child window of a given name in the specified window.

This function finds a child window of a given name in the specified window.

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.

Returns the target window handle.

This function finds a child window of a given name in the specified window.

This function finds a child window of a given name in the specified window.

Returns the handle of an object's parent window.

Retrieves the window handle of the label (label control) that is associated with the hWndTarget parameter. There must be a mnemonic in that label, and it must immediately precede hWndTarget in the outline, or this function will fail.

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.

This function finds a child window of a given name in the specified window.

Sets the focus to a specified window.

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.

Gets the handle of a table window column.

Returns the handle of the control with the focus.

Sets the focus to a specified window.

Sets the focus to a specified window.

Returns the control associated with the handle.

Use this function instead of SalShowWindow because it works properly with the class function HideWindow

Use this function instead of SalShowWindowAndLabel because it works properly with the class function HideWindowAndLabel.

Use this function instead of SalHideWindow. This function will keep the window hidden as tabs are selected. Use the class function ShowWindow to undo the affect of this function.

Returns if the specified control is considered to be visible by the tab control and will be shown when the associated tab is selected.

Use this function instead of SalHideWindowAndLabel. This function will keep the window hidden as tabs are selected. Use the class function ShowWindowWindowAndLabel to undo the affect of this function.

Finds the tab frame window on a form or dialog box

Returns the control associated with the handle.

Returns the control associated with the handle.

Indicates that a tab has been created. This function is called when the tab control receives SAM_Create.

Indicates that a tab has been activated. This function is called before the child windows have been shown

Indicates that a tab has been activated. This function is called after the child windows have been shown

Indicates that user is attempting to change the current tab by clicking, tabbing or some other user action. NOTE: Call CancelMode() to deny the user's request

Indicates that the size of the tab frame may have changed

Define the page size for child forms created on the tab frame. This function can be overriden in the tab form or tab dialog box

Returns the control associated with the handle.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Multiple Inheritance: Wrapper function.

Last updated