Jump to content

MulticolumnListbox class: Difference between revisions

From LabVIEW Wiki
← Older edit
Visual
mNo edit summary
Removed template
 
(4 intermediate revisions by the same user not shown)
Line 7: Line 7:
{{TOCright}}
{{TOCright}}


==Properties==
== Properties ==
<span class="mw-customtoggle-propertiestable">Show/Hide MulticolumnListbox Properties Table</span>
<span class="mw-customtoggle-propertiestable">Show/Hide MulticolumnListbox Properties Table</span>
<div class="mw-collapsible" id="mw-customcollapsible-propertiestable">
<div class="mw-collapsible" id="mw-customcollapsible-propertiestable">
{{VIServerLegend|showrw=TRUE|showrte=TRUE}}
{{VIServerLegend|showrw=TRUE|showrte=TRUE}}
{| class="wikitable sortable"
<div style="width: 80%; max-height: 50em; overflow: auto;">
{| class="wikitable sortable"  
|+ MulticolumnListbox Properties Table
|+ MulticolumnListbox Properties Table
! Property ID
! data-sort-type="number"| Property ID
! Short Name (English)
! Long Name (English)
! Description
! Description
! R/W
! R/W
! RTE
! RTE  
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D9900E
| data-sort-value=416911360 |18D99000
| [[MulticolumnListbox class/ActiveCell property|ActiveCell]]
| [[MulticolumnListbox class/Item Names property|Item Names]]
|Sets the row and column of the active cell(s).
| The strings for the selectable items in a two-dimensional array for rows and columns.
 
| Read/Write
{| class="wikitable"
| Yes
|+ scope="col" style="text-align:left;"|Elements:
|- style="background-color:#FFFFCC;"  
! scope="col" style="text-align:left;"| Name
| data-sort-value=416911361 |18D99001
! scope="col" style="text-align:left;"| Description
| [[MulticolumnListbox class/Item Symbols property|Item Symbols]]
|- style="vertical-align:top;"
| Array of item symbols. Item symbols (0-40) are as shown in the [[listbox symbol ring]] constant.
! scope="row" style="text-align:left;"|Row
| Read/Write
|Sets the row(s) of the active cell(s). Possible values are 0…n, where n is the total number of rows - 1. Enter &#8211;2 to select all rows.
| Yes
|- style="vertical-align:top;"
|- style="background-color:#FFFFCC;"  
! scope="row" style="text-align:left;"|Column
| data-sort-value=416911362 |18D99002
|Sets the column(s) of the active cell(s).  Possible values are 0…m, where m is the total number of columns - 1. Enter &#8211;2 to select all columns. Enter &#8211;1 to select the column header.
| [[MulticolumnListbox class/Disabled Items property|Disabled Items]]
|}
| Array of indexes of disabled rows (first row is 0).
 
| Read/Write
The following table lists example values for this property.
| Yes
 
|- style="background-color:#FFFFCC;"  
{| class="wikitable"
| data-sort-value=416911365 |18D99005
! scope="col" style="text-align:left;"| Row
| [[MulticolumnListbox class/Column Header Strings() property|Column Header Strings[]]]
! scope="col" style="text-align:left;"| Column
| An array of the strings in the column headers.
! scope="col" style="text-align:left;"| Result
| Read/Write
|- style="vertical-align:top;"
| Yes
| -2
|- style="background-color:#FFFFCC;"  
| 0
| data-sort-value=416911366 |18D99006
| Selects all cells in the first column, including the column header.
| [[MulticolumnListbox class/Visible Items.Symbols Visible property|Visible Items:Symbols Visible]]
|- style="vertical-align:top;"
| If TRUE, displays the item symbols.
| -2
| Read/Write
| -2
| Yes
| Selects all rows and columns, including column headers.
|- style="background-color:#FFFFCC;"  
|- style="vertical-align:top;"
| data-sort-value=416911367 |18D99007
| -1
| [[MulticolumnListbox class/Visible Items.Vertical Scrollbar Visible property|Visible Items:Vertical Scrollbar Visible]]
| 0
| If TRUE, displays the vertical scroll bar.
| Selects the header of the first column.
| Read/Write
|- style="vertical-align:top;"
| Yes
| -1
|- style="background-color:#FFFFCC;"  
| -2
| data-sort-value=416911368 |18D99008
| Selects the headers of all columns
| [[MulticolumnListbox class/Visible Items.Horizontal Scrollbar Visible property|Visible Items:Horizontal Scrollbar Visible]]
|- style="vertical-align:top;".
| If TRUE, displays the horizontal scroll bar.
| 0
| Read/Write
| -2
| Yes
| Selects all cells of the first row, including the row header.
|- style="background-color:#FFFFCC;"  
|- style="vertical-align:top;"
| data-sort-value=416911369 |18D99009
| 0
| [[MulticolumnListbox class/Number of Rows property|Number of Rows]]
| -1
| Number of visible rows in the multicolumn listbox, excluding column headers. This property counts partially visible rows.
| Selects the header of the first row.
| Read/Write
|}
| Yes
|R/W
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416911370 |18D9900A
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Number of Columns property|Number of Columns]]
|18D99010
| Number of visible columns in the multicolumn listbox. This property counts partially visible columns.
| [[MulticolumnListbox class/CellBG property|CellBG]]
| Read/Write
|The background color of the active cell(s).
| Yes
 
|- style="background-color:#FFFFCC;"  
You can set the color of the front panel object by wiring a hexadecimal number with the form RRGGBB or by wiring the color box constant to the property.
| data-sort-value=416911371 |18D9900B
|R/W
| [[MulticolumnListbox class/Visible Items.Column Headers Visible property|Visible Items:Column Headers Visible]]
|X
| If TRUE, displays the column headers.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D99025
| Yes
| [[MulticolumnListbox class/CellFont property|CellFont]]
|- style="background-color:#FFFFCC;"  
|The font of the active cell in the multicolumn listbox control.
| data-sort-value=416911372 |18D9900C
 
| [[MulticolumnListbox class/Top Left Visible Cell property|Top Left Visible Cell]]
Use this property to change the size, style, or color of the cell font. You cannot use this property with a strict type definition.
| The row and column of the item string displayed in the top left corner of the listbox. Use this property to read or change the top item, or use it to read or change the leftmost column of information displayed.
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99028
| data-sort-value=416911373 |18D9900D
| [[MulticolumnListbox class/CellFontBold property|CellFontBold]]
| [[MulticolumnListbox class/Selection Mode property|Selection Mode]]
|Indicates whether the text in the active cell is bold.
| Number of items the user can select. Valid values include 0 (zero or one), 1 (one), 2 (zero or more), and 3 (one or more).
 
| Read/Write
This property is an element of the Active Cell:Cell Font property.
| Yes
|R/W
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416911374 |18D9900E
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Active Cell.Active Cell property|Active Cell:Active Cell]]
|18D9902C
| Sets the row and column of the active cell(s).
| [[MulticolumnListbox class/CellFontColor property|CellFontColor]]
| Read/Write
|The text font color in the active cell.
| Yes
 
|- style="background-color:#FFAAAA;"  
This property is an element of the Active Cell:Cell Font property.
| data-sort-value=416911375 |18D9900F
|R/W
| [[MulticolumnListbox class/Active Cell.Cell Foreground Color property|Active Cell:Cell Foreground Color]]
|X
|  
|- style="background-color:#FFFFCC;"
| Read/Write
|18D99029
| Yes
| [[MulticolumnListbox class/CellFontItalic property|CellFontItalic]]
|- style="background-color:#FFFFCC;"  
|Indicates whether the text in the active cell is italic.
| data-sort-value=416911376 |18D99010
 
