Skip to main content
Version: 2023

VisListView

Namespace: PPJ.Runtime.Vis

Assembly: PPJ.Web.Vis.49 (4.9.0.0)

ListView control

public class VisListView : ListView, ISalWindow

Constructors​

Instance memberVisListView()​

Default Constructor.

Properties​

Instance memberNamedProperties​

SalNamedProperties: Returns the collection of named properties.

Methods​

Instance memberAddImage(hpicLarge, hpicSmall)​

Adds an image to control's internal ImageLists.

ParameterTypeDescription
hpicLargeSalNumber
hpicSmallSalNumber

Returns: SalNumber.

Instance memberAssignColumns(saTitles, naAlignments, naWidths, nNumColumns)​

Assigns columns to be used for 'details' view.

ParameterTypeDescription
saTitlesSalArray<SalString>
naAlignmentsSalArray<SalNumber>
naWidthsSalArray<SalNumber>
nNumColumnsSalNumber

Returns: SalBoolean.

Instance memberBringWindowToTop()​

Brings a window to the top of all overlapping windows.

Returns: SalBoolean.

Instance memberCenterWindow()​

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.

Instance memberClearCursor(nType)​

Clears a window's cursor.

ParameterTypeDescription
nTypeSalNumber

Returns: SalBoolean.

Instance memberDeleteAllItems()​

Removes all items from the control.

Returns: SalBoolean.

Instance memberDeleteItem(nItem)​

Removes an item from control and returns count of remaining items.

ParameterTypeDescription
nItemSalNumber

Returns: SalNumber.

Instance memberDestroyWindow()​

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

Returns: SalBoolean.

Instance 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.

Returns: SalBoolean.

Instance memberEnableWindow()​

Enables keyboard and mouse input to a window.

Returns: SalBoolean.

Instance memberEnsureVisible(nItem, fPartialOK)​

Ensures that an item is visible

ParameterTypeDescription
nItemSalNumber
fPartialOKSalBoolean

Returns: SalBoolean.

Instance memberFindChild(sWindowName)​

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

ParameterTypeDescription
sWindowNameSalString

Returns: SalWindowHandle.

Instance memberFindItem(nFlags, sItemText, nItemStart)​

Searches for an item by text or position.

ParameterTypeDescription
nFlagsSalNumber
sItemTextSalString
nItemStartSalNumber

Returns: SalNumber.

Instance memberFormUnitsToPixels(nFormUnits, bVertical)​

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.

ParameterTypeDescription
nFormUnitsSalNumber
bVerticalSalBoolean

Returns: SalNumber.

Static memberFromHandle(hWnd)​

Returns the control associated with the handle.

ParameterTypeDescription
hWndSalWindowHandle

Returns: VisListView.

Instance memberGetAllSelectedItems(naSelections)​

Retrieves array of all selected items and returns count.

ParameterTypeDescription
naSelectionsSalArray<SalNumber>

Returns: SalNumber.

Instance memberGetBkColor()​

Retrieves the color used for the control's overall background.

Returns: SalNumber.

Instance memberGetClassName()​

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

Returns: SalString.

Instance memberGetColumn(nColumn, sTitle, nAlignment, nWidth)​

ParameterTypeDescription
nColumnSalNumber
sTitleSalString&
nAlignmentSalNumber&
nWidthSalNumber&

Returns: SalBoolean.

Instance memberGetColumnAlignment(nColumn)​

ParameterTypeDescription
nColumnSalNumber

Returns: SalNumber.

Instance memberGetColumnTitle(nColumn)​

Retrieves a column's text.

ParameterTypeDescription
nColumnSalNumber

Returns: SalString.

Instance memberGetColumnWidth(nColumn)​

Retrieves a column's width.

ParameterTypeDescription
nColumnSalNumber

Returns: SalNumber.

Instance memberGetControlType()​

Returns an object's type.

Returns: SalNumber.

