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