| [[MulticolumnListbox class/Active Cell.Cell Background Color property|Active Cell:Cell Background Color]]
This property is an element of the Active Cell:Cell Font property.
| The background color of the active cell(s).
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99026
| data-sort-value=416911377 |18D99011
| [[MulticolumnListbox class/CellFontName property|CellFontName]]
| [[MulticolumnListbox class/Active Cell.Cell Size property|Active Cell:Cell Size]]
|The name of the font in the active cell. Predefined font names include App Font, Sys Font, and Dlg Font.
| The size of the active cell(s) in pixels.
 
| Read/Write
This property is an element of the Active Cell:Cell Font property.
| Yes
 
|- style="background-color:#FFFFCC;"  
If you select an invalid font, this property returns an error.
| data-sort-value=416911378 |18D99012
|R/W
| [[MulticolumnListbox class/Active Cell.Cell Size.Width property|Active Cell:Cell Size:Width]]
|X
| The width of the active cell(s) in pixels.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D99027
| Yes
| [[MulticolumnListbox class/CellFontSize property|CellFontSize]]
|- style="background-color:#FFFFCC;"  
|The size of the font in the active cell.
| data-sort-value=416911379 |18D99013
 
| [[MulticolumnListbox class/Active Cell.Cell Size.Height property|Active Cell:Cell Size:Height]]
This property is an element of the Active Cell:Cell Font property.
| The height of the active cell(s) in pixels.
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D9902B
| data-sort-value=416911380 |18D99014
| [[MulticolumnListbox class/CellFontStrike property|CellFontStrike]]
| [[MulticolumnListbox class/Selection Color property|Selection Color]]
|Indicates whether to strike out the text in the active cell.
| The color used to highlight the selected items.
 
| Read/Write
This property is an element of the Active Cell:Cell Font property.
| Yes
|R/W
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416911381 |18D99015
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Autosizing Row Height property|Autosizing Row Height]]
|18D9902A
| Determines whether the rows autosize their height to display all text when fonts change or when the number of lines in a cell changes.
| [[MulticolumnListbox class/CellFontUnder property|CellFontUnder]]
| Read/Write
|Indicates whether the text in the active cell is underlined.
| Yes
 
|- style="background-color:#FFFFCC;"  
This property is an element of the Active Cell:Cell Font property.
| data-sort-value=416911382 |18D99016
|R/W
| [[MulticolumnListbox class/Smooth Horizontal Scrolling property|Smooth Horizontal Scrolling]]
|X
| If TRUE, the horizontal scrolling of the listbox is by pixels, such that the first column may be horizontally clipped. If FALSE, the listbox scrolls by whole column widths such that the first column is never clipped. However, if a column is wider than the width of the listbox, you cannot see the text that is hidden off the right edge of that column.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D9902D
| Yes
| [[MulticolumnListbox class/CellJustify property|CellJustify]]
|- style="background-color:#FFFFCC;"  
|Gets and sets the justification of text within a table cell.
| data-sort-value=416911383 |18D99017
|R/W
| [[MulticolumnListbox class/Multiple Line Input property|Multiple Line Input]]
|X
| If TRUE, you can enter multiple lines of text in the listbox cells by pressing the <Enter> key on the keyboard. If FALSE, pressing the <Enter> key on the keyboard while editing cells causes LabVIEW to commit the edits in the current cell and move the text focus to the next cell. This property does not affect run-time behavior of the listbox.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D99011
| Yes
| [[MulticolumnListbox class/CellSize property|CellSize]]
|- style="background-color:#FFFFCC;"  
|The size of the active cell(s) in pixels.
| data-sort-value=416911384 |18D99018
 
| [[MulticolumnListbox class/Selected Cell property|Selected Cell]]
Changing the cell size does not change the size of the multicolumn listbox control.
| Reads or writes the row and column of the most recently selected cell in the multicolumn listbox.
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99013
| data-sort-value=416911385 |18D99019
| [[MulticolumnListbox class/Height property|Height]]
| [[MulticolumnListbox class/Size property|Size]]
|The height of the active cell(s) in pixels.
| The width and height in pixels of the multicolumn listbox control.
 
| Read/Write
This property is an element of the Active Cell:Cell Size property.
| Yes
|R/W
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416911386 |18D9901A
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Size.Width property|Size:Width]]
|18D99012
| The width of the active cell(s) in pixels.
| [[MulticolumnListbox class/Width property|Width]]
| Read/Write
|The width of the active cell(s) in pixels.
| Yes
 
|- style="background-color:#FFFFCC;"  
This property is an element of the Active Cell:Cell Size property.
| data-sort-value=416911387 |18D9901B
|R/W
| [[MulticolumnListbox class/Size.Height property|Size:Height]]
|X
| The height of the active cell(s) in pixels.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D99022
| Yes
| [[MulticolumnListbox class/ActiveCellPos property|ActiveCellPos]]
|- style="background-color:#FFFFCC;"  
|The coordinate in pixels, relative to the origin of the owning pane, of the top-left position of the active cell(s).
| data-sort-value=416911388 |18D9901C
|R
| [[MulticolumnListbox class/Content Rect Position property|Content Rect Position]]
|X
| The coordinate in pixels, relative to the origin of the owning pane, of the top-left position of the content rectangle of the multicolumn listbox control.
|- style="background-color:#FFFFCC;"
| Read Only
|18D99023
| Yes
| [[MulticolumnListbox class/ActiveCellPosLeft property|ActiveCellPosLeft]]
|- style="background-color:#FFFFCC;"
|The coordinate in pixels, relative to the origin of the owning pane, of the left edge of the active cell.
| data-sort-value=416911389 |18D9901D
 
| [[MulticolumnListbox class/Content Rect Position.Left property|Content Rect Position:Left]]
This property is an element of the Active Cell:Position property.
| The coordinate in pixels, relative to the origin of the owning pane, of the left edge of the content rectangle of the multicolumn listbox control.
|R
| Read Only
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"
|18D99024
| data-sort-value=416911390 |18D9901E
| [[MulticolumnListbox class/ActiveCellPosTop property|ActiveCellPosTop]]
| [[MulticolumnListbox class/Content Rect Position.Top property|Content Rect Position:Top]]
|The coordinate in pixels, relative to the origin of the owning pane, of the top edge of the active cell.
| The coordinate in pixels, relative to the origin of the owning pane, of the top edge of the content rectangle of the multicolumn listbox control.
 
