PCL Reference Manual > XY Plot Functions > Post Action
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Post Action
This section is used to describe some of the functions used to implement the “Post” actions.
  
xy_curve_nposted_get
(nposted)
Description:
 
 
This function gets the number of posted curves in the database.
Input:
 
 
None.
 
 
Output:
 
 
INTEGER
nposted
This value returns the number of posted curves found in the database.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
13000063
XY window not found
Example:
Please see xy_curve_nposted_get.
  
xy_curve_posted_get
(posted_list)
Description:
 
 
This function gets the list of posted curves.
Input:
 
 
None.
 
 
Output:
 
 
STRING
posted_list[31]()
This value returns a list of posted curves from the database. This array must be allocated with enough offsets to contain the entire list. Use the function xy_curve_nposted_get() to get the number of offsets required.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
10000011
No memory available for current XY operation.
13000063
XY window not found
13000067
XY curve not found
Example:
Please see xy_curve_posted_get.
  
xy_title_nposted_get
(nposted)
Description:
 
 
This function gets the number of posted titles in the database.
Input:
 
 
None.
 
 
Output:
 
 
INTEGER
nposted
This value returns the number of posted titles found in the database.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
13000063
XY window not found
Example:
Please see xy_title_nposted_get.
  
xy_title_posted_get
(posted_list)
Description:
 
 
This function gets the list of posted titles.
Input:
 
 
None.
 
 
Output:
 
 
STRING
posted_list[256]()
This value returns a list of posted titles from the database. This array must be allocated with enough offsets to contain the entire list. Use the function xy_title_nposted_get() to get the number of offsets required.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
10000011
No memory available for current XY operation.
13000063
XY window not found
13000068
XY title not found
Example:
Please see xy_title_posted_get.
  
xy_window_curve_post
(window_name, curve_name)
Description:
 
 
This function posts a curve to the window.
Input:
 
 
STRING
window_name[31]
This value specifies the name of the window to which the curve will be posted.
STRING
curve_name[31]
This value specifies the name of the curve that is to be posted to the window,
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
10000008
The specified new title name already exists. Please check the listbox of current title names and re-input your title name.
10000104
A current curve has not been defined.
10000105
The specified curve name already exists. Please check the listbox of current curves and re-input your curve name.
10000703
The specified window name already exists.
10000705
There is no current window specified.
13000004
Duplicate entry exists in table
13000063
XY window not found
13000067
XY curve not found
Example:
Please see xy_window_curve_post.
  
xy_window_curve_unpost
(window_name, curve_name)
Description:
 
 
This function unposts a curve to the window.
Input:
 
 
STRING
window_name[31]
This value specifies the name of the window to be created.
STRING
curve_name[31]
This value specifies the name of the curve that is to be unposted from the window,
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
10000104
A current curve has not been defined.
10000705
There is no current window specified.
13000063
XY window not found
13000067
XY curve not found
Example:
Please see xy_window_curve_unpost.
  
xy_window_title_post
(window_name, title_name)
Description:
 
 
This function posts a title to the window.
Input:
 
 
STRING
window_name[31]
This value specifies the name of the window to which the title will be posted.
STRING
title_name[256]
This value specifies the name of the title that is to be posted to the window.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
10000101
The specified title does not exist in the database.
10000705
There is no current window specified.
13000004
Duplicate entry exists in table
13000063
XY window not found
13000068
XY title not found
Example:
Please see xy_window_title_post.
  
xy_window_title_unpost
(window_name, title_name)
Description:
 
 
This function unposts a title to the window.
Input:
 
 
STRING
window_name[31]
This value specifies the name of the window from which the title will be unposted.
STRING
title_name[256]
This value specifies the name of the title that is to be unposted from the window.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
10000101
The specified title does not exist in the database.
10000705
There is no current window specified.
13000063
XY window not found
13000068
XY title not found
Example:
Please see xy_window_title_unpost.