Step by Step, Example 3, Write Text Box

As example of a Write Text Box, let’s say that we would like to have this - (Look at illustration) - on the screen when using ADPlayer.

To obtain the result we do the following steps with ADWorks.
- Use the command New Source Document or open the document where you want to add the Write Text Box. This description will add the new elements to Document_Ex2.ADsrc and the modified document will be saved with the name Document_Ex3.ADsrc.

Remember: the Document_Ex2.ADsrc is the source file and the icon is represented by a "W". The Document_Ex2.ADcomp is the compiled file and the icon is represented by a "P". These documents are on the CD in the folder Sample/Try This/FolderEx2
- Choose Static Text from the menu Create Element of ADWorks.(See Result)
- Call the definition dialog of that new Static Text (Look and refer to Example 1) (See Result)
- Use Delete All from the Edition of the RTF Editor and type in the text "What is the capital of the United States of America ? Write the answer in the field below and submit it with the Validater menu or simply click on his red button." Select the text you want to color and use the palette to color the selected text. Quit the RTF- Editor with OK (See Result).
- As we do not want accidentally destroy the Document_Ex2.ADsrc we do save our file with the name Document_Ex3.ADsrc

- Choose Write Box from the menu Create Element of ADWorks. (See Result)
- Call the Definition Dialog of the newly created Write Text Box (Click on his button Def.) and define the color and the font of the Box. (See Result with yellow as color and bold for the font).
- Call the Evaluation Dialog of the newly created Write Text Box (Click on his button Eval.) and define the Evaluation table (possible answers for the capital of U.S.) like this. Note: The maximum points chosen on that Illustration is arbitrary.
- Choose Validater from the menu Create Element of ADWorks and link the Write Text Box to the Validater (See Illustration).

The created group can be tested. (Look and refer to Exercise 1). See the Write Text Box under ADPlayer.

Try different answers, some with typing errors and observe the default messages. Use the up and down arrows (See illustration) to look up the trials you made. (With compiled documents the trials are stored in the activity file, *ADact). About messages, About activity file.

We want to create another Write Text Box that looks like this. To obtain the result  we add the following steps with ADWorks.

- Choose Static Text from the menu Create Element of ADWorks. Click his button Def. and define the task. See result ofter OK.
- Select the Write Text Box choose the menu Duplicate with permanent Link (Add to Chain) (Look and refer to Exercise 2). See Result.
There are several advantages to use Duplication with permanent Link:
1) They have the same aspect and they keep the same aspect when 1 element of them is modified.
2) The user recognizes elements with same task with its aspect.
3) They use less memory
- Call the Evaluation Dialog of the created Write Text Box (Click on his button Eval.) and define the Evaluation table (Cities of California with a population of 200'000 ore more in decreasing order : Los Angeles, San Diego, San Francisco, Long Beach, ... , Stockton). A crucial point: Some towns are given in several writings, for instance Los Angeles, frequently abbreviated with "L.A." or "LA". With the colon Group of the Evaluation table we tell the computer that some writings mean the same town. The rule is simple: towns with the same letter in the colon Group are different writings for the same town. If there is a “@” in the colon Group, then the town has no other accepted writing. There was no similar difficulty with the preceding example (Washingten D.C. and Washington DC etc.) for a very simple reason: There was no enumeration. We want to avoid the computer to accept the enumeration 1: L.A. 2: LA 3: Los Angeles ! :)
See now the Evaluation tabel with its 18 items for 12 towns! On the tab Settings of the Evaluation Dialog we will choose the number 3 at Number of repeating fields  and we will choose Order is required at Order of repeating fields . See Illustration. There are three kinds of Order is required. Click at the “?” added to the controller to know more about. Observe that the tab Settings has other controllers of interest. The settings for Initial Display, Standardize and Equality Criteria are quite important. Click at the “?” added to them to know more them. The other settings are for quite advanced topics. It may be of interest to read the yellow INFO panels on the Setting tab. Look at Result after OK. The result shows the repeating fields.

- Choose Validater from the menu Create Element of ADWorks and link these repeating fields to the newly created Validater. (Select the repeating fields and the Validater and click the button Link on the Validater) (See illustration).

The created group can be tested. (Look and refer to Exercise 1).
See the repeating fields of the Write Text Box under ADPlayer.
See a test validations, See another test validation, and another test validation.
As a test: Try “crazy” answers like  San   FranCIScO  with different kind of settings at Eval./Evaluation Settings/Equality Criteria. This test needs to go back to ADWorks (Look and refer to Exercice 1).
As other tests: change the number of repeating fields, change the kind of Order is required and observe the points.

Save the document with the command File/ Save or File/Save as. This will save a source file.
Don’t forget what you should know about compiled files (look at the end of Example 1)

On the CD you find this third example in the folder Sample/Try This/FolderEx3/
The files there are

- Document_Ex3.ADsrc  (the source file; a "W" in the icon)
- Document_Ex3.ADcomp  (the compiled file; a "P" in the icon)
 
About number of characters in Text Write Boxes  and carriage return in Text Write Boxes, see example 15, Dictation.

Back to try this