| Read Only
This property is an element of the Active Cell:Position property.
| Yes
|R
|- style="background-color:#FFFFCC;"
|X
| data-sort-value=416911391 |18D9901F
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Content Rect Bounds property|Content Rect Bounds]]
|18D9902F
| The size in pixels of the content rectangle of the multicolumn listbox control.
| Read Only
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911392 |18D99020
| [[MulticolumnListbox class/Content Rect Bounds.Width property|Content Rect Bounds:Width]]
| The width in pixels of the content rectangle of the multicolumn listbox control.
| Read Only
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911393 |18D99021
| [[MulticolumnListbox class/Content Rect Bounds.Height property|Content Rect Bounds:Height]]
| The height in pixels of the content rectangle of the multicolumn listbox control.
| Read Only
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911394 |18D99022
| [[MulticolumnListbox class/Active Cell.Position property|Active Cell:Position]]
| The coordinate in pixels, relative to the origin of the owning pane, of the top-left position of the active cell(s).
| Read Only
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911395 |18D99023
| [[MulticolumnListbox class/Active Cell.Position.Left property|Active Cell:Position:Left]]
| The coordinate in pixels, relative to the origin of the owning pane, of the left edge of the active cell.
| Read Only
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911396 |18D99024
| [[MulticolumnListbox class/Active Cell.Position.Top property|Active Cell:Position:Top]]
| The coordinate in pixels, relative to the origin of the owning pane, of the top edge of the active cell.
| Read Only
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911397 |18D99025
| [[MulticolumnListbox class/Active Cell.Cell Font property|Active Cell:Cell Font]]
| The font of the active cell in the multicolumn listbox control.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911398 |18D99026
| [[MulticolumnListbox class/Active Cell.Cell Font.Name property|Active Cell:Cell Font:Name]]
| The name of the font in the active cell. Predefined font names include <code>App Font</code>, <code>Sys Font</code>, and <code>Dlg Font</code>.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911399 |18D99027
| [[MulticolumnListbox class/Active Cell.Cell Font.Size property|Active Cell:Cell Font:Size]]
| The size of the font in the active cell.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911400 |18D99028
| [[MulticolumnListbox class/Active Cell.Cell Font.Bold property|Active Cell:Cell Font:Bold]]
| Indicates whether the text in the active cell is bold.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911401 |18D99029
| [[MulticolumnListbox class/Active Cell.Cell Font.Italic property|Active Cell:Cell Font:Italic]]
| Indicates whether the text in the active cell is italic.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911402 |18D9902A
| [[MulticolumnListbox class/Active Cell.Cell Font.Underline property|Active Cell:Cell Font:Underline]]
| Indicates whether the text in the active cell is underlined.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911403 |18D9902B
| [[MulticolumnListbox class/Active Cell.Cell Font.Strikeout property|Active Cell:Cell Font:Strikeout]]
| Indicates whether to strike out the text in the active cell.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911404 |18D9902C
| [[MulticolumnListbox class/Active Cell.Cell Font.Color property|Active Cell:Cell Font:Color]]
| The text font color in the active cell.
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911405 |18D9902D
| [[MulticolumnListbox class/Active Cell.Cell Justification property|Active Cell:Cell Justification]]
| Gets and sets the justification of text within a table cell.
| Read/Write
| Yes
|- style="background-color:#FFAAAA;"
| data-sort-value=416911406 |18D9902E
| [[MulticolumnListbox class/Drag/Drop.Allow Dragging (Deprecated) property|Drag/Drop:Allow Dragging (Deprecated)]]
|
| Read/Write
| Yes
|- style="background-color:#FFFFCC;"
| data-sort-value=416911407 |18D9902F
| [[MulticolumnListbox class/Allow Editing Cells property|Allow Editing Cells]]
| [[MulticolumnListbox class/Allow Editing Cells property|Allow Editing Cells]]
|If TRUE, users can edit non-header cells in the multicolumn listbox at run time by clicking the cell text in a selected listbox item. If FALSE, users cannot edit non-header cells.
| If TRUE, users can edit non-header cells in the multicolumn listbox at run time by clicking the cell text in a selected listbox item. If FALSE, users cannot edit non-header cells.
 
| Read/Write
This property is similar to the Editable Cells item on the shortcut menu of a multicolumn listbox.
| Yes
|R/W
|- style="background-color:#FFAAAA;"  
|X
| data-sort-value=416911408 |18D99030
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Old Edit Position property|Old Edit Position]]
|18D99015
|  
| [[MulticolumnListbox class/AutoRowHt property|AutoRowHt]]
| Read/Write
|Determines whether the rows autosize their height to display all text when fonts change or when the number of lines in a cell changes.
| Yes
 
|- style="background-color:#FFFFCC;"  
If FALSE, you can have clipped text in cells, and the user will be unable to manually resize the row height at run time to see all of the text. This property affects only user input. If you use the Value property to set the multicolumn listbox strings, the rows do not automatically resize. To resize the rows, set this property to FALSE and then set it back to TRUE.
| data-sort-value=416911409 |18D99031
 
| [[MulticolumnListbox class/Visible Items.Row Headers Visible property|Visible Items:Row Headers Visible]]
This property is similar to the Autosize Row Height item on the shortcut menu of a multicolumn listbox.
| Shows the row headers.
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#D1BB80;"
|- style="background-color:#FFFFCC;"  
|18D9903E
| data-sort-value=416911410 |18D99032
| [[MulticolumnListbox class/CellBGColors property|CellBGColors]]
| [[MulticolumnListbox class/Row Header Strings() property|Row Header Strings[]]]
|
| An array of the strings in the row headers.
|W
| Read/Write
|X
| Yes
|- style="background-color:#D1BB80;"
|- style="background-color:#CCFFFF;"  
|18D9903F
| data-sort-value=416911411 |18D99033
| [[MulticolumnListbox class/CellFontColors property|CellFontColors]]
| [[MulticolumnListbox class/Is Array? property|Is Array?]]
|
| Returns TRUE if the listbox has an array data type.
|W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99005
| data-sort-value=416911412 |18D99034
| [[MulticolumnListbox class/ColHdrs() property|ColHdrs()]]
| [[MulticolumnListbox class/Keyboard Mode property|Keyboard Mode]]
|An array of the strings in the column headers.
| Sets how to handle upper and lowercase characters when you type characters in a multicolumn listbox at run time. Valid values include 0 (System Default), 1 (Case Sensitive), and 2 (Case Insensitive).
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D9901F
| data-sort-value=416911413 |18D99035
| [[MulticolumnListbox class/ContentRectBounds property|ContentRectBounds]]
| [[MulticolumnListbox class/Visible Items.Vertical Lines Visible property|Visible Items:Vertical Lines Visible]]
|The size in pixels of the content rectangle of the multicolumn listbox control.
| If TRUE, displays vertical lines that separate columns in the multicolumn listbox.
|R
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99021
| data-sort-value=416911414 |18D99036
| [[MulticolumnListbox class/ContentRectBoundsHeight property|ContentRectBoundsHeight]]
| [[MulticolumnListbox class/Visible Items.Horizontal Lines Visible property|Visible Items:Horizontal Lines Visible]]
|The height in pixels of the content rectangle of the multicolumn listbox control.
| If TRUE, displays horizontal lines that separate rows in the multicolumn listbox.
 
| Read/Write
This property is an element of the Content Rect Bounds property.
| Yes
|R
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416911415 |18D99037
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Drag/Drop.Allow Dragging property|Drag/Drop:Allow Dragging]]
|18D99020
| If TRUE, LabVIEW automatically begins a drag and drop operation from the control when you use the Operating tool to select and drag an item from the control.
| [[MulticolumnListbox class/ContentRectBoundsWidth property|ContentRectBoundsWidth]]
| Read/Write
|The width in pixels of the content rectangle of the multicolumn listbox control.
| Yes
 
