SalWindowHandle
PPJ.Runtime.SalWindowHandle
Last updated
PPJ.Runtime.SalWindowHandle
Last updated
Namespace: PPJ.Runtime
Assembly: PPJ.Web.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.
Creates a new SalWindowHandle.
handle
Creates a new SalWindowHandle.
ctrl
: Returns the referenced control instance.
Adds a string to a list box or combo box.
sName
Determines whether any rows in the specified table window match certain flags.
nFlagsOn
nFlagsOff
Brings a window to the top of all overlapping windows.
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.
Clears the value from a data field, multiline field, or table window column.
Clears a window's cursor.
nType
Deletes the contents of a picture.
Deletes all entries from a list box or combo box.
Deselects all rows of a table window.
Computes the average of all column values or only specified column values in a table window.
nColumnID
nFlagsOn
nFlagsOff
Computes the sum of all column values or only specified column values in a table window.
nColumnID
nFlagsOn
nFlagsOff
compare to an object
obj
compare to a SalWindowHandle
handle
Copies the contents of the specified table window rows to the Clipboard in text format.
nFlagsOn
nFlagsOff
Creates a table window column of string data type at runtime.
nColumnPos
nDispWidth
nMaxChars
sTitle
Creates a table window column using a given data type at runtime. Allowed types are DT_String, DT_Number and DT_DateTime
nColumnPos
nDispWidth
sTitle
nMaxChars
nDatatype
Define a column as a check box.
nFlags
sCheckedValue
sUncheckedValue
Define a column as a drop down list.
nFlags
nLines
Define a column as a popup edit window.
nFlags
nLines
Defines the appearance and behavior of a table window's row header.
sTitle
nWidth
nFlags
column
Splits a table window horizontally.
nRowsLowerHalf
bDragAdjust
Deletes a list box or combo box entry.
nIndex
Deletes a row from a table window but not from the database.
nRow
nFlag
Applies a SQL DELETE statement to all table window rows with the ROW Selected flag.
hSql
Applies a SQL DELETE statement to all table window rows with the ROW Selected flag.
hSql
errorHandler
Destroys all automatic columns created by SalTblCreateColumn or SalTblPopulate at runtime. This function only works on table windows that contain only automatic columns.
Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.
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.
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.
Applies a SQL DELETE statement to all table window rows that have nFlagsOn flags.
hSql
nFlagsOn
Applies a SQL DELETE statement to all table window rows that have nFlagsOn flags.
hSql
nFlagsOn
errorHandler
Applies a SQL INSERT statement to all the rows in a table window that have the ROW New flag.
hSql
bClearFlags
Applies a SQL INSERT statement to all the rows in a table window that have the ROW New flag.
hSql
bClearFlags
errorHandler
Applies a SQL UPDATE statement to all table window rows with the Row Edited flag.
hSql
bClearFlags
Applies a SQL UPDATE statement to all table window rows with the Row Edited flag.
hSql
bClearFlags
errorHandler
Redraws the menu bar for a given form window or top-level table window.
Enables keyboard and mouse input to a window.
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.
Destroys a modal dialog box and returns control to the caller of SalModalDialog.
nReturn
Sends a SAM_FetchRow message to a table window if the row you specify is not currently in the table window cache.
nRow
This function finds a child window of a given name in the specified window.
sWindowName
Finds a member control in the specified control. Used as a helper functions to resolve unqualified references.
name
Find a member in the specified control. Used as a helper functions to resolve unqualified references.
name
nRow
nFlagsOn
nFlagsOff
nRow
nFlagsOn
nFlagsOff
Dispatches the specified message (Window Actions) directly to the control's WindowActions event handlers, without going through Windows message loop.
nMsg
nMywParam
nMylParam
Dispatches the specified message (Window Actions) directly to the children's WindowActions event handlers, without going through Windows message loop.
nMsg
nMywParam
nMylParam
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.
nFormUnits
bVertical
nType
Indicates whether a column is a checkbox, drop down list, popup edit, or standard column.
Return the name of a window's class as a string.
Tests the state of a table window column's flags.
nFlags
Gets a table window column's identifier.
Gets a table window column's relative position.
nColumnID
sText
Gets data from a column of a table window's context row.
nColumnID
sText
nMaxLen
Gets the title of a table window column.
nMaxLen
nFormUnits
Returns the width (in form units) of a table window column.
Gets the handle of a table window column.
nCol
nFlags
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 an object's type.
Returns the maximum length of a data field, multiline text field, or table window column.
Returns a data field's or table window column's data type.
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 handle of the first child window of the specified type. You can use this function to get the handles of MDI child windows.
nTypeMask
sName
nSize
nEnhancement
sPicture
Gets the picture format of a data field or table window column.
Returns the current format of a data field or table window column.
sText
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.
bFormat
sImageBytes
nType
sDesc
nMaxLen
Retrieves a description of a picture's contents.
nMaxLen
nFormat
sPict
Return the contents of a picture into a string.
nFormat
sMask
Gets the input mask of a data field or table window column.
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.
sText
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.
nMaxLength
nLines
Retrieves the height of a row in lines.
Returns the number of list box or combo box entries.
Determines whether the specified list box or combo box entry is selected.
nIndex
nIndex
sText
Returns the text of the specified item.
nIndex
Returns the length of a list box or combo box entry.
nIndex
sFileName
Fetches the selected directory or file name from a list box or combo box.
Returns the index of the selected entry in a combo box or single-selection list box.
Returns an array of index numbers of selected list box entries.
nSelectedArray
Returns the number of selected entries in a multiple-selection list box. Specify single- or multiple-selection in the list box's customizer.
nX
nY
Retrieves the number of locked table window columns.
sText
Gets the name of an object.
Returns the handle of the next child window that matches a specified type.
nTypeMask
get object data
info
context
Returns the handle of an object's parent window.
sName
sValue
Gets the value of a named property.
sName
Queries a row's flags.
nRow
nFlags
nPos
Returns the current scroll bar value.
nMin
nMax
nLine
nPage
nWidth
nHeight
sText
nMaxLen
Gets the text displayed in the status bar of a top-level or MDI window.
nMaxLen
Tests the state of a table window's flags.
nFlags
sText
nMaxLen
Retrieves the text of a window.
nMaxLen
sText
Unmasks the text from a masked edit control.
Gets a window's color.
nColorIndex
Returns a window's current state.
Hides a window.
Hides a window and its associated label.
nX
nY
nRow
hWndCol
nFlags
Inserts an entry into a list box or combo box at a specified position.
nIndex
sAdd
Inserts a new blank row into a table window.
nRow
Causes a window to be repainted.
Determines whether a radio button is set or a check box is checked.
Determines whether a window is an instance of the specified class.
tClass
Verifies whether a data field, multiline text field, or table window column is null or empty.
Determines whether a window is enabled for mouse and keyboard input.
Returns the setting of the Field Edit Flag for a data field, multiline field, combo box, table window's context row cell, or picture.
Validates the contents of a data field or table window column using the current profile.
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.
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.
nPrecision
nScale
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.
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.
Determines whether a window is currently visible.
Takes a row out of edit mode and selects the row. This causes the row to receive both SAM_Validate and SAM_KillFocus messages.
Turns off the table window's focus frame.
Destroys an object's system timer.
nIDEvent
Moves a window a given number of form units on the X and Y axes relative to its current position.
nXOffset
nYOffset
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.
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.
nNumPixels
bVertical
Compiles, binds, and executes a SQL SELECT statement, then fetches the rows of the result set and populates a table window with them.
hSql
sSelect
nMethod
Compiles, binds, and executes a SQL SELECT statement, then fetches the rows of the result set and populates a table window with them.
hSql
sSelect
nMethod
errorHandler
Compiles, binds, and executes a SQL SELECT statement, then fetches the rows of the result set and populates a table window with them.
hSql
sSelect
Compiles, binds, and executes a SQL SELECT statement, then fetches the rows of the result set and populates a table window with them.
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.
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.
hSql
sSelect
errorHandler
ctrlPath
sPathName
nAttributes
Posts the specified message to a window by adding nMsg to hWndReceiver's message queue.
nMsg
nMywParam
nMylParam
nFlags
sCheckedValue
sUncheckedValue
nFlags
nLines
nRow
hWndCol
nFlags
nLines
sTitle
nMaxTitle
nWidth
nFlags
hWndCol
nPosition
nMinRange
nMaxRange
nRowsLowerHalf
bDragAdjust
nMinRange
nMaxRange
Clears a table window by discarding all rows from the table window cache and setting the table range to 0, -1.
Scrolls a table window to the specified row and column.
nRow
column
nFlags
Scrolls a table window to the specified row and column.
nRow
column
Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.
nMsg
nMywParam
nMylParam
Sends a message to all child items of a form window, dialog box, table window, or MDI window.
nMsg
nMywParam
nMylParam
Changes a table window cell's text color.
nColor
bDiscardable
Changes a table window cell's text color.
nColor
Sets or clears a table window column's flags.
nFlags
bSet
Moves a table window column to a new position.
nPos
Moves a table window column to a new position.
nPos
Assigns data to a column of a table window's context row.
nColumnID
sText
Sets the title of a table window column.
sTitle
Sets a table window column's display width.
nFormUnits
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
menuName
flags
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
menuType
flags
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.
nRow
Sets a window's cursor.
nResourceId
nType
Sets a window's cursor from a string variable.
sBlob
nType
Sets an application-defined cursor for the specified window. Use this function to set the cursor from an image stored in a file.
sFile
nType
Sets a limit on the number of characters that a user can enter into a data field, multiline text field, or table window column.
length
Sets the default push button of a form window or dialog box.
Sets or clears row flags.
nFlags
bSet
nFlagsOn
nFlagsOff
Sets the focus to a specified window.
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.
nRow
column
Sets a table window's focus frame row.
nRow
Sets a window's font, font size, and font enhancements.
sName
nSize
nEnhancement
Sets the picture format of a data field or table window column.
sPicture
Sets a data field's or table window column's format.
nFormat
Inserts the contents of a picture to an image without the image header.
sImageBytes
nType
Inserts a file's contents into a picture.
sFileName
nFit
nScaleWidth
Not supported.
nScaleHeight
Not supported.
Sets the fit for a picture.
nFit
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.
nType
nHandle
HICON or HBITMAp handle of the image.
Inserts a resource into a picture.
tResource
nFormat
Inserts the contents of a string into a picture.
nFormat
sPicture
Sets the input mask of a data field or table window column.
sMask
Sets the text of the associated label control.
sText
Sets the height of a row in lines.
nLines
Selects or deselects a combo box or single-selection list box entry.
nIndex
Selects or deselects a combo box or multiple-selection list box entry.
nIndex
bSelect
Finds and selects a combo box or single-selection list box entry.
nIndexStart
sText
Moves a window to a new position (x, y) on the X and Y axes.
nX
nY
Sets the number of locked table window columns.
nLockedColumns
Sets or clears the field edit flag for an editable data field, combo box, multiline text field, table window column, or picture.
bSet
Sets the value of a named property.
sName
sValue
nLength
Defines the minimum and maximum rows (range) of a table.
nMin
nMax
Sets the focus to the first, last, next, or previous row in a table window.
nRowPos
Sets or clears a table window row's flags.
nRow
nFlags
bSet
Sets the scrollbar's value.
nPos
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.
nMin
nMax
nLine
nPage
Resizes a window.
nWidth
nHeight
Displays specified text in the status bar of a top-level or MDI window.
sText
Sets or clears a table window's flags.
nFlags
bSet
Sets the text of a window.
sText
Copies a string to a data field or table window column. After copying the string to the field, formats the string.
sValue
bFormat
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.
nIDEvent
nElapseMilliSec
Sets a window's color.
nColorIndex
nColor
Shows or hides the status bar on a top-level or MDI window.
bShow
Shows or hides the tool bar on a top-level or MDI window.
bShow
Makes a window visible.
Makes a window and its associated label visible. A label is the label control that immediately precedes the window in the outline.
Sorts the rows of a table window based on the values in one of the table window's columns.
nColumnID
nOrder
Returns the Control associated with this handle.
Converts a window handle to a number.
Returns the IntPtr value.
Returns the value converted to SalNumber.
Creates pop-up menus at runtime.
sMenuName
nFlags
nX
nY
callback
Creates pop-up menus at runtime.
menuType
nFlags
nX
nY
callback
Forces the update of a window.
Validates and formats a data field's or table window column's contents.
Validates and formats a data field's or table window column's contents.
nValidate
Not supported.
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.
This function finds a child window of a given name in the specified window.
Sets the focus to a 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.
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 next child window that matches a specified type.
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 next child window that matches a specified type.
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 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.
Sets the focus to a specified window.
This function finds a child window of a given name in the specified window.
Gets the handle of a table window column.
Returns the control with the focus.
Returns the handle of an object's parent window.
This function finds a child window of a given name in the specified window.
Returns the target window 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 overridden in the tab form or tab dialog box
Returns the control associated with the handle.
Sets the context to the specified form.
: Checks if this SalWindowHandle object contain a null value.
: Returns the Handle value.
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Deprecated: SetImageFit(nFit, nScaleWidth, nScaleHeight) is deprecated, use SetImageFit(nFit) Sets the fit for a picture.
One of , , .
Returns: .
One of , , .
Returns: .
One of or .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: . nWnd
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
Returns: .
