~~Title: OnScriptColumn ~~
<pageheader/>

The **OnScriptColumn** event is the entry point for a [[:scripting:example_scripts:adding_a_new_column|custom column]] added by a [[:scripting:script_add-ins|script add-in]]. The actual name of the event is defined by the script itself, when the command is added via the **[[..:scripting_objects:scriptinitdata|ScriptInitData]].AddColumn** method - **OnScriptColumn** is merely a placeholder name.


<commandtable columns="2" id="cmdtable_1">
$$ (#)**Method Name:**
$$ OnScriptColumn
$$ (#)**Argument Type:**
$$ **[[..:scripting_objects:scriptcolumndata|ScriptColumnData]]** 
$$ (#)**Return Type:**
$$ //none//
$$ (#)**Description:**
$$ When a script add-in adds a new column using **[[..:scripting_objects:scriptinitdata|ScriptInitData]].AddCommand**, it specifies the name of its entry point with the **ScriptColumn.method** property. When Opus wants to retrieve the value of the column for a particular file or folder, Opus will call that method within your script.\\
The **[[..:scripting_objects:scriptcolumndata|ScriptColumnData]].item** property provides information about the file or folder in question, and the **col** property identifies the column you should return data for (in case you use the one method for more than one columns).

The return value from this event is ignored - instead, you should return the column data (and optionally, sorting and grouping information) by setting the appropriate values in the **[[..:scripting_objects:scriptcolumndata|ScriptColumnData]]** object.
</commandtable>