Skip to main content

ModifyTable

ModifyTable [/W=winName /Z] [keyword=value, keyword=value, ...]

The ModifyTable operation modifies the appearance of the top or named table window or subwindow.

Parameters

Many of the parameter keywords take an optional columnSpec (abbreviated as col in the synopsis above) enclosed in parentheses. Usually columnSpec is simply the name of a wave displayed in the table. If "(columnSpec)" is omitted, all columns in the table are affected.

More precisely, column specifications are wave names for waves in the current data folder or data folder paths leading to waves in any data folder optionally followed by the suffixes .i, .l, .d, .id or .ld to specify dimension indices, dimension labels, data values, dimension indices and data values, or dimension labels and data values of the wave. For example, ModifyTable font(myWave.i)="Helvetica". If the wave is complex, the column specification may be followed by .real or .imag suffixes.

One additional columnSpec is Point, which refers to the first column containing the dimension index numbers. If multidimensional waves are displayed in the table, this column may have the title "Row", "Column", "Layer", "Chunk" or "Element", but the columnSpec for this column is always Point. See Column Names in the Tables help file for details.

Though not shown in the syntax, the optional "(columnSpec )" may be replaced with "[columnIndex ]", where columnIndex is zero or a positive integer denoting the column to be modified. "[0]" denotes the Point column, "[1]" denotes the first column appended to the table, "[2]" denotes the second appended column, etc. This syntax is used for style macros, in conjunction with the /Z flag.

You can use a range of column numbers instead of just a single column number, for example "[0,3]".

The parameter descriptions below omit the optional "(columnSpec )".