|- style="background-color:#FFFFCC;"  
This property is an element of the Content Rect Bounds property.
| data-sort-value=416911416 |18D99038
|R
| [[MulticolumnListbox class/Drag/Drop.Allow Dropping property|Drag/Drop:Allow Dropping]]
|X
| If TRUE, LabVIEW automatically accepts drops containing the <code>LV_LISTBOX</code>, <code>LV_TEXT</code>, or <code>LV_LISTBOX_ITEMS</code> data types. The <code>LV_LISTBOX</code> data type is a cluster of the array of strings from the row that you drag data, and a numeric indicating the glyph associated with the row from which you drag. The <code>LV_TEXT</code> data type is of type string. The <code>LV_LISTBOX_ITEMS</code> data type is an array of a cluster containing an array of strings, from left to right, in the item you are dragging and an integer representing the glyph index associated with the item from which you are dragging data.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D9901C
| Yes
| [[MulticolumnListbox class/ContentRectPos property|ContentRectPos]]
|- style="background-color:#FFFFCC;"  
|The coordinate in pixels, relative to the origin of the owning pane, of the top-left position of the content rectangle of the multicolumn listbox control.
| data-sort-value=416911417 |18D99039
|R
| [[MulticolumnListbox class/Drag/Drop.Drag Mode property|Drag/Drop:Drag Mode]]
|X
| Sets the default behavior for a drag and drop operation for the control. The settings apply only when the control configured is the source of the drag and drop operation.
|- style="background-color:#FFFFCC;"
| Read/Write
|18D9901D
| Yes
| [[MulticolumnListbox class/ContentRectPosLeft property|ContentRectPosLeft]]
|- style="background-color:#FFFFCC;"
|The coordinate in pixels, relative to the origin of the owning pane, of the left edge of the content rectangle of the multicolumn listbox control.
| data-sort-value=416911418 |18D9903A
 
| [[MulticolumnListbox class/Drag/Drop.Allow Drag and Drop Outside Control property|Drag/Drop:Allow Drag and Drop Outside Control]]
This property is an element of the Content Rect Position property.
| If TRUE, this enables the control to drag items to other controls and accept drags from other controls.
|R
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#CCFFFF;"
|18D9901E
| data-sort-value=416911419 |18D9903B
| [[MulticolumnListbox class/ContentRectPosTop property|ContentRectPosTop]]
| [[MulticolumnListbox class/Select Entire Rows property|Select Entire Rows]]
|The coordinate in pixels, relative to the origin of the owning pane, of the top edge of the content rectangle of the multicolumn listbox control.
| Highlights the entire row if you select a row in the tree.
 
| Read/Write
This property is an element of the Content Rect Position property.
| Yes
|R
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416911420 |18D9903C
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Edit Position property|Edit Position]]
|18D99002
| The row-column pair index of the current text entry. Values of (0,0) indicate the top-left text entry. A value of -1 indicates the row or column header. Values of (-2, -2) indicate that no edits are being made to the text of the control.
| [[MulticolumnListbox class/DisabledItems property|DisabledItems]]
| Read/Write
|Array of indexes of disabled rows (first row is 0).
| Yes
 
|- style="background-color:#FFFFCC;"  
If you set this property for an item that is not in the listbox, this property returns an error.
| data-sort-value=416911421 |18D9903D
 
| [[MulticolumnListbox class/Focus Row property|Focus Row]]
This property is similar to the Disable Item item on the shortcut menu of a multicolumn listbox.
| The focus row, used as the basis for key navigation such as the up and down arrows.
|R/W
| Read/Write
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D9903A
| data-sort-value=416911422 |18D9903E
| [[MulticolumnListbox class/AllowDragOutsideControl property|AllowDragOutsideControl]]
| [[MulticolumnListbox class/Bulk Cells.Background Colors property|Bulk Cells:Background Colors]]
|If TRUE, this enables the control to drag items to other controls and accept drags from other controls.
| Writes the background colors for a group of cells in the multicolumn listbox.
 
| Write Only
Use the Control events for more control over how users drag items within controls.
| Yes
 
|- style="background-color:#FFFFCC;"  
You can use this property with the Drag/Drop:Allow Dragging and the Drag/Drop:Allow Dropping properties to allow data dragging to other controls and to accept data drops from other controls.
| data-sort-value=416911423 |18D9903F
 
| [[MulticolumnListbox class/Bulk Cells.Font Colors property|Bulk Cells:Font Colors]]
This property is similar to the Allow Drag Drop Outside Control item on the shortcut menu of a multicolumn listbox control.
| Writes the font colors for a group of cells in the multicolumn listbox.
|R/W
| Write Only
|X
| Yes
|- style="background-color:#FFFFCC;"
|18D99037
| [[MulticolumnListbox class/AllowDragging property|AllowDragging]]
|If TRUE, LabVIEW automatically begins a drag and drop operation from the control when you use the Operating tool to select and drag an item from the control.
 
Use the Control events for more control over how users drag items within controls. This property is similar to the Allow Dragging item on the shortcut menu of a multicolumn listbox control.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99038
| [[MulticolumnListbox class/AllowDropping property|AllowDropping]]
|If TRUE, LabVIEW automatically accepts drops containing the LV_LISTBOX, LV_TEXT, or LV_LISTBOX_ITEMS data types. The LV_LISTBOX data type is a cluster of the array of strings from the row that you drag data, and a numeric indicating the glyph associated with the row from which you drag. The LV_TEXT data type is of type string. The LV_LISTBOX_ITEMS data type is an array of a cluster containing an array of strings, from left to right, in the item you are dragging and an integer representing the glyph index associated with the item from which you are dragging data.
 
Use the Control events for more control over how users drag items within controls.
 
This property is similar to the Allow Dropping item on the shortcut menu of a multicolumn listbox control.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99039
| [[MulticolumnListbox class/DragMode property|DragMode]]
|Sets the default behavior for a drag and drop operation for the control. The settings apply only when the control configured is the source of the drag and drop operation.
 
Use the Control events for more control over how users drag items within controls.
 
This property is similar to the Drag Mode item on the shortcut menu of a multicolumn listbox control.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9903C
| [[MulticolumnListbox class/EditPos property|EditPos]]
|The row-column pair index of the current text entry. Values of (0,0) indicate the top-left text entry. A value of &#8211;1 indicates the row or column header. Values of (&#8211;2, &#8211;2) indicate that no edits are being made to the text of the control.
 
Before you use this property to set text focus on a control, set key focus of the control.
 
{| class="wikitable"
|+ scope="col" style="text-align:left;"|Elements:
! scope="col" style="text-align:left;"| Name
! scope="col" style="text-align:left;"| Description
|- style="vertical-align:top;"
! scope="row" style="text-align:left;"|Row
|The row of the  current text entry. Possible values are 0…n, where n is the total number of rows - 1.
|- style="vertical-align:top;"
! scope="row" style="text-align:left;"|Column
|The column of the current text entry. Possible values are 0…m, where m is the total number of columns - 1. Enter &#8211;1 to select the column header.
|}
|}
|R/W
</div></div>
|X
|- style="background-color:#FFFFCC;"
|18D9903D
| [[MulticolumnListbox class/FocusRow property|FocusRow]]
|
|R/W
|X
|- style="background-color:#CCFFFF;"
|18D99033
| [[MulticolumnListbox class/IsArray? property|IsArray?]]
|Returns TRUE if the listbox has an array data type.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99000
| [[MulticolumnListbox class/ItemNames property|ItemNames]]
|The strings for the selectable items in a two-dimensional array for rows and columns.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99001
| [[MulticolumnListbox class/ItemSyms property|ItemSyms]]
|Array of item symbols. Item symbols (0-40) are as shown in the listbox symbol ring constant.
 
This property is similar to the Item Symbols item on the shortcut menu of a listbox.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99034
| [[MulticolumnListbox class/KBrdMode property|KBrdMode]]
|Sets how to handle upper and lowercase characters when you type characters in a multicolumn listbox at run time. Valid values include 0 (System Default), 1 (Case Sensitive), and 2 (Case Insensitive).
 
This property is similar to the Keyboard Mode item on the shortcut menu of a multicolumn listbox.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99017
| [[MulticolumnListbox class/MultilineInput property|MultilineInput]]
|If TRUE, you can enter multiple lines of text in the listbox cells by pressing the  key on the keyboard. If FALSE, pressing the  key on the keyboard while editing cells causes LabVIEW to commit the edits in the current cell and move the text focus to the next cell. This property does not affect run-time behavior of the listbox.
 
