IObjectViewColumns.Add [Method]

Adds a visible custom column to the ObjectView.

Defined As

• [VBA] Add(name As String, DisplayText As String, Width As Long)
• [Cicode] Add(STRING name, STRING DisplayText, INT Width)
• [C++] HRESULT Add (BSTR name, BSTR text, int width)

Parameters

name

[in] The string ID uniquely identifying this column (1-64).

text

[in] The title to be displayed in the column header (0-256).

width

[in] The width of this column in pixels (0-1000).

Execution Result

If the method succeeds, the return value will be Success. If an argument is out of range, the return value will be InvalidArgument. If the column cannot be added, the return value is GeneralFailure.

See Also

OVColumnAdded [Event]

Calling Syntax

This example assumes there is a valid Columns collection as retrieved from an ObjectView. (for example, VBA: objectView.Columns).

[VBA]

Sub Example(Columns As Object)

	 Columns.Add "NameID", "New Column", 120;

End Sub

[Cicode]

FUNCTION Example(OBJECT hColumns)

  _ObjectCallMethod(hColumns, "Add", "NameID", "New Column", 120);

END