alignment=a
a =0:Left alignment.
a =1:Center alignment.
a =2:Right alignment.
autosize={mode, options, padding, perColumnMaxSeconds, totalMaxSeconds }
Autosizes the specified column or columns.
mode=0:Sets width of each data column from a given multidimensional wave individually.
mode=1:Sets width of all data columns from a given multidimensional wave the same.
options is a bitwise parameter. Usually 0 is the best choice.
bit 0:Ignores column names.
bit 1:Ignores horizontal indices.
bit 2:Ignores data cells.
All other bits are reserved and must be set to zero.
See Setting Bit Parameters for details about bit settings.
padding specifies extra padding for each column in points. Use -1 to get the default amount of padding (16 points).
perColumnMaxSeconds specifies the maximum amount of time to spend autosizing a single column. Use 0 to get the default amount of time (one second).
totalmaxSeconds specifies the maximum amount of time to spend autosizing the entire table. Use 0 to get the default amount of time (ten seconds).
digits=dd is number of digits after decimal point or, for hex and octal columns, the number of total digits.
elements=(row, col, layer, chunk )
Selects the view of a multidimensional wave in the table. The values given to row, col, layer, chunk are codes telling Igor how to change the view.
-1:No change from current view.
-2:Display this dimension vertically.
-3:Display this dimension horizontally.
>=0:For waves with 3 or 4 dimensions, display this element of the other dimensions.
See ModifyTable Elements Command for a detailed discussion of this keyword.
entryMode=mQueries or sets the table's entry line mode.
m =0:Just queries.
m =1:Accepts any entry that was started if possible.
m =2:Cancels any entry that was started if possible.
If m is 0 then the entry line state is not changed but is returned via the V_flag variable as follows:
0:No entry is in progress.
-1:An entry is in progress and is valid.
Other:An entry is in progress and is invalid.
In Igor Pro 8.03 and later, S_value is set to contain the text showing in the entry line.
If m is 1 then the entry is accepted if it is valid and its state is returned via the V_flag variable as follows:
0:No entry is in progress.
-1:The entry was accepted.
Other:The entry is invalid and was not accepted.
In Igor Pro 8.03 and later, S_value is set to contain the text showing in the entry line whether or not an entry was in progress and whether or not it was accepted.
If m is 2 then the entry is cancelled if possible and its state is returned via the V_flag variable as follows:
0:No entry is in progress.
-1:The entry was cancelled.
In Igor Pro 8.03 and later, S_value is set to contain the text showing in the entry line after the entry was cancelled.
font="fontName"Font name (e.g., font="Helvetica").
format=fSets the data format for the table.
f =0:General.
f =1:Integer.
f =2:Integer with thousands (e.g., "1,234").
f =3:Decimal (e.g., "1234.56").
f =4:Decimal with comma (e.g., "1,234.56").
f =5:Scientific (e.g., 1.23456e3).
f =6:Date format.
f =7:Time format (always 24 hour time).
f =8:Date&time format (date followed by time).
f =9:Octal.
f =10:Hexadecimal.
You cannot apply date or date&time formats to a wave that is not double-precision (see Date, Time, and Date&Time Units). To avoid this error, use Redimension to change the wave to double-precision.
frameInset= iSpecifies the number of pixels by which to inset the frame of the table subwindow.
frameStyle= fSpecifies the frame style for a table subwindow. Values for frameStyle are:
f =0:None
f =1:Single
f =2:Double
f =3:Triple
f =4:Shadow
f =5:Indented
f =6:Raised
f =7:Text well
The last three styles are fake 3D and will look good only if the background color of the enclosing space and the table itself is a light shade of gray.
horizontalIndex= hControls what is displayed in the horizontal index row when multidimensional waves are displayed.
h =0:Displays dimension labels if the multidimensional wave's label column is displayed, otherwise displays numeric indices (default).
h =1:Always displays numeric indices for multidimensional waves.
h =2:Always displays dimension labels for multidimensional waves.
The horizontal index row appears below the row of column names if the table contains a multidimensional wave. Use horizontalIndex to override the default behavior in order to display labels for the horizontal dimension while displaying numeric indices for the vertical dimension or vice versa.
The horizontalIndex keyword controls the horizontal index row only. To control what is displayed vertically, append a numeric index or dimension label column using AppendToTable.
rgb=(r,g,b[,a])Sets color of text. r, g, b, and a specify the the color and optional opacity as RGBA Values. The default is opaque black.
selection=(firstRow , firstCol , lastRow , lastCol , targetRow , targetCol )
Sets the selected cells in the table.
If any of the parameters have the value -1 then the corresponding part of the selection is not changed.
Otherwise they set the first and last selected cell and the target cell. Row and column values are 0 oreater. The Point column cannot be selected.
The proposed parameters are clipped to avoid invalid combinations, such as the last selected row being before the first selected row.
With one exception, Igor does not support selecting unused cells. Therefore the proposed selection is clipped to prevent this. The exception is that, if the parameters call for selecting the first cell in the first unused column, then this is permitted.
showFracSeconds=s
s =0:Don't show fractional seconds in time data. (Default)
s =1:""Show fractional seconds in time data.
showParts=partsSpecifies what elements of the table should be visible. Other elements are hidden.
parts is a bitwise parameter specifying what to show.
bit 0:Entry line and other top line controls.
bit 1:Name row.
bit 2:Horizontal index row.
bit 3:Point column.
bit 4:Horizontal scroll bar.
bit 5:Vertical scroll bar.
bit 6:Selection highlighting.
bit 7:Insertion cells.
All other bits are reserved and must be set to zero except that you can pass -1 to indicate that you want to show all parts of the table.
See Setting Bit Parameters for details about bit settings.
Presentation tables in subwindows in graphs and page layouts do not have an entry line or scroll bars and therefore never show these items.
See Parts of a Table and Showing and Hiding Parts of a Table for further information.
sigDigits=dd is number of significant digits when the numeric format is general.
size=sFont size, e.g., size=14.
style=nn is a bitwise parameter with each bit controlling one aspect of the column's font style as follows:
Bit 0:Bold
Bit 1:Italic
Bit 2:Underline
Bit 4:Strikethrough
For example, bold underlined is 20 + 22 = 1 + 4 = 5. See Setting Bit Parameters for details about bit settings.
title="title"Sets the title of a column to title.
topLeftCell=(row , column )
Scrolls the table contents so that the cell identified by (row , column ) is the top/left visible data cell, or as close as possible.
If row is -1 then the table's vertical scrolling is not changed. If column is -1 then the table's horizontal scrolling is not changed.
If they are positive, row and column are zero-based numbers which are clipped to valid values before being used. row =0 refers to the first row of data in the table, column =0 refers to the first column of data.
The Point column cannot be scrolled horizontally.
trailingZeros=tt =1 shows trailing zeros. This affects the general numeric format only.
viewSelectionScrolls the table contents so that the target cell and selection are maximally in view. The target cell will always be visible. The selection may overflow the visible area.
See also the topLeftCell and selection keywords.
viewSelection was added in Igor Pro 9.00.
width=wSets column width to w points.
You will not always get the exact number of points that you request. This is because Igor requires that a column be an even number of screen pixels, so that grid lines look good. Igor will modify your requested number of points to meet this requirement.

Flags

/W= winNameModifies the named table window or subwindow. When omitted, action will affect the active window or subwindow.
When identifying a subwindow with winName, see Subwindow Syntax for details on forming the window hierarchy.
/ZNo errors generated if the indexed or specified column does not exist in a style macro.