[Top] [Prev] [Next] [Bottom] [Contents]

SaPopulateNumHotList

 Populates an Anchor with display data and arguments for primary key(s).

Synopsis

#include \Q\QSaRnHtml.h''
void SaPopulateNumHotList(Widget list, 
				XtPointer client_data, 
				SaCallbackStruct
				*cbs);

Arguments

list
Not used.
client_data
Typecast to int, specifies how many primary key columns to use.
cbs
SaCallbackStruct callback structure containing the data.

Return Values

 None.

Description

Populates an Anchor with display data and arguments for primary keys. The client_data is typecast to an integer and used to determine how many primary keys are to be put into the HREF dynamically. These are used as input arguments to the bound Anchor block. The remaining columns are used for display to the user. The primary key(s) must be the first in order. If the Stored Procedure or DSQL Object does not do this for you, you can order the columns by using the Results Detail Dialog. The returned Anchors are numbered sequentially. Spaces are added to align columns. This alignment will only be seen by the HTML user when the site is surrounded by <PRE></PRE> tags. The following fragment shows how to use this call:

##Sa_Authors##<A HREF="http://cezanne/cgi-
bin//popcall.cgi?FNC=authors__Asamp_html">TEMP</A>
Note: The HREF has already been bound as an Activator. The data site, Authors, should be populated with this function. TEMP will be replaced with the display columns. The prime key column(s) are appended to the HREF and will be processed as Arguments by the cgi. This is done for each row.

Example

/** this ad-hoc example can be used without templates **/
SaCallbackStruct *cbs;
cbs = SaExecSQL("CEZANNE", "pubs2", SGESYBASE, 
					"select * from authors");
/*** calls to set the beginning HTML context ***/
SaPopulateNumHotList(NULL, NULL, cbs);
/*** calls to complete the HTML context ***/
SaFreeCbs(cbs);
Note: This call is generated automatically by Sapphire/Web through use of the Results Detail Dialog.

See Also

[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.