|
SourceForge
|
|---|
| Project Page |
|
Powered by
|
|---|
|
|
Presentations are one of the objects provided by the Sinaps system. The grant by which I am employed provides summer training to elementary school teachers on the uses of technology in the classroom. At the end of the course, each teacher, or group of teachers, has a simple web site that they have constructed. The presentations "object" (not in the OOP sense) was designed for storing and presenting relevant meta-information about these sites. Of course, you can certainly store different information in the presentations database. For example, you might use it to catalog live performances by a favorite musician. Or something. The API functions are detailed below. Optional arguments are indicated with italics.
int gDeletePresentation( int id ) :
Deletes the presentation with ID number id from the tables in the presentations database. If no presentation ID is passed to the function, a value of FALSE is returned.
int gDisplayAllPresentations( int count ) :
Displays all of the current presentations in the database in nicely- formatted boxes, with 10 presentations per page. If no count is passed to the function, count defaults to 0.
int gDisplayCurrentPresentation( int id ) :
Displays the current presentation in a nicely-formatted box. If no presentation ID is passed to the function, a value of FALSE is returned.
void gFillCurrentPresentationBox() :
Fills in the "Current Presentation" box on Sinaps pages with the title of the presentation most recently added to the database. The title is a hyperlink that displays the current full presentation when fresentationowed. If no presentation is found in the database, a value of FALSE is returned.
int gGetCurrentOpenPresentationID( int id ) :
Returns the presentation ID number of the presentation most recently added to the presentations database that has a status of "1", which means that the presentation is open for voting. When no parameter is passed in, the current presentation ID is used. The function recurses down through the presentations database until either an open presentation is found or the first presentation in the database is reached. If no open presentation is found in the database, a value of FALSE is returned.
int gGetCurrentPresentationID() :
Returns the presentation ID number of the presentation most recently added to the presentations database. If no presentation is found in the database, a value of FALSE is returned.
int gGetFirstPresentationID() :
Returns the presentation ID number of first presentation added to the presentations database. If no presentation is found in the database, a value of FALSE is returned.
int gGetNewPresentationID() :
Fetches the ID number from the most recent presentation in the database and increments it by one. The incremented number is returned for use as the ID number for the next new presentation. If no presentation is found in the database, a value of "1" is returned.
int gGetNextPresentationID( int id ) :
Returns the presentation ID number of the presentation succeeding presentation id in the database. If no presentation is found in the database, a value of FALSE is returned.
int gGetPresentationArray( int id ) :
Returns all of the columns from the presentations table as a single array. If no presentation ID is passed to the function, a value of FALSE is returned.
int gGetPresentationTitle( int id ) :
Returns the title of the presentation with ID number id in the database. If no presentation is found in the database, a value of FALSE is returned.
int gGetPrevPresentationID( int id ) :
Returns the presentation ID number of the presentation preceding presentation id in the database. If no presentation is found in the database, a value of FALSE is returned.