The SalWindow type exposes the following members.

Methods

  NameDescription
Public methodStatic memberAddListItem
Adds a string to the list control.
Public methodAddMessageActions(Delegate)
Adds the specified handler to the list of delegates registered to received the MessageActions event.
Public methodAddMessageActions(ISalWindow)
Adds the handlers from the target window to the list of delegates registered to received the MessageActions event.
Public methodStatic memberBringToTop
Brings a window to the top of all overlapping windows.
Public methodStatic memberCanCopy
Returns true of the selection in the control with the focus can be copied.
Public methodStatic memberCanCut
Returns true of the selection in the control with the focus can be cut.
Public methodStatic memberCanPaste
Returns true if there is the control with the focus can paste the text in the clipboard.
Public methodStatic memberCanUndo
Returns true if the control with the focus can undo the last edit operation.
Public methodStatic memberCenter
Centers a window relative to the parent, or the owner, or the screen.
Public methodStatic memberClear()()()()
Deletes the selection in the control with the focus.
Public methodStatic memberClear(Control)
Clears the value from a data field, multiline field, or table window column.
Public methodStatic memberClearCursor
Clears a window's cursor.
Public methodStatic memberClearList
Deletes all entries from the list control.
Public methodStatic memberCopy
Copies the selection from the control with the focus to the clipboard.
Public methodStatic memberCopyProfile
Clones the specified profile into the custom profile associated to the specified field.
Public methodStatic memberCopyString
Copies the text to the clipboard.
Public methodStatic memberCreateFont
Creates a Font object from the specified parameters.
Public methodStatic memberCreateWindow(String, Control, array<Object>[]()[][])
Public methodStatic memberCreateWindow(Type, Control, array<Object>[]()[][])
Creates modeless dialog boxes, MDI windows, form windows, and top-level table windows at runtime.
Public methodStatic memberCreateWindow(String, Control, Single, Single, Single, Single, Int32)
Creates a form window, dialog box, or table window as a child of another form window, dialog box, or toolbar at runtime.
Public methodStatic memberCreateWindow(Type, Control, Single, Single, Single, Single, Int32, array<Object>[]()[][])
Creates a form window, dialog box, or table window as a child of another form window, dialog box, or toolbar at runtime.
Public methodStatic memberCut
Deletes the selected from the control with the focus and places it in the clipboard.
Public methodStatic memberDeleteListItem
Deletes a list box or combo box entry.
Public methodStatic memberDestroy
Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.
Public methodStatic memberDisableWindow
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.
Public methodStatic memberDisableWindowAndLabel
Disables keyboard and mouse input to a window and grays out its associated label.
Public methodStatic memberDragAcceptFiles
Indicates whether a window can accept a file from Windows' File Manager.
Public methodDragDropStart()()()()
Initiates drag-drop mode.
Public methodDragDropStart(Point, Object)
Initiates drag-drop mode.
Public methodDragDropStop
Aborts drag mode.
Public methodStatic memberEnablePostMessageQueueing
Enables queued version of PostMessage. This must be done per thread having a message pump.

Remarks