Instance memberGetFirstChild(nTypeMask)​

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.

ParameterTypeDescription
nTypeMaskSalNumber

Returns: SalWindowHandle.

Instance memberGetFocusItem()​

Retrieves index of item with input focus.

Returns: SalNumber.

Instance memberGetFont(sName, nSize, nEnhancement)​

ParameterTypeDescription
sNameSalString&
nSizeSalNumber&
nEnhancementSalNumber&

Returns: SalBoolean.

Instance memberGetImageCount()​

Retrieves the number of images in control.

Returns: SalNumber.

Instance memberGetItem(nItem, nSubItem, sItemText, nItemValue, nImage)​

ParameterTypeDescription
nItemSalNumber
nSubItemSalNumber
sItemTextSalString&
nItemValueSalNumber&
nImageSalNumber&

Returns: SalBoolean.

Instance memberGetItemCount()​

Retrieves the number of items in control.

Returns: SalNumber.

Instance memberGetItemState(nItem, nMask)​

Retrieves an item's state.

ParameterTypeDescription
nItemSalNumber
nMaskSalNumber

Returns: SalNumber.

Instance memberGetItemText(nItem, nSubItem)​

Retrieves an item's text.

ParameterTypeDescription
nItemSalNumber
nSubItemSalNumber

Returns: SalString.

Instance memberGetItemValue(nItem)​

Retrieves an item's user data.

ParameterTypeDescription
nItemSalNumber

Returns: SalNumber.

Instance memberGetLocation(nX, nY)​

ParameterTypeDescription
nXSalNumber&
nYSalNumber&

Returns: SalBoolean.

Instance memberGetName(sText)​

ParameterTypeDescription
sTextSalString&

Returns: SalBoolean.

Instance memberGetName()​

Gets the name of an object.

Returns: SalString.

Instance memberGetNextChild(nTypeMask)​

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

ParameterTypeDescription
nTypeMaskSalNumber

Returns: SalWindowHandle.

Instance memberGetNextItem(nItem, nFlags)​

Searches for an item by sequence, relation or state.

ParameterTypeDescription
nItemSalNumber
nFlagsSalNumber

Returns: SalNumber.

Instance memberGetParent()​

Returns the handle of an object's parent window.

Returns: SalWindowHandle.

Instance memberGetProperty(sName, sValue)​

ParameterTypeDescription
sNameSalString
sValueSalString&

Returns: SalBoolean.

Instance memberGetProperty(sName)​

Gets the value of a named property.

ParameterTypeDescription
sNameSalString

Returns: SalString.

Instance memberGetSelectedCount()​

Retrieves the number of selected items in control.

Returns: SalNumber.

Instance memberGetSelectedItem()​

Returns: SalNumber.

Instance memberGetSize(nWidth, nHeight)​

ParameterTypeDescription
nWidthSalNumber&
nHeightSalNumber&

Returns: SalBoolean.

Instance memberGetSortColumn()​

Retrieves default sort column (subitem.)

Returns: SalNumber.

Instance memberGetSortOrder()​

Retrieves default sort order (ascending/descending)

Returns: SalNumber.

Instance memberGetText(sText, nMaxLen)​

ParameterTypeDescription
sTextSalString&
nMaxLenSalNumber

Returns: SalNumber.

Instance memberGetText(nMaxLen)​

Retrieves the text of a window.

ParameterTypeDescription
nMaxLenSalNumber

Returns: SalString.

Instance memberGetTextBkColor()​

Retrieves the color used for item and subitem text background.

Returns: SalNumber.

Instance memberGetTextColor()​

Retrieves the color used for item and subitem text.

Returns: SalNumber.

Instance memberGetWindowColor(nColorIndex)​

Gets a window's color.

ParameterTypeDescription
nColorIndexSalNumber

Returns: SalNumber.

Instance memberGetWindowState()​

Returns a window's current state.

Returns: SalNumber.

Instance memberHideWindow()​

