CAPDM Tutorial Applets

Financial Exchange Line

Functionality:

This appet can help you to familiarise yourself with the concept of shifting resources in time and the impact which borrowing, lending and the interest rate have on present wealth and consumption possibilities in the two time periods.

Remote Control using JavaScript

It is possible to set the independent variable values in the applet and return strings representing individual values or the status of the applet (ie all independent variable values).

Examples

Reset Applet

Show 'About' dialog

Show applet status

Set Period 0 to 500

Set Period 1 to 1200

Set Borrowing to 400

Set Lending to 700

Set Interest Rate to 14%

How to Invoke the Applet

The applet can be invoked by embedding an APPLET tag into your HTML document (if you look at the source of this document you will see a working example you can copy). The table below details the basic parameters used and additional startup parameters that are specific to this applet.

<APPLET 
  CODEBASE="../../../../classes"
  ALT="Financial Exchange Line"
  CODE="applet.capdm.finance.financialexchangeline.FinancialExchangeLineApp" 
  NAME="FinancialExchangeLine"
  WIDTH="400"
  HEIGHT="500">
</APPLET>
Basic Parameters Use
CODEBASE="../../../../classes" The CODEBASE of the applet must point at the top-level classes directory in order for the applet to be found.
CODE="applet.capdm.finance.
financialexchangeline.FinancialExchangeLineApp "		 This required attribute gives the name of the file that contains the applet's compiled Applet subclass. This file is relative to the base URI of the applet.
ALT="Financial Exchange Line" This optional attribute specifies any text that should be displayed if the browser understands the APPLET tag but can't run Java applets.
NAME="FinancialExchangeLine" This optional attribute specifies a name for the applet instance, which makes it possible for applets on the same page to find (and communicate with) each other. If you intend to use JavaScript/Applet scripting then the applet must be named as shown.
WIDTH="400" HEIGHT="500" These required attributes give the initial width and height (in pixels) of the applet display area, not counting any windows or dialogs that the applet brings up.
Applet Startup Parameters Use

For more information on the use of the APPLET tag and other attributes you can use but which are not listed above, visit the W3.org specification page at: APPLET tag in HTML 4.

Runtime Applet API Calls

This applet can be called into using Javascript 1.1 while running. Although JavaScript can call the Applet directly, some convenient JavaScript functions have been created which deal with the details of the communication. The following table lists the call Names which can be made, and gives examples of their use and results.

API Call Name Parameters Use and Result
setValue(name,value) 'name' can be one of "Period0", "Period1", "Borrowing", "Lending", "InterestRate"
'value' is its new value

eg. javascript:document.FinancialExchangeLine.setValue('Period1','1100');

Used to set the value of an independent variable in the applet
getValue() none javascript:document.FinancialExchangeLine.getValue(); Gets the status of the applet
getValue(name) 'name' can be one of "Period0", "Period1", "Borrowing", "Lending", "InterestRate"

eg. javascript:document.FinancialExchangeLine.getValue('Period1');

Returns the current value of the variable from the applet.
getValue(name,dp) 'name' can be one of "Period0", "Period1", "Borrowing", "Lending", "InterestRate"
'dp' is the number of decimal places of accuracy required		 javascript:getValue("Period1",2); Gets the current value of the variable as a string to the number of decimal places specified
showAbout() none javascript:showAbout(); Shows the version dialog box of this applet.
reset() none javascript:reset(); resets the applet to initial starting position