Rik's Treehouse > Babbling in Binary > My Software > Orphanware > R2DToo > R2DToo Help > For the Programmer > getModelAbout

getModelAbout

Declaration
Parameters
Return Value
Remarks
Revisions
Example
See Also

Declaration

char* __stdcall getModelAbout(
	int line	// indicates what information to return
);
Top of page

Parameters

line
One of the following values (defined in api2model.h):
amName
model name
amVersion
model version information
amCopyright
author's name and/or copyright
amComments
extra comments
amUrl
uniform resource locator (web address) for model
Top of page

Return Value

A character string returning the appropriate information, depending on the line parameter. If the value of line is not recognized a default empty string ("") should be returned (for compatibility with future versions of the API which may ask for more information). Top of page

Remarks

This optional function may be provided by the model. For each possible value of the parameter the function should return a character string indicating the appropriate information. The data is formatted and displayed in R2DToo's "About the Model" dialog box.
Top of page

Revisions

API v1.5
  • renamed from aboutModel.
Top of page

Example

char* __stdcall getModelAbout(int line) { switch (line) { case amName: return "My model's name"; case amVersion: return "Version 1.0"; case amCopyright: return "by Me, Myself and I"; case amComments: return ""; case amUrl: return "http://www.zoology.ubc.ca/~rikblok/"; default: return ""; // for compatibility with future versions } }
Top of page

See Also

getParamAbout, getAgentAbout.
Top of page
[Rik's Office Hours] [Contact Rik]
Last updated: Fri Apr 30 2004, 1:38pm