Hides a window.

Returns: SalBoolean.

Instance memberInsertDetails(nItem, saText, nImage)​

Inserts a new item into control and supplies subitem text for item.

ParameterTypeDescription
nItemSalNumber
saTextSalArray<SalString>
nImageSalNumber

Returns: SalNumber.

Instance memberInsertDetailsPic(nItem, saText, hpicLarge, hpicSmall)​

Inserts a new item in control, copies picture into control and uses copy for new item.

ParameterTypeDescription
nItemSalNumber
saTextSalArray<SalString>
hpicLargeSalNumber
hpicSmallSalNumber

Returns: SalNumber.

Instance memberInsertDetailsValue(nItem, saText, nItemValue, nImage)​

Inserts a new item into control and supplies subitem text for item; also assigns user data for item.

ParameterTypeDescription
nItemSalNumber
saTextSalArray<SalString>
nItemValueSalNumber
nImageSalNumber

Returns: SalNumber.

Instance memberInsertDetailsValuePic(nItem, saText, nItemValue, hpicLarge, hpicSmall)​

Inserts a new item into control and supplies subitem text for item; also assigns user data for item.

ParameterTypeDescription
nItemSalNumber
saTextSalArray<SalString>
nItemValueSalNumber
hpicLargeSalNumber
hpicSmallSalNumber

Returns: SalNumber.

Instance memberInsertItem(nItem, sText, nImage)​

Inserts an item in control and returns index of new item or -1 if unsuccessful.

ParameterTypeDescription
nItemSalNumber
sTextSalString
nImageSalNumber

Returns: SalNumber.

Instance memberInsertItemPic(nItem, sText, hpicLarge, hpicSmall)​

Inserts a new item in control, copies picture into control and uses copy for new item. Returns index of new item or -1 if unsuccessful.

ParameterTypeDescription
nItemSalNumber
sTextSalString
hpicLargeSalNumber
hpicSmallSalNumber

Returns: SalNumber.

Instance memberInsertItemValue(nItem, sText, nItemValue, nImage)​

Inserts a new item in control and assigns user data for item. Returns index of new item or -1 if unsuccessful.

ParameterTypeDescription
nItemSalNumber
sTextSalString
nItemValueSalNumber
nImageSalNumber

Returns: SalNumber.

Instance memberInsertItemValuePic(nItem, sText, nItemValue, hpicLarge, hpicSmall)​

Inserts a new item in control, copies picture into control and uses copy for new item. Also assigns user data for item. Returns index of new item or -1 if unsuccessful.

ParameterTypeDescription
nItemSalNumber
sTextSalString
nItemValueSalNumber
hpicLargeSalNumber
hpicSmallSalNumber

Returns: SalNumber.

Instance memberInvalidateWindow()​

Causes a window to be repainted.

Returns: SalBoolean.

Instance memberIsDerivedFromClass(tClass)​

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

ParameterTypeDescription
tClassType

Returns: SalBoolean.

Instance memberIsEnabled()​

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

Returns: SalBoolean.

Instance memberIsVisible()​

Determines whether a window is currently visible.

Returns: SalBoolean.

Instance memberKillTimer(nIDEvent)​

Destroys an object's system timer.

ParameterTypeDescription
nIDEventSalNumber

Returns: SalBoolean.

Instance memberMoveWindow(nXOffset, nYOffset)​

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

ParameterTypeDescription
nXOffsetSalNumber
nYOffsetSalNumber

Returns: SalBoolean.

Instance memberPixelsToFormUnits(nNumPixels, bVertical)​

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.

ParameterTypeDescription
nNumPixelsSalNumber
bVerticalSalBoolean

Returns: SalNumber.

Instance memberPostMessage(nMsg, nMywParam, nMylParam)​

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

ParameterTypeDescription
nMsgSalNumber
nMywParamSalNumber
nMylParamSalNumber

Returns: SalBoolean.

