int ReplaceAxisItem (int panelHandle, int controlID, int axis, int itemIndex, char itemLabel[], double itemValue);
Replaces the string/value pair at a specific index in the list of label strings for a graph or strip chart axis. These strings appear in place of the numerical labels. They appear at the location of their associated values on the graph or strip chart.
To see string labels on an x-axis, set the ATTR_XUSE_LABEL_STRINGS attribute to TRUE. To see string labels on a y-axis, set the ATTR_YUSE_LABEL_STRINGS attribute to TRUE.
You can create the original list of label strings in the User Interface Editor or by calling InsertAxisItem.
Input | ||
Name | Type | Description |
panelHandle | integer | Specifier for a particular panel that is currently in memory. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel. |
controlID | integer | The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by NewCtrl or DuplicateCtrl. |
axis | integer | Specifies for which axis to obtain the mode and range. The following lists the valid values: VAL_BOTTOM_XAXIS (graphs only) VAL_TOP_XAXIS (graphs only) VAL_LEFT_YAXIS (graphs and strip charts) VAL_RIGHT_YAXIS (graphs only) |
itemIndex | integer | Zero-based index of the item to replace. |
itemLabel | string | String to replace the existing string in the string/value pair at the specified index. If you pass 0, the existing string is not replaced. Only the first 31 bytes of the string are shown in an axis label. |
itemValue | double-precision | Value to replace the existing value in the string/value pair at the index you specify. The string appears as an axis label at the location of the value. |
Name | Type | Description | ||||
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
|