prg_log_column_child_dependency_add()
Abstract
Adds a new child dependency to a log column.
Syntax
prg_log_column_child_dependency_add (log_store_hndl, parent_column_title, child_column_title)
| Argument | Type | Description |
|---|---|---|
log_store_hndl |
PrgT_Log_Store_Handle |
Log store of interest. |
parent_column_title |
const char * |
Name of the column to which the dependency is to be added. Must not already be a parent. |
child_column_title |
const char * |
Name of the column to be made dependent. Must not already be a child. |
Return Type
PrgT_Compcode
PrgC_Compcode_Success if the dependency is added successfully; PrgC_Compcode_Failure otherwise.
Header
prg_log.h
Details
A log column can be a child of another column. This dependency is used in the filter tree of the log viewer, where a child column is displayed hierarchically under the parent column. For example, you might want to nest a column titled “sub-class” under a column titled “class”. Parent-child dependencies affect only the filter tree, not the log display.
A column can have no more than one parent and one child.
This function will fail if it would result in a circular dependency, such as that shown in Figure 3.
Figure 3: Circular Dependency Example
