For instance:
- the "currency(value)" displays the column using the current format for the currency ie, 1000 gets displayed as $1,000.00
- the "longdate(date(value))" converts the value to a date and gets the long format to display the date in the column, ie #1/1/2001# displays instead Monday, January 01, 2001
- the "'<b>' + ((0:=proper(value)) left 1) + '</b>' + (=:0 mid 2)" converts the name to proper, so the first letter is capitalized, bolds the first character, and let unchanged the rest, ie a "mihai filimon" gets displayed "Mihai Filimon".
- the "len(value) ? ((0:=dbl(value)) < 10 ? '<fgcolor=808080><font ;7>' : '<b>') + currency(=:0)" displays the cells that contains not empty daya, the value in currency format, with a different font and color for values less than 10, and bolded for those that are greater than 10, as can see in the following screen shot in the column (A+B+C):
The value keyword in the FormatColumn property indicates the value to be formatted.
The expression supports cell's identifiers as follows:
- %0, %1, %2, ...{any} specifies the value of the cell in the column with the index 0, 1 2, ... The CellCaption property defines the cell's value. For example, "%0 format ``" formats the value in the cell at index 0 using the current regional settings, while "int(%1)" converts the value in the cell at index 1 to an integer.
- %C0, %C1, %C2, ...{string} specifies the caption of the cell, or the string the cell displays in the column with the index 0, 1 2, ... The CellCaption property gets the cell's formatted caption. The cell's displayed string may differ from its actual value. For example, if a cell displays HTML content, %0 returns the HTML format including the tags, while %C0 returns the cell's content as a plain string without HTML tags. For instance, "upper(%C1)" converts the caption of the cell at index 1 to uppercase, while "%C0 left 2" returns the leftmost two characters of the caption in the cell at index 0.
- %CD0, %CD1, %CD2, ...{any} specifies the cell's extra data in the column with the index 0, 1 2, ... The CellData property associates any extra/user data to a cell. For example, "%CD0 = your user data" specifies all cells in the column with index 0 whose CellData property is equal to your user data.
- %CS0, %CS1, %CS2, ...{number} specifies the cell's state in the column with the index 0, 1 2, ... The CellState property defines the state of a cell, indicating whether it is checked or unchecked. For example, "%CS0" identifies all checked items in the column with index 0, while "not %CS1" identifies all unchecked items in the column with index 1.
- %CC0, %CC1, %CC2, ... {number} retrieve the number of child items (this keyword consistently returns identical results for all cells since it pertains to the item that hosts each cell). The ChildCount property returns the number of child items. For example, "%CC0" identifies all parent items, while "%CC0 = 0" identifies all leaf items.
- %CX0, %CX1, %CX2, ... {boolean} returns true if the item hosting the cell is expanded, or false if it is collapsed (this keyword consistently returns identical results for all cells since it pertains to the item that hosts each cell). The ExpandItem property specifically indicates whether the item is expanded or collapsed. For example, "%CX0" refers to all expanded items, while "not %CX0" identifies all collapsed items
Other known operators for auto-numbering are:
- number index 'format', indicates the index of the item. The first
added item has the index 0, the second added item has the index 1, and so
on. The index of the item remains the same even if the order of the items
is changed by sorting. For instance, 1 index '' gets the index of the item
starting from 1 while 100 index '' gets the index of the item starting
from 100. The number indicates the starting index, while the format is a
set of characters to be used for specifying the index. If the format is
missing, the index of the item is formatted as numbers. For instance: 1
index 'A-Z' gets the index as A, B, C... Z, BA, BB, ... BZ, CA, ... . The
1 index 'abc' gives the index as: a,b,c,ba,bb,bc,ca,cb,cc,.... You can use
other number formatting function to format the returned value. For
instance "1 index '' format '0||2|:'" gets the numbers grouped
by 2 digits and separated by : character.
In the following screen shot the FormatColumn("Col 1") = "1 index ''"
In the following screen shot the FormatColumn("Col 1") = "1 index 'A-Z'"
- number apos 'format' indicates the absolute position of the item.
The first displayed item has the absolute position 0 ( scrolling position
on top ), the next visible item is 1, and so on. The number
indicates the starting position, while the format is a set of characters
to be used for specifying the position. For instance, 1 apos '' gets the
absolute position of the item starting from 1, while 100 apos '' gets the
position of the item starting from 100. If the format is missing, the
absolute position of the item is formatted as numbers.
In the following screen shot the FormatColumn("Col 1") = "1 apos ''"
In the following screen shot the FormatColumn("Col 1") = "1 apos 'A-Z'"
- number pos 'format' indicates the relative position of the item.
The relative position is the position of the visible child item in the
parent children collection. The number indicates the starting position,
while the format is a set of characters to be used for specifying the
position. For instance, 1 pos '' gets the relative position of the item
starting from 1, while 100 pos '' gets the relative position of the item
starting from 100. If the format is missing, the relative position of the
item is formatted as numbers. The difference between pos and opos can
be seen while filtering the items in the control. For instance, if no
filter is applied to the control, the pos and opos gets the same result.
Instead, if the filter is applied, the opos gets the position of the item
in the list of unfiltered items, while the pos gets the position of the
item in the filtered list.
In the following screen shot the FormatColumn("Col 2") = "'<b>' + 1 pos '' + '</b> ' + value"
In the following screen shot the FormatColumn("Col 2") = "'<b>' + 1 pos 'A-Z' + '</b> ' + value"
- number opos 'format' indicates the relative old position of the item. The relative old position is the position of the child item in the parent children collection. The number indicates the starting position, while the format is a set of characters to be used for specifying the position.For instance, 1 pos '' gets the relative position of the item starting from 1, while 100 pos '' gets the relative position of the item starting from 100. If the format is missing, the relative position of the item is formatted as numbers. The difference between pos and opos can be seen while filtering the items in the control. For instance, if no filter is applied to the control, the pos and opos gets the same result. Instead, if the filter is applied, the opos gets the position of the item in the list of unfiltered items, while the pos gets the position of the item in the filtered list.
- number rpos 'format' indicates the relative recursive position of
the item. The recursive position indicates the position of the parent
items too. The relative position is the position of the visible child item
in the parent children collection. The number indicates the starting
position, while the format is of the following type "delimiter|format|format|...".
If the format is missing, the delimiter is . character, and the positions
are formatted as numbers. The format is applied consecutively to each
parent item, from root to item itself.
In the following screen shot the FormatColumn("Col 1") = "1 rpos ''"
In the following screen shot the FormatColumn("Col 1") = "1 rpos ':|A-Z'"
In the following screen shot the FormatColumn("Col 1") = "1 rpos '.|A-Z|'"
In the following screen shot the FormatColumn("Col 1") = "1 apos ''" and FormatColumn("Col 2") = "'<b><font Tahoma;10>' + 1 rpos '.|A-Z|' + '</font></b> ' + value"
-
number rindex 'format', number rapos 'format' and number ropos 'format' are working similar with number rpos 'format', excepts that they gives the index, absolute position, or the old child position.
This property/method supports predefined constants and operators/functions as described here.
The following VB sample shows how can I display the column using currency:With ComboBox1
.Columns.Add("Currency").FormatColumn = "currency(dbl(value))"
With .Items
.AddItem "1.23"
.AddItem "2.34"
.AddItem "0"
.AddItem 5
.AddItem "10000.99"
End With
End With
The following VB.NET sample shows how can I display the column
using currency:
With AxComboBox1
.Columns.Add("Currency").FormatColumn = "currency(dbl(value))"
With .Items
.AddItem "1.23"
.AddItem "2.34"
.AddItem "0"
.AddItem 5
.AddItem "10000.99"
End With
End With
The following C++ sample shows how can I display the column
using currency:
/*
Copy and paste the following directives to your header file as
it defines the namespace 'EXCOMBOBOXLib' for the library: 'ExComboBox 1.0 Control Library'
#import "C:\\Windows\\System32\\ExComboBox.dll"
using namespace EXCOMBOBOXLib;
*/
EXCOMBOBOXLib::IComboBoxPtr spComboBox1 = GetDlgItem(IDC_COMBOBOX1)->GetControlUnknown();
((EXCOMBOBOXLib::IColumnPtr)(spComboBox1->GetColumns()->Add(L"Currency")))->PutFormatColumn(L"currency(dbl(value))");
EXCOMBOBOXLib::IItemsPtr var_Items = spComboBox1->GetItems();
var_Items->AddItem("1.23");
var_Items->AddItem("2.34");
var_Items->AddItem("0");
var_Items->AddItem(long(5));
var_Items->AddItem("10000.99");
The following C# sample shows how can I display the column using
currency:
(axComboBox1.Columns.Add("Currency") as EXCOMBOBOXLib.Column).FormatColumn = "currency(dbl(value))";
EXCOMBOBOXLib.Items var_Items = axComboBox1.Items;
var_Items.AddItem("1.23");
var_Items.AddItem("2.34");
var_Items.AddItem("0");
var_Items.AddItem(5);
var_Items.AddItem("10000.99");
The following VFP sample shows how can I display the column
using currency:
with thisform.ComboBox1
.Columns.Add("Currency").FormatColumn = "currency(dbl(value))"
with .Items
.AddItem("1.23")
.AddItem("2.34")
.AddItem("0")
.AddItem(5)
.AddItem("10000.99")
endwith
endwith