This property is similar to the Multi-line Input item on the shortcut menu of a multicolumn listbox.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9900A
| [[MulticolumnListbox class/NumCols property|NumCols]]
|Number of visible columns in the multicolumn listbox. This property counts partially visible columns.
 
If you wire a value of 0 to this property, LabVIEW displays the leftmost column. The listbox resizes according to the number of columns you set.
 
This property is similar to the <b>Columns</b> option on the Appearance page of the <b>Multicolumn Listbox Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99009
| [[MulticolumnListbox class/NumRows property|NumRows]]
|Number of visible rows in the multicolumn listbox, excluding column headers. This property counts partially visible rows.
 
If you wire a value of 0 to this property, LabVIEW displays the topmost row. The multicolumn listbox resizes according to the number of rows you set.
 
This property is similar to the <b>Rows</b> option on the Appearance page of the <b>Multicolumn Listbox Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99032
| [[MulticolumnListbox class/RowHdrs() property|RowHdrs()]]
|An array of the strings in the row headers.
|R/W
|X
|- style="background-color:#CCFFFF;"
|18D9903B
| [[MulticolumnListbox class/SelectEntireRows property|SelectEntireRows]]
|Highlights the entire row if you select a row in the tree.
|R/W
|X
|- style="background-color:#D1BB80;"
|18D99018
| [[MulticolumnListbox class/SelectedCell property|SelectedCell]]
|
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99014
| [[MulticolumnListbox class/SelColor property|SelColor]]
|The color used to highlight the selected items.
 
You can set the color of the front panel object by wiring a hexadecimal number with the form RRGGBB or by wiring the color box constant to the property.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9900D
| [[MulticolumnListbox class/SelMode property|SelMode]]
|Number of items the user can select. Valid values include 0 (zero or one), 1 (one), 2 (zero or more), and 3 (one or more).
 
A single-selection listbox has a scalar data type, and a multiple-selection listbox has an array data type. If you set this property for a single-selection listbox to a value of 2 or 3, LabVIEW returns an error because LabVIEW cannot change the data type from scalar to array at run time.
 
This property is similar to the Selection Mode item on the shortcut menu of a listbox.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99019
| [[MulticolumnListbox class/Size property|Size]]
|The width and height in pixels of the multicolumn listbox control.


This property is similar to the <b>Size Height</b> and <b>Size Width</b> options on the Appearance page of the <b>Properties</b> dialog box.
== Methods ==
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9901B
| [[MulticolumnListbox class/Height property|Height]]
|The height of the active cell(s) in pixels.
 
This property is an element of the Active Cell:Cell Size property.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9901A
| [[MulticolumnListbox class/Width property|Width]]
|The width of the active cell(s) in pixels.
 
This property is an element of the Active Cell:Cell Size property.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99016
| [[MulticolumnListbox class/SmoothHScroll property|SmoothHScroll]]
|If TRUE, the horizontal scrolling of the listbox is by pixels, such that the first column may be horizontally clipped. If FALSE, the listbox scrolls by whole column widths such that the first column is never clipped. However, if a column is wider than the width of the listbox, you cannot see the text that is hidden off the right edge of that column.
 
This property is similar to the <b>Smooth Scrolling</b> item on the shortcut menu of a multicolumn listbox.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9900C
| [[MulticolumnListbox class/TopLeft property|TopLeft]]
|The row and column of the item string displayed in the top left corner of the listbox. Use this property to read or change the top item, or use it to read or change the leftmost column of information displayed.
 
This property returns the row and column of the item string at the top left corner of the visible listbox window, which is not necessarily the top left item of the listbox. To access the top left item, wire a value of (0,0) to the Active Cell property.
 
{| class="wikitable"
|+ scope="col" style="text-align:left;"|Elements:
! scope="col" style="text-align:left;"| Name
! scope="col" style="text-align:left;"| Description
|- style="vertical-align:top;"
! scope="row" style="text-align:left;"|Row
|The row index of the cell displayed in the top left corner of the listbox.
|- style="vertical-align:top;"
! scope="row" style="text-align:left;"|Column
|The column index of the cell displayed in the top left corner of the listbox.
|}
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D9900B
| [[MulticolumnListbox class/ColHdrVis property|ColHdrVis]]
|If TRUE, displays the column headers.
 
This property is similar to the <b>Visible Items&#0187;</b>Column Headers item on the shortcut menu of a multicolumn listbox and the <b>Show column headers</b> option on the Appearance page of the Properties dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99036
| [[MulticolumnListbox class/HorizontalLinesVis property|HorizontalLinesVis]]
|If TRUE, displays horizontal lines that separate rows in the multicolumn listbox.
 
This property is similar to the <b>Visible Items&#0187;</b>Horizontal Lines item on the shortcut menu of a multicolumn listbox and the <b>Show horizontal lines</b> option on the Appearance page of the <b>Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99008
| [[MulticolumnListbox class/HScrollVis property|HScrollVis]]
|If TRUE, displays the horizontal scroll bar.
 
This property is similar to the <b>Visible Items&#0187;</b>Horizontal Scrollbar item on the shortcut menu of a multicolumn listbox and the <b>Show horizontal scroll bar</b> option on the Appearance page of the <b>Multicolumn Listbox Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99031
| [[MulticolumnListbox class/RowHdrVis property|RowHdrVis]]
|Shows the row headers.
 
This property is similar to the <b>Visible Items&#0187;</b>Row Headers item on the shortcut menu of a multicolumn listbox control and to the <b>Show row headers</b> option on the Appearance page of the <b>Multicolumn Listbox Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99006
| [[MulticolumnListbox class/SymbolsVis property|SymbolsVis]]
|If TRUE, displays the item symbols.
 
This property is similar to the Visible Items&#0187;Symbols item on the shortcut menu of a multicolumn listbox and the <b>Show symbols</b> option on the Appearance page of the <b>Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99035
| [[MulticolumnListbox class/VerticalLinesVis property|VerticalLinesVis]]
|If TRUE, displays vertical lines that separate columns in the multicolumn listbox.
 
This property is similar to the <b>Visible Items&#0187;</b>Vertical Lines item on the shortcut menu of a multicolumn listbox and the <b>Show vertical lines</b> option on the Appearance page of the <b>Properties</b> dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|18D99007
| [[MulticolumnListbox class/VScrollVis property|VScrollVis]]
|If TRUE, displays the vertical scroll bar.
 
This property is similar to the <b>Visible Items&#0187;</b>Vertical Scrollbar item on the shortcut menu of a multicolumn listbox and the <b>Show vertical scroll bar</b> option on the Appearance page of the <b>Multicolumn Listbox Properties</b> dialog box.
|R/W
|X
|}
</div>
 