Instance memberRemoveAllImages()​

Removes all images from control.

Returns: SalBoolean.

Instance memberRemoveImage(nIndex)​

Removes an image from control's internal ImageLists.

ParameterTypeDescription
nIndexSalNumber

Returns: SalBoolean.

Instance memberReplaceImage(nIndex, hpicLarge, hpicSmall)​

Replaces an image in control's internal ImageLists.

ParameterTypeDescription
nIndexSalNumber
hpicLargeSalNumber
hpicSmallSalNumber

Returns: SalBoolean.

Instance memberSendMessage(nMsg, nMywParam, nMylParam)​

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

ParameterTypeDescription
nMsgSalNumber
nMywParamSalNumber
nMylParamSalNumber

Returns: SalNumber.

Instance memberSendMessageToChildren(nMsg, nMywParam, nMylParam)​

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

ParameterTypeDescription
nMsgSalNumber
nMywParamSalNumber
nMylParamSalNumber

Returns: SalBoolean.

Instance memberSetBkColor(nNewColor)​

Assigns the color used for the control's overall background.

ParameterTypeDescription
nNewColorSalNumber

Returns: SalBoolean.

Instance memberSetColumn(nColumn, nMask, sTitle, nAlignment, nWidth)​

Sets the attributes of a column.

ParameterTypeDescription
nColumnSalNumber
nMaskSalNumber
sTitleSalString
nAlignmentSalNumber
nWidthSalNumber

Returns: SalBoolean.

Instance memberSetColumnAlignment(nColumn, nAlignment)​

ParameterTypeDescription
nColumnSalNumber
nAlignmentSalNumber

Returns: SalBoolean.

Instance memberSetColumnTitle(nColumn, sTitle)​

Sets a column's text.

ParameterTypeDescription
nColumnSalNumber
sTitleSalString

Returns: SalBoolean.

Instance memberSetColumnWidth(nColumn, nWidth)​

Sets a column's width.

ParameterTypeDescription
nColumnSalNumber
nWidthSalNumber

Returns: SalBoolean.

Instance memberSetContextMenu(sMenuName, nFlags)​

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

ParameterTypeDescription
sMenuNameSalString
nFlagsSalNumber

Returns: SalBoolean.

Instance memberSetContextMenu(menuType, nFlags)​

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

ParameterTypeDescription
menuTypeType
nFlagsSalNumber

Returns: SalBoolean.

Instance memberSetCursor(nResourceId, nType)​

Sets a window's cursor.

ParameterTypeDescription
nResourceIdInt32
nTypeSalNumber

Returns: SalBoolean.

Instance memberSetCursor(sBlob, nType)​

Sets a window's cursor from a string variable.

ParameterTypeDescription
sBlobSalString
nTypeSalNumber

Returns: SalBoolean.

Instance memberSetCursorFile(sFile, nType)​

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

ParameterTypeDescription
sFileSalString
nTypeSalNumber

Returns: SalBoolean.

Instance memberSetFocus()​

Sets the focus to a specified window.

Returns: SalWindowHandle.

Instance memberSetFocusItem(nItem)​

Assigns focus to the specified item.

ParameterTypeDescription
nItemSalNumber

Returns: SalBoolean.

Instance memberSetFont(sName, nSize, nEnhancement)​

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

ParameterTypeDescription
sNameSalString
nSizeSalNumber
nEnhancementSalNumber

Returns: SalBoolean.

Instance memberSetItem(nItem, nSubItem, nMask, sItemText, nItemValue, nImage)​

Sets an item's attributes.

ParameterTypeDescription
nItemSalNumber
nSubItemSalNumber
nMaskSalNumber
sItemTextSalString
nItemValueSalNumber
nImageSalNumber

Returns: SalBoolean.

Instance memberSetItemState(nItem, nNewState, nStateMask)​

Assigns an item's state (LVIS_Focused, LVIS_Selected, etc..)

