IObjectViewColumns​.ItemByName [Property][Get]

Returns a reference to the column object with the given name from this column's collection.

Defined As

• [VBA] ItemByName(columnName As String) as Object

• [Cicode] OBJECT ItemByName(STRING columnName)

• [C++] ItemByName(STRING columnName, IObjectViewColumn* Item)

Parameters

columnName

[in] Indicates the unique name of the column item to return from this collection.

Execution Results

If the method succeeds, the return value will be Success. If the column cannot be found, the return value will be InvalidArgument.

Calling Syntax

This example assumes there is a valid Columns collection object to be passed into the example methods.

[VBA]

Sub Example(columns As Object)
Dim column As Object
`Getting Property value
Set column = columns.ItemByName("Duration")
End Sub

[Cicode]

FUNCTION Example(OBJECT hColumns)
// Getting property value
OBJECT hColumn = _ObjectCallMethod(hColumns, "get_ItemByName", "Duration");
END