==Methods==
<span class="mw-customtoggle-methodstable">Show/Hide MulticolumnListbox Methods Table</span>
<span class="mw-customtoggle-methodstable">Show/Hide MulticolumnListbox Methods Table</span>
<div class="mw-collapsible" id="mw-customcollapsible-methodstable">
<div class="mw-collapsible" id="mw-customcollapsible-methodstable">
{{VIServerLegend|showrte=TRUE}}
{{VIServerLegend|showrte=TRUE}}
<div style="width: 80%; max-height: 50em; overflow: auto;">
{| class="wikitable sortable"
{| class="wikitable sortable"
|+ MulticolumnListbox Methods Table
|+ MulticolumnListbox Methods Table
! Method ID
! data-sort-type="number"| Property ID
! Short Name (English)
! Long Name (English)
! Description
! Description
! RTE
! RTE  
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99403
| data-sort-value=416912384 |18D99400
| [[MulticolumnListbox class/Custom Item Symbols.Get Symbol method|Custom Item Symbols.Get Symbol]]
| [[MulticolumnListbox class/Get Double-Clicked Row method|Get Double-Clicked Row]]
|Returns the item symbol as a cluster of image data so you can draw it as a picture using the Draw Flattened Pixmap VI or save the image to a file using the Graphics Formats VIs.
| Gets the row number the user double-clicked. The first row on the top is numbered zero. A value of -2 means that no row has been double-clicked. After this method reads the value, it changes the value back to -2. This method does not respond to a double-click on the header.
 
| Yes
The cluster returned by this method is similar to the image data output of the Read JPEG File, Read PNG File, and Read BMP File VIs.
|- style="background-color:#FFFFCC;"  
|X
| data-sort-value=416912385 |18D99401
|- style="background-color:#FFFFCC;"
| [[MulticolumnListbox class/Get Clicked Column Header method|Get Clicked Column Header]]
|18D99404
| Get the column number for which the user clicked the column header. The first column on the left is numbered zero. A value of -2 means that no column header has been clicked. After this function reads the value, it changes the value back to -2.
| [[MulticolumnListbox class/Custom Item Symbols.Get Symbol Array method|Custom Item Symbols.Get Symbol Array]]
| Yes
|Returns the item symbols as an array of clusters of image data so you can draw them as pictures using the Draw Flattened Pixmap VI or save the images to files using the Graphics Formats VIs.
|- style="background-color:#FFFFCC;"  
 
| data-sort-value=416912386 |18D99402
The clusters returned by this method are similar to the image data output of the Read JPEG File, Read PNG File, and Read BMP File VIs.
| [[MulticolumnListbox class/Point to Row Column method|Point to Row Column]]
|X
| Converts a pixel coordinate to a row-column pair in the coordinates of the control. This method also returns whether the point is inside the bounds of the content rectangle and whether the point is within the custom symbol of the cell.
|- style="background-color:#FFFFCC;"
| Yes
|18D99408
|- style="background-color:#FFFFCC;"  
| [[MulticolumnListbox class/Custom Item Symbols.Revert Symbols method|Custom Item Symbols.Revert Symbols]]
| data-sort-value=416912387 |18D99403
|Resets all item symbols to the default symbols.
| [[MulticolumnListbox class/Custom Item Symbols.Get Symbol method|Custom Item Symbols:Get Symbol]]
 
| Returns the item symbol as a cluster of image data so you can draw it as a picture using the [[Draw Flattened Pixmap]] VI or save the image to a file using the [[Graphics Formats]] VIs.
You can use a listbox symbol ring constant to view the default item symbols.
| Yes
|X
|- style="background-color:#FFFFCC;"  
|- style="background-color:#FFFFCC;"
| data-sort-value=416912388 |18D99404
|18D99407
| [[MulticolumnListbox class/Custom Item Symbols.Get Symbol Array method|Custom Item Symbols:Get Symbol Array]]
| [[MulticolumnListbox class/Custom Item Symbols.Revert Symbol method|Custom Item Symbols.Revert Symbol]]
| Returns the item symbols as an array of clusters of image data so you can draw them as pictures using the [[Draw Flattened Pixmap]] VI or save the images to files using the [[Graphics Formats]] VIs.
|Resets an item symbol to the default symbol for its index.
| Yes
|X
|- style="background-color:#FFFFCC;"  
|- style="background-color:#FFFFCC;"
| data-sort-value=416912389 |18D99405
|18D99405
| [[MulticolumnListbox class/Custom Item Symbols.Set To Custom Symbol method|Custom Item Symbols:Set To Custom Symbol]]
| [[MulticolumnListbox class/Custom Item Symbols.Set Symbol method|Custom Item Symbols.Set Symbol]]
| Sets the image of an item symbol.
|Sets the image of an item symbol.
| Yes
 
|- style="background-color:#FFFFCC;"  
If you want to use a picture to set the symbol, use the Picture to Pixmap VI to convert the data to an <b>image data</b> cluster before using this method. The <b>image</b> cluster you wire to this method is similar to the <b>image data</b> input of the Write JPEG File, Write PNG File, and Write BMP File VIs.
| data-sort-value=416912390 |18D99406
|X
| [[MulticolumnListbox class/Custom Item Symbols.Set To Custom Symbol Array method|Custom Item Symbols:Set To Custom Symbol Array]]
|- style="background-color:#FFFFCC;"
| Sets the images of all item symbols.
|18D99406
| Yes
| [[MulticolumnListbox class/Custom Item Symbols.Set Symbol Array method|Custom Item Symbols.Set Symbol Array]]
|- style="background-color:#FFFFCC;"  
|Sets the images of all item symbols.
| data-sort-value=416912391 |18D99407
 
| [[MulticolumnListbox class/Custom Item Symbols.Revert To Built In Symbol method|Custom Item Symbols:Revert To Built In Symbol]]
If you want to use a picture to set the symbols, use the Picture to Pixmap VI to convert the data to an <b>image data</b> cluster before using this method. The <b>image</b> clusters you wire to this method are similar to the <b>image data</b> input of the Write JPEG File, Write PNG File, and Write BMP File VIs.
| Resets an item symbol to the default symbol for its index.
|X
| Yes
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|18D99401
| data-sort-value=416912392 |18D99408
| [[MulticolumnListbox class/Get Clicked Col Hdr method|Get Clicked Col Hdr]]
| [[MulticolumnListbox class/Custom Item Symbols.Revert All To Built In Symbols method|Custom Item Symbols:Revert All To Built In Symbols]]
|Get the column number for which the user clicked the column header. The first column on the left is numbered zero. A value of &#8211;2 means that no column header has been clicked. After this function reads the value, it changes the value back to &#8211;2.
| Resets all item symbols to the default symbols.
|X
| Yes
|- style="background-color:#FFFFCC;"
|18D99400
| [[MulticolumnListbox class/Get DblClk Row method|Get DblClk Row]]
|Gets the row number the user double-clicked. The first row on the top is numbered zero. A value of &#8211;2 means that no row has been double-clicked. After this method reads the value, it changes the value back to &#8211;2. This method does not respond to a double-click on the header.
|X
|- style="background-color:#FFFFCC;"
|18D99402
| [[MulticolumnListbox class/Point To Row Column method|Point To Row Column]]
|Converts a pixel coordinate to a row-column pair in the coordinates of the control. This method also returns whether the point is inside the bounds of the content rectangle and whether the point is within the custom symbol of the cell.
|X
|}
|}
</div>
</div></div>