The problem behind this funcationality is that the Enterprise Explorer keeps the UI thread running during server calls (in order to get good responsiveness for the user). However, that makes message that are posted with PostMessage to be executed too early (and commonly, message handlers for posted messages do database calls) The solution is to queue all posted messages and on the Application.Idle event dequeue and send the messages to the correct destinaion. When database calls are being made and Enterprise Explorer keeps the UI running, the dequeueing could temporarily be disabled.
Public methodStatic memberEnableWindow
Enables keyboard and mouse input to a window.
Public methodStatic memberEnableWindowAndLabel
Enables keyboard and mouse input to a window and enables its associated label as well. A label is the label control that immediately precedes the window in the tab order.
Public methodStatic memberEndDialog
Destroys a modal dialog box and returns control to the caller of SalModalDialog.
Public methodStatic memberFillDoubleGradient
Draws a double gradient background.
Public methodStatic memberFillGradient
Draws a gradient background.
Public methodStatic memberFindChild(Control, String)
Finds a child window of a given name in the specified window.
Public methodStatic memberFindChild(Control, Type)
Finds a child window of a given type in the specified window.
Public methodStatic memberFindControl
Finds a member control in the specified control. Used as a helper functions to resolve unqualified references.
Public methodStatic memberFindMember
Find a member in the specified control. Used as a helper functions to resolve unqualified references.
Public methodStatic memberFormUnitsToPixels
Computes the number of pixels in the number form units.
Public methodStatic memberFromHandle
Retrieves the control associated with the handle and casts it to the target type. If the target type is a second-base class in multiple inheritance tree, uses reflection to cast the control to the second-base instance.
Public methodStatic memberGetClassName
Return the name of a window's class as a string.
Public methodStatic memberGetClientArea
Returns the SalClientArea panel.
Public methodStatic memberGetControlName(Control)
Gets the name of a control.
Public methodStatic memberGetControlName(Control, SalString%)
Returns the name of the specified control.
Public methodStatic memberGetControlType
Returns the type of control (TYPE_*).
Public methodStatic memberGetDataLength
Returns the maximum length of a data field, multiline text field, or table window column.
Public methodStatic memberGetDataType
Returns a data field's or table window column's data type (DT_*).
Public methodStatic memberGetDefaultButton
Returns the default push button on a form window or dialog box.
Public methodStatic memberGetFirstChild
Returns the first child window of the specified type.
Public methodStatic memberGetFocus
Returns the handle of the contorl with the focus.
Public methodStatic memberGetFont(Font, String%, Single%, Int32%)
Gets a window's font name, size, and enhancements.
Public methodStatic memberGetFont(Control, SalString%, SalNumber%, SalNumber%)
Gets a window's font name, size, and enhancements.
Public methodStatic memberGetFontNames
Gets the names of the screen or printer fonts.
Public methodStatic memberGetFormat
Gets the format of a data field or table window column.
Public methodStatic memberGetFormatCode
Returns the current format of a data field or table window column.
Public methodStatic memberGetFormattedText
Returns the contents of a data field or table window column.
Public methodStatic memberGetInputMask
Gets the input mask of a data field or table window column.
Public methodStatic memberGetLabel
Finds the Label assigned the specified control. Labels are assigned at startup using the TabIndex preeceding the control.
Public methodStatic memberGetLabelText(Control)
Retrieves the label text of a control.
Public methodStatic memberGetLabelText(Control, Int32)
Returns the text of the label associated to the specified control.
Public methodStatic memberGetLabelText(Control, SalString%, Int32)
Returns the text of the label associated to the specified control.
Public methodStatic memberGetListItemsCount
Returns the number of list box or combo box entries.
Public methodStatic memberGetListItemState
Determines whether the specified list box or combo box entry is selected.
Public methodStatic memberGetListItemText(Control, Int32)
Returns an entry in the list box or combo box.
Public methodStatic memberGetListItemText(Control, Int32, SalString%)
Returns an entry in the list box or combo box.
Public methodStatic memberGetListItemTextLength
Returns the length of a list box or combo box entry.
Public methodStatic memberGetListSelectedFile(Control)
Fetches the selected directory or file name from a list box or combo box.
Public methodStatic memberGetListSelectedFile(Control, SalString%)
Fetches the selected directory or file name from a list box or combo box.
Public methodStatic memberGetListSelectedIndex
Returns the index of the selected entry in a combo box or single-selection list box.
Public methodStatic memberGetListSelectedItems
Fills the target array with the indexes of the selected entries in the listbox.
Public methodStatic memberGetListSelectedItemsCount
Returns the number of selected entries in a multiple-selection list box.
Public methodStatic memberGetLocation
Returns a window's current position on the X and Y axes.
Public methodStatic memberGetMdiClient
Returns the MDI client area of the MDI container.
Public methodStatic memberGetNextChild
Returns the next child control in the tab order that matches a specified type.
Public methodStatic memberGetParent
Returns the handle of an object's parent window.
Public methodStatic memberGetProfile
Returns the code of the custom profile associated with the specified field.
Public methodStatic memberGetProfileParameter(Control, Int32, SalNumber%)
Returns the requested parameter for the profile associated to the specified field.
Public methodStatic memberGetProfileParameter(Control, Int32, SalString%)
Returns the requested parameter for the profile associated to the specified field.
Public methodStatic memberGetProperty(Control, String)
Gets the value of a named property for a control.
Public methodStatic memberGetProperty(Control, String, SalString%)
Returns the value of the specified custom property.
Public methodStatic memberGetSalMessageName
Returns the name of a SAM message.
Public methodStatic memberGetScrollBarPosition
Returns the current scroll bar value.
Public methodStatic memberGetScrollBarRange
Gets a scroll bar's scroll range, line increment, and page increment.
Public methodStatic memberGetSize
Returns a window's size.
Public methodStatic memberGetSortedControls
Returns the collection of controls sorted by the TabIndex.
Public methodStatic memberGetState
Returns a window's current state.
Public methodStatic memberGetStatusBar
Returns the SalStatusBar control.
Public methodStatic memberGetStatusBarText
Gets the text displayed in the status bar of a top-level or MDI window.
Public methodStatic memberGetSysColor
Gets a system color.
Public methodStatic memberGetText(Control)
Retrieves the text of a control.
Public methodStatic memberGetText(Control, Int32)
Returns the string value of the specified control.
Public methodStatic memberGetText(Control, SalString%, Int32)
Returns the string value of the specified control.
Public methodStatic memberGetTextUnmasked
Returns the unmasked content of a data field or table window column.
Public methodStatic memberGetToolBar
Returns the SalToolbar control.
Public methodStatic memberGetWindowColor
Gets a window's color.
Public methodStatic memberHasAccessories
Returns true if the form has the accessories panels.
Public methodStatic memberHideWindow
Hides a control. Returns false if the control is already hidden.
Public methodStatic memberHideWindowAndLabel
Hides a control and its associated label.
Public methodStatic memberInsertListItem
Inserts an entry into a list box or combo box at a specified position.
Public methodStatic memberInvalidate
Public methodStatic memberIsChecked
Determines whether a radio button is set or a check box is checked.
Public methodStatic memberIsDerivedFrom
Returns true if a control is an instance of the class.
Public methodStatic memberIsEmpty
Verifies whether a data field, multiline text field, or table window column is null or empty.
Public methodStatic memberIsEnabled
Determines whether a window is enabled for mouse and keyboard input.
Public methodStatic memberIsKeyboardMessage
Returns true if the message code is a mouse or a keyboard message.
Public methodStatic memberIsModified
Returns the setting of the modified flag for a data field, multiline field, combo box, table window's context row cell.
Public methodStatic memberIsMouseMessage
Returns true if the message code is a mouse or a keyboard message.
Public methodStatic memberIsSalMessage
Returns true if the message is a known SAM message.
Public methodStatic memberIsValid
Validates the contents of a data field or table window column using the current profile.
Public methodStatic memberIsValidDateTime
Verifies whether a data field, multiline text field, or table window column contains a valid date/time value.
Public methodStatic memberIsValidDecimal
Verifies whether a data field, multiline text field, or table window column contains a valid decimal value.
Public methodStatic memberIsValidEditMask
Validates the input mask of a data field or table window column.
Public methodStatic memberIsValidFormat
Validates a numeric or date/time picture format.
Public methodStatic memberIsValidInteger
Verifies whether a data field, multiline text field, or table window column contains a valid integer value.
Public methodStatic memberIsValidNumber
Verifies whether a data field, multiline text field, or table window column contains a valid numeric value..
Public methodStatic memberIsVisible
Determines whether a window is currently visible.
Public methodStatic memberKillTimer
Destroys an control's system timer.
Public methodStatic memberListGetMultiSelect
Returns an array of index numbers of selected list box entries.
Public methodStatic memberMDIArrangeIcons
Arranges minimized child window icons in an MDI window.
Public methodStatic memberMDICascade
Cascades all non-iconized child windows of an MDI window.
Public methodStatic memberMDITile
Tiles all non-iconized child windows of an MDI window. Windows that are not sizable will not be tiled.
Public methodStatic memberMessageBeep
Plays a waveform sound that corresponds to a given system alert level.
Public methodStatic memberMessageBox
Displays a message box and returns a number that indicates the user's response.
Public methodStatic memberModalDialog(String, Control, array<Object>[]()[][])
Creates a modal dialog box.
Public methodStatic memberModalDialog(Type, Control, array<Object>[]()[][])
Creates a modal dialog box.
Public methodStatic memberMove
Moves a window a given number of form units on the X and Y axes relative to its current position.
Public methodStatic memberPaste
Pastes the text in the clipboard to the control with the focus.
Public methodStatic memberPasteString
Pastes the contents of the Clipboard into the specified string in text format.
Public methodStatic memberPixelsToFormUnits
Computes the number of form units based on the number of pixels.
Public methodStatic memberPopulateList(Control, SalSqlHandle, String)
Populates a list box or combo box with a result set.
Public methodStatic memberPopulateList(Control, SalSqlHandle, String, WhenSqlErrorHandler)
Populates a list box or combo box with a result set.
Public methodStatic memberPopulateListFiles
Populates a list box or combo box with a directory of files.
Public methodStatic memberPostMessage
Posts the specified message to a window by adding nMsg to handleReceiver's message queue.
Public methodStatic memberPreviewForm
Prints a form window, table window, or dialog box, including its contents and row header flags.
Public methodStatic memberPrintForm
Prints a form window, table window, or dialog box, including its contents and row header flags.
Public methodProcessWndProc
Processes windows messages for SAL controls.
Public methodRemoveMessageActions
Removes the specified handler from the list.
Public methodStatic memberScale(Point, Size, Size)
Scales the specified pixels by converting to form units first and then back to pixels using the new scaling factor.
Public methodStatic memberScale(Size, Size, Size)
Scales the specified pixels by converting to form units first and then back to pixels using the new scaling factor.
Public methodStatic memberSendMessage
Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.
Public methodStatic memberSendMessageToChildren
Sends a message to all child items of a form window, dialog box, table window, or MDI window.
Public methodStatic memberSendMessageToChildrenInternal
Sends a message to all child items of a form window, dialog box, table window, or MDI window.
Public methodStatic memberSendSalMessage
Dispatches a Sal messages directly to the control's MessageActions handler.
Public methodStatic memberSendValidateMessage
Sends a SAM_Validate message to the object with the focus.
Public methodStatic memberSetContextMenu(Control, String)
Defines the context menu for a control.
Public methodStatic memberSetContextMenu(Control, Type)
Defines the context menu for a control.
Public methodStatic memberSetCursor(Control, array<Byte>[]()[][], Int32)
Sets a window's cursor from a string variable.
Public methodStatic memberSetCursor(Control, Int32, Int32)
Sets a window's cursor.
Public methodStatic memberSetCursor(Control, String, Int32)
Sets an application-defined cursor for the specified window. Use this function to set the cursor from an image stored in a file.
Public methodStatic memberSetCursor(Control, Cursor, Int32)
Sets a window's cursor.
Public methodStatic memberSetDataLength
Sets a limit on the number of characters that a user can enter into a data field, multiline text field, or table window column.
Public methodStatic memberSetDefaultButton
Sets the default push button of a form window or dialog box.
Public methodStatic memberSetFocus
Sets the focus to a specified window.
Public methodStatic memberSetFont
Sets a window's font, font size, and font enhancements.
Public methodStatic memberSetFormat
Sets the picture format of a data field or table window column.
Public methodStatic memberSetFormatCode
Sets a data field's or table window column's format.
Public methodStatic memberSetFormattedText
Copies a formatted string to a data field or table window column.
Public methodStatic memberSetInputMask
Sets the input mask of a data field or table window column.
Public methodStatic memberSetLabel
Changes the Label assigned to the specified control.
Public methodStatic memberSetLabelText
Sets the label text of a control.
Public methodStatic memberSetListRedraw
Public methodStatic memberSetListSelectedIndex
Selects or deselects a combo box or single-selection list box entry. If the listbox is multiselect using -1 as the index value selects all items, while using any other invalid index value deselects all items. For normal listbox, using -1 always deselects all items.
Public methodStatic memberSetListSelectedItems
Selects or deselects a combo box or multiple-selection list box entry.
Public methodStatic memberSetListSelectedText
Public methodStatic memberSetListTabStops
Sets tabs in a list box. List boxes use tabs to align columns of data.
Public methodStatic memberSetLocation
Moves a window to a new position (x, y) on the X and Y axes.
Public methodStatic memberSetModified
Sets or clears the field modified flag for an editable data field, combo box, multiline text field, table window column.
Public methodStatic memberSetProfile
Changes the custom profile of the specified field.
Public methodStatic memberSetProfileParameter(Control, Int32, SalNumber)
Alters the specified parameter for the custom profile associated to the specified field.
Public methodStatic memberSetProfileParameter(Control, Int32, SalString)
Alters the specified parameter for the custom profile associated to the specified field.
Public methodStatic memberSetProperty
Sets the value of a named property for a control.
Public methodStatic memberSetScrollBarPosition
Sets a scroll bar's position.
Public methodStatic memberSetScrollBarRange
Sets a scroll bar's range, line increment, and page increment.
Public methodStatic memberSetSize
Resizes a window.
Public methodStatic memberSetStatusBarText(Control, String)
Updates the status bar of the top level form that owns the specified control.
Public methodStatic memberSetStatusBarText(Menu, String)
Updates the status bar of the form that owns the menu item.
Public methodStatic memberSetText
Sets the text of a control to a specified string.
Public methodStatic memberSetTimer
Creates a system timer for a given control.
Public methodStatic memberSetWindowColor
Sets a window's color.
Public methodStatic memberShowStatusBar
Shows or hides the status bar on a top-level or MDI window.
Public methodStatic memberShowToolBar
Shows or hides the tool bar on a top-level or MDI window.
Public methodStatic memberShowWindow
Makes a control visible.
Public methodStatic memberShowWindowAndLabel
Makes a control and its associated label visible.
Public methodStatic memberTrackPopupMenu(Control, String, Int32, Point)
Shows context popup menu at runtime.
Public methodStatic memberTrackPopupMenu(Control, Type, Int32, Point)
Shows context popup menu at runtime.
Public methodStatic memberTranslateColor
Converts .NET colors to the corresponding SAL color constant.
Public methodStatic memberTranslateControl
Translate the parent control into a valid control instance: - if the ClientArea is passed returns the form - if a second base visual class is passed, returns the instance - if a embedded TableWindow control is passed, returns the parent TableWindowForm
Public methodStatic memberTranslateProfile
Translates CTD profile codes to the equivalent .NET CultureInfo.
Public methodStatic memberTranslateSalColor
Converts SAL colors to a .NET Color.
Public methodStatic memberUndo
Undoes the last edit in the control with the focus.
Public methodStatic memberUpdate
Forces the repaint of a control.
Public methodStatic memberUpdateMainMenu
Updates the form's main menu.
Public methodStatic memberWaitCursor
Displays or removes the hourglass cursor.
Public methodStatic memberValidate
Validates and formats a data field's or table window column's contents.
Public methodStatic memberWinHelp
Starts the Windows help system.
Public methodStatic memberYield
Processes messages in the message loop. This function replaces all SalYield* functions. It must be placed in the loop that block execution.

See Also