ParameterTypeDescription
nItemSalNumber
nNewStateSalNumber
nStateMaskSalNumber

Returns: SalBoolean.

Instance memberSetItemText(nItem, nSubItem, sItemText)​

Sets an item's or subitem's text.

ParameterTypeDescription
nItemSalNumber
nSubItemSalNumber
sItemTextSalString

Returns: SalBoolean.

Instance memberSetItemValue(nItem, nItemValue)​

Assigns an item's user data.

ParameterTypeDescription
nItemSalNumber
nItemValueSalNumber

Returns: SalBoolean.

Instance memberSetLocation(nX, nY)​

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

ParameterTypeDescription
nXSalNumber
nYSalNumber

Returns: SalBoolean.

Instance memberSetProperty(sName, sValue, nLength)​

Sets the value of a named property.

ParameterTypeDescription
sNameSalString
sValueSalString
nLengthSalNumber

Returns: SalBoolean.

Instance memberSetSize(nWidth, nHeight)​

Resizes a window.

ParameterTypeDescription
nWidthSalNumber
nHeightSalNumber

Returns: SalBoolean.

Instance memberSetSortColumn(nColumn)​

Assigns default column (subitem) to sort on.

ParameterTypeDescription
nColumnSalNumber

Returns: SalBoolean.

Instance memberSetSortOrder(nOrder)​

Assigns default sort order (LVSORT_Ascending/LVSORT_Descending.)

ParameterTypeDescription
nOrderSalNumber

Returns: SalBoolean.

Instance memberSetStyle(nStyle, fOn)​

Sets style bits for control.

ParameterTypeDescription
nStyleSalNumber
fOnSalBoolean

Returns: SalNumber.

Instance memberSetText(sText)​

Sets the text of a window.

ParameterTypeDescription
sTextSalString

Returns: SalBoolean.

Instance memberSetTextBkColor(nNewColor)​

Assigns the color used for item and subitem text background.

ParameterTypeDescription
nNewColorSalNumber

Returns: SalBoolean.

Instance memberSetTextColor(nNewColor)​

Assigns the color used for item and subitem text.

ParameterTypeDescription
nNewColorSalNumber

Returns: SalBoolean.

Instance memberSetTimer(nIDEvent, nElapseMilliSec)​

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.

ParameterTypeDescription
nIDEventSalNumber
nElapseMilliSecSalNumber

Returns: SalBoolean.

Instance memberSetWindowColor(nColorIndex, nColor)​

Sets a window's color.

ParameterTypeDescription
nColorIndexSalNumber
nColorSalNumber

Returns: SalBoolean.

Instance memberShowWindow()​

Makes a window visible.

Returns: SalBoolean.

Instance memberSortItems()​

Sorts the items.

Returns: SalBoolean.

Instance memberTrackPopupMenu(sMenuName, nFlags, nX, nY, callback)​

Creates pop-up menus at runtime.

ParameterTypeDescription
sMenuNameSalString
nFlagsSalNumber
nXSalNumber
nYSalNumber
callbackAction<ContextMenu>

Returns: SalBoolean.

Instance memberTrackPopupMenu(menuType, nFlags, nX, nY, callback)​

Creates pop-up menus at runtime.

ParameterTypeDescription
menuTypeType
nFlagsSalNumber
nXSalNumber
nYSalNumber
callbackAction<ContextMenu>

Returns: SalBoolean.

Instance memberUpdateWindow()​

Forces the update of a window.

Returns: SalBoolean.

Instance memberViewDetails()​

Tells control to display 'details' view.'

Returns: SalNumber.

Instance memberViewLargeIcons()​

Tells control to display 'large icons' view.

Returns: SalNumber.

Instance memberViewSmallIcons()​

Tells control to display 'small icons' view.

Returns: SalNumber.

Events​

Instance memberWindowActions​

WindowActionsEventHandler

Implements​

NameDescription
ISalWindow