==Events==
== Events ==
<span class="mw-customtoggle-eventstable">Show/Hide MulticolumnListbox Events Table</span>
<span class="mw-customtoggle-eventstable">Show/Hide MulticolumnListbox Events Table</span>
<div class="mw-collapsible" id="mw-customcollapsible-eventstable">
<div class="mw-collapsible" id="mw-customcollapsible-eventstable">
{{VIServerLegend}}
{{VIServerLegend}}
<div style="width: 80%; max-height: 50em; overflow: auto;">
{| class="wikitable sortable"
{| class="wikitable sortable"
|+ MulticolumnListbox Events Table
|+MulticolumnListbox Events Table
! Code
! data-sort-type="number"| Code
! Name
! Name
! Description
! Type
! Type
|- style="background-color:#FFFFCC;"
|- style="background-color:#FFFFCC;"  
|1073741837
| data-sort-value=4294967295 |1073741837
|[[MulticolumnListbox class/Double Click event|Double Click]]
| [[MulticolumnListbox class/Double Click event|Double Click]]
|Notify
| Generated when a user double-clicks a cell in a multicolumn listbox. LabVIEW does not generate this event if the user double-clicks the scrollbars or the border of the listbox.
|- style="background-color:#FFFFCC;"
| Notify
|1073741880
|- style="background-color:#FFFFCC;"  
|[[MulticolumnListbox class/Edit Cell event|Edit Cell]]
| data-sort-value=4294967295 |1073741880
|Notify
| [[MulticolumnListbox class/Edit Cell event|Edit Cell]]
|- style="background-color:#FFFFCC;"
| Generated when the user enters new text or changes text in a cell.
|2147483703
| Notify
|[[MulticolumnListbox class/Edit Cell? event|Edit Cell?]]
|- style="background-color:#FFFFCC;"  
|Filter
| data-sort-value=4294967295 |2147483703
| [[MulticolumnListbox class/Edit Cell? event|Edit Cell?]]
| Generated when the user enters new text or changes text in a cell but before the new or changed text appears.
| Filter
|}
|}
</div>
</div></div>
 


