IA4HierarchyFolder::GetColumnInfo

Purpose

Returns a data structure that describes the columns needed to display the contents of a particular folder in a details view. This is an optional member function.

Syntax

HRESULT STDMETHODCALLTYPE GetColumnInfo(
    LPVOID* ppvInfo
    );

Parameters

ppvInfo

The returned data structure. The returned structure should consist of an instance of the A4hyfColumnInfo structure. This structure contains an array of A4hyfColumnItem structures, one for each column in the list view.

Each column item structure supplies the translated string for the column heading, the default width of the column, and an integer value that uniquely identifies the data field that supplies data for the column. Refer to CWBA4HYF.H.

Return Codes

Returns NOERROR if successful or E_NOTIMPL if unable to implement the function.

Comments

iSeries™ Navigator calls this function after the call to Open has returned, to create the column headings for a details view.

If this function is not implemented, the Navigator will insert two columns: Name and Description. GetColumnDataItem must be capable of returning data for these two fields, which are identified with integer values of 0 and 1, respectively.

Use the Windows® IMalloc interface to allocate memory for the returned structures. The Navigator will be responsible for deleting this memory.