== History ==
== History ==
{{ambox|text=History information is needed.  What changes have occurred over previous versions?}}
{| class="wikitable"
{| class="wikitable"
! Version
! Version
! Change(s)
! Change(s)
|-
|-
|[[File:LV2018.png|frameless|border|64x64px|LabVIEW 2018|link=LabVIEW 2018]]
|[[File:LV2020.png|frameless|border|64x64px|LabVIEW 2020|link=LabVIEW 2020]]
|More info to come.
| In [[LabVIEW 2020]] the following changes were made:
* The [[MulticolumnListbox class/Selected Cell property|Selected Cell property]] was changed from [[VI Server#Private|Private]] to [[VI Server#Basic Development Environment|Basic Development Environment]]
* The [[MulticolumnListbox class/Bulk Cells.Background Color property|Bulk Cells:Background Color property]] name was changed to [[MulticolumnListbox class/Bulk Cells.Background Colors property|Bulk Cells:Background Colors property]] and was changed from [[VI Server#Private|Private]] to [[VI Server#Basic Development Environment|Basic Development Environment]]
* The [[MulticolumnListbox class/Bulk Cells.Font Color property|Bulk Cells:Font Color property]] name was changed to [[MulticolumnListbox class/Bulk Cells.Font Colors property|Bulk Cells:Font Colors property]] and was changed from [[VI Server#Private|Private]] to [[VI Server#Basic Development Environment|Basic Development Environment]].
|}
|}


Line 660: Line 500:
*[[VI Scripting]]
*[[VI Scripting]]


[[Category:VI Server]]
[[Category:VI Server Class]]
[[Category:VI Server Class]]
[[Category:VI Scripting]]

Latest revision as of 03:57, 17 June 2020

VI Server Class Information
Return to VI Server Class Hierarchy
Class Name MulticolumnListbox class
Class ID 46
Scope Basic Development Environment
Class Inheritance
Class Children

This class has no children.


    This article is a stub. You can help LabVIEW Wiki by expanding it.
    Please improve this article if you can.

    The MulticolumnListbox class is a class in the VI Server Class Hierarchy, (see also VI Server).

    Properties

    Show/Hide MulticolumnListbox Properties Table

    Legend
    R/WReadable/Writable Permissions
    RTEAvailable in the Run-Time Engine
    Basic Development Environment
    VI Scripting
    Private
    Deprecated
    MulticolumnListbox Properties Table
    Property ID Long Name (English) Description R/W RTE
    18D99000 Item Names The strings for the selectable items in a two-dimensional array for rows and columns. Read/Write Yes
    18D99001 Item Symbols Array of item symbols. Item symbols (0-40) are as shown in the listbox symbol ring constant. Read/Write Yes
    18D99002 Disabled Items Array of indexes of disabled rows (first row is 0). Read/Write Yes
    18D99005 Column Header Strings[] An array of the strings in the column headers. Read/Write Yes
    18D99006 Visible Items:Symbols Visible If TRUE, displays the item symbols. Read/Write Yes
    18D99007 Visible Items:Vertical Scrollbar Visible If TRUE, displays the vertical scroll bar. Read/Write Yes
    18D99008 Visible Items:Horizontal Scrollbar Visible If TRUE, displays the horizontal scroll bar. Read/Write Yes
    18D99009 Number of Rows Number of visible rows in the multicolumn listbox, excluding column headers. This property counts partially visible rows. Read/Write Yes
    18D9900A Number of Columns Number of visible columns in the multicolumn listbox. This property counts partially visible columns. Read/Write Yes
    18D9900B Visible Items:Column Headers Visible If TRUE, displays the column headers. Read/Write Yes
    18D9900C Top Left Visible Cell The row and column of the item string displayed in the top left corner of the listbox. Use this property to read or change the top item, or use it to read or change the leftmost column of information displayed. Read/Write Yes
    18D9900D Selection Mode Number of items the user can select. Valid values include 0 (zero or one), 1 (one), 2 (zero or more), and 3 (one or more). Read/Write Yes
    18D9900E Active Cell:Active Cell Sets the row and column of the active cell(s). Read/Write Yes
    18D9900F Active Cell:Cell Foreground Color Read/Write Yes
    18D99010 Active Cell:Cell Background Color The background color of the active cell(s). Read/Write Yes
    18D99011 Active Cell:Cell Size The size of the active cell(s) in pixels. Read/Write Yes
    18D99012 Active Cell:Cell Size:Width The width of the active cell(s) in pixels. Read/Write Yes
    18D99013 Active Cell:Cell Size:Height The height of the active cell(s) in pixels. Read/Write Yes
    18D99014 Selection Color The color used to highlight the selected items. Read/Write Yes
    18D99015 Autosizing Row Height Determines whether the rows autosize their height to display all text when fonts change or when the number of lines in a cell changes. Read/Write Yes
    18D99016 Smooth Horizontal Scrolling If TRUE, the horizontal scrolling of the listbox is by pixels, such that the first column may be horizontally clipped. If FALSE, the listbox scrolls by whole column widths such that the first column is never clipped. However, if a column is wider than the width of the listbox, you cannot see the text that is hidden off the right edge of that column. Read/Write Yes
    18D99017 Multiple Line Input If TRUE, you can enter multiple lines of text in the listbox cells by pressing the <Enter> key on the keyboard. If FALSE, pressing the <Enter> key on the keyboard while editing cells causes LabVIEW to commit the edits in the current cell and move the text focus to the next cell. This property does not affect run-time behavior of the listbox. Read/Write Yes
    18D99018 Selected Cell Reads or writes the row and column of the most recently selected cell in the multicolumn listbox. Read/Write Yes
    18D99019 Size The width and height in pixels of the multicolumn listbox control. Read/Write Yes
    18D9901A Size:Width The width of the active cell(s) in pixels. Read/Write Yes
    18D9901B Size:Height The height of the active cell(s) in pixels. Read/Write Yes
    18D9901C Content Rect Position The coordinate in pixels, relative to the origin of the owning pane, of the top-left position of the content rectangle of the multicolumn listbox control. Read Only Yes
    18D9901D Content Rect Position:Left The coordinate in pixels, relative to the origin of the owning pane, of the left edge of the content rectangle of the multicolumn listbox control. Read Only Yes
    18D9901E Content Rect Position:Top The coordinate in pixels, relative to the origin of the owning pane, of the top edge of the content rectangle of the multicolumn listbox control. Read Only Yes
    18D9901F Content Rect Bounds The size in pixels of the content rectangle of the multicolumn listbox control. Read Only Yes
    18D99020 Content Rect Bounds:Width The width in pixels of the content rectangle of the multicolumn listbox control. Read Only Yes
    18D99021 Content Rect Bounds:Height The height in pixels of the content rectangle of the multicolumn listbox control. Read Only Yes
    18D99022 Active Cell:Position The coordinate in pixels, relative to the origin of the owning pane, of the top-left position of the active cell(s). Read Only Yes
    18D99023 Active Cell:Position:Left The coordinate in pixels, relative to the origin of the owning pane, of the left edge of the active cell. Read Only Yes
    18D99024 Active Cell:Position:Top The coordinate in pixels, relative to the origin of the owning pane, of the top edge of the active cell. Read Only Yes
    18D99025 Active Cell:Cell Font The font of the active cell in the multicolumn listbox control. Read/Write Yes
    18D99026 Active Cell:Cell Font:Name The name of the font in the active cell. Predefined font names include App Font, Sys Font, and Dlg Font. Read/Write Yes
    18D99027 Active Cell:Cell Font:Size The size of the font in the active cell. Read/Write Yes
    18D99028 Active Cell:Cell Font:Bold Indicates whether the text in the active cell is bold. Read/Write Yes
    18D99029 Active Cell:Cell Font:Italic Indicates whether the text in the active cell is italic. Read/Write Yes
    18D9902A Active Cell:Cell Font:Underline Indicates whether the text in the active cell is underlined. Read/Write Yes
    18D9902B Active Cell:Cell Font:Strikeout Indicates whether to strike out the text in the active cell. Read/Write Yes
    18D9902C Active Cell:Cell Font:Color The text font color in the active cell. Read/Write Yes
    18D9902D Active Cell:Cell Justification Gets and sets the justification of text within a table cell. Read/Write Yes
    18D9902E Drag/Drop:Allow Dragging (Deprecated) Read/Write Yes
    18D9902F Allow Editing Cells If TRUE, users can edit non-header cells in the multicolumn listbox at run time by clicking the cell text in a selected listbox item. If FALSE, users cannot edit non-header cells. Read/Write Yes
    18D99030 Old Edit Position Read/Write Yes
    18D99031 Visible Items:Row Headers Visible Shows the row headers. Read/Write Yes
    18D99032 Row Header Strings[] An array of the strings in the row headers. Read/Write Yes
    18D99033 Is Array? Returns TRUE if the listbox has an array data type. Read/Write Yes
    18D99034 Keyboard Mode Sets how to handle upper and lowercase characters when you type characters in a multicolumn listbox at run time. Valid values include 0 (System Default), 1 (Case Sensitive), and 2 (Case Insensitive). Read/Write Yes
    18D99035 Visible Items:Vertical Lines Visible If TRUE, displays vertical lines that separate columns in the multicolumn listbox. Read/Write Yes
    18D99036 Visible Items:Horizontal Lines Visible If TRUE, displays horizontal lines that separate rows in the multicolumn listbox. Read/Write Yes
    18D99037 Drag/Drop:Allow Dragging If TRUE, LabVIEW automatically begins a drag and drop operation from the control when you use the Operating tool to select and drag an item from the control. Read/Write Yes
    18D99038 Drag/Drop:Allow Dropping If TRUE, LabVIEW automatically accepts drops containing the LV_LISTBOX, LV_TEXT, or LV_LISTBOX_ITEMS data types. The LV_LISTBOX data type is a cluster of the array of strings from the row that you drag data, and a numeric indicating the glyph associated with the row from which you drag. The LV_TEXT data type is of type string. The LV_LISTBOX_ITEMS data type is an array of a cluster containing an array of strings, from left to right, in the item you are dragging and an integer representing the glyph index associated with the item from which you are dragging data. Read/Write Yes
    18D99039 Drag/Drop:Drag Mode Sets the default behavior for a drag and drop operation for the control. The settings apply only when the control configured is the source of the drag and drop operation. Read/Write Yes
    18D9903A Drag/Drop:Allow Drag and Drop Outside Control If TRUE, this enables the control to drag items to other controls and accept drags from other controls. Read/Write Yes
    18D9903B Select Entire Rows Highlights the entire row if you select a row in the tree. Read/Write Yes
    18D9903C Edit Position The row-column pair index of the current text entry. Values of (0,0) indicate the top-left text entry. A value of -1 indicates the row or column header. Values of (-2, -2) indicate that no edits are being made to the text of the control. Read/Write Yes
    18D9903D Focus Row The focus row, used as the basis for key navigation such as the up and down arrows. Read/Write Yes
    18D9903E Bulk Cells:Background Colors Writes the background colors for a group of cells in the multicolumn listbox. Write Only Yes
    18D9903F Bulk Cells:Font Colors Writes the font colors for a group of cells in the multicolumn listbox. Write Only Yes

    Methods

    Show/Hide MulticolumnListbox Methods Table

    Legend
    RTEAvailable in the Run-Time Engine
    Basic Development Environment
    VI Scripting
    Private
    Deprecated
    MulticolumnListbox Methods Table
    Property ID Long Name (English) Description RTE
    18D99400 Get Double-Clicked Row Gets the row number the user double-clicked. The first row on the top is numbered zero. A value of -2 means that no row has been double-clicked. After this method reads the value, it changes the value back to -2. This method does not respond to a double-click on the header. Yes
    18D99401 Get Clicked Column Header Get the column number for which the user clicked the column header. The first column on the left is numbered zero. A value of -2 means that no column header has been clicked. After this function reads the value, it changes the value back to -2. Yes
    18D99402 Point to Row Column Converts a pixel coordinate to a row-column pair in the coordinates of the control. This method also returns whether the point is inside the bounds of the content rectangle and whether the point is within the custom symbol of the cell. Yes
    18D99403 Custom Item Symbols:Get Symbol Returns the item symbol as a cluster of image data so you can draw it as a picture using the Draw Flattened Pixmap VI or save the image to a file using the Graphics Formats VIs. Yes
    18D99404 Custom Item Symbols:Get Symbol Array Returns the item symbols as an array of clusters of image data so you can draw them as pictures using the Draw Flattened Pixmap VI or save the images to files using the Graphics Formats VIs. Yes
    18D99405 Custom Item Symbols:Set To Custom Symbol Sets the image of an item symbol. Yes
    18D99406 Custom Item Symbols:Set To Custom Symbol Array Sets the images of all item symbols. Yes
    18D99407 Custom Item Symbols:Revert To Built In Symbol Resets an item symbol to the default symbol for its index. Yes
    18D99408 Custom Item Symbols:Revert All To Built In Symbols Resets all item symbols to the default symbols. Yes

    Events

    Show/Hide MulticolumnListbox Events Table

    Legend
    Basic Development Environment
    VI Scripting
    Private
    Deprecated
    MulticolumnListbox Events Table
    Code Name Description Type
    1073741837 Double Click Generated when a user double-clicks a cell in a multicolumn listbox. LabVIEW does not generate this event if the user double-clicks the scrollbars or the border of the listbox. Notify
    1073741880 Edit Cell Generated when the user enters new text or changes text in a cell. Notify
    2147483703 Edit Cell? Generated when the user enters new text or changes text in a cell but before the new or changed text appears. Filter


    History

    Version Change(s)
    LabVIEW 2020 In LabVIEW 2020 the following changes were made:

    See Also

    Retrieved from "https://labviewwiki.org/w/index.php?title=MulticolumnListbox_class&oldid=28474"