Welcome to Raosoft SURVEYWin, the powerful software program for information collection, management, and analysis. SURVEYWin’s form designer lets you write your own applications for gathering information. A form consists of many objects: questions, pages, titles, ToolFrames, pictures, and question types. A page is used to arrange the other objects, such as questions, in a logical order. 
You may design several pages in each form, then choose which pages should be used in gathering information.
You will find complete instructions stored electronically in SURVEYWin. Access them by selecting HELP from the menu. When appropriate, you may have a floating tutorial window which will stay on the right side of the screen. As you scroll through it, you can do your work on the left side of the screen.

1.	Create a new project by selecting Project | New from the menu, and type in a new name, “MYFORM” (Do not type the quotes). Click on OK.
2.	Select the defaults in the project setup window by clicking on OK again.
3.	The new project is now active in SURVEYWin. To work on this form, select Form Design from the project window. When the Form Design window appears, a dialog box will ask you if you want help on form design. For now, select No. You can always get help from the Help menu.
4.	You will see a blank window with a white background representing the page. The Add Question window floats above it. When you start, it will have the words “Type here to add a new question” in it..
5.	Highlight the text in the Add Question window, and press Delete to erase it. Type in a new question, “What is your name?” This is the type of question for which you want people to type in their answers.
6.	Select Next from the menu and click on “Write-in text.” A dialog box will pop up to let you customize the question. Set the maximum length to 30, and select “Text single line.” Click on OK in both dialog boxes. In beginner mode, a fieldname will be created automatically. If a dialog box pops up and asks you for a fieldname, accept the default by clicking on the OK button.
7.	Now there is a working edit box in the Add Question window. To place this question on the page, select OK from the Add Question window.
8.	If you want to change the font color for this question, double-click on the first word of the question. This will bring up the Add Question window again. Select Font | Face from the menu to customize the appearance of this question. Make whatever changes you wish, then click on OK to accept the font. If you want to adjust the word-wrapping of the question, resize the Add Question window. Colors will not show up in this window, but they will when the question is on the page. To put this question back on the page, select OK from the menu.
9.	You will now add a new multiple-choice question. Click on the Add Question button at the top of the page, and then type “What is your favorite color?”. 
10.	Select Next from the menu, then select the “Multiple choice” question type. From the drop-down combo box, select “Colors (horizontal),” one of the default question types available in each form. Click on the OK button, then select OK from the menu to put this question on the page.
11.	To reposition the radio buttons, double-click on the first word of the question (to bring it back into the Add Question window). Then, click on the first word of the grayed responses and drag it wherever you want. Select OK from the menu when you’re done.
12.	You now have a working page with two questions on it. Save the page by clicking on the Next page button at the top of the screen. A dialog box will pop up, giving you the opportunity to name your page. Click on OK or press ENTER to accept the default name.
13.	Select File | Save to save your changes. There are several ways to preview the page you just made.
•	Click on the page button  from the toolbar and select Page 1 from the list. To view the page, click on the View button. If you click on the Edit button, you will be able to modify this page.
•	Click on the script button  from the toolbar and click on the Preview form button. You can use this window to rearrange the order in which pages are played back.
•	Close this window by selecting File | Close. Then, in the project window, click on Form Preview. If you instead click on Data Entry, you will be able to store information in an actual database!
14.	Go back to form design and play around with creating questions. Try all the buttons on the toolbar to see what then do, and select Help from the menu for more detailed descriptions. There are several ways to design forms between the Add question window and the object lists (from the toolbar buttons or the menu).
Whenever you want to save your changes, select File | Save in the form design window. If you want to abandon your changes, close the form designer (select File | Close from the window) and request that your changes not be saved.
A database will automatically be created to match your form whenever you add or change questions.

The floating window titled Add question is where you type in new questions or edit questions that are already on the page. To make a new question, click on the New question button at the top of the window. The Add question window will pop up, where you may type in the text for your question. Then, select Next from the local menu to set the type of question. When you have finished this, select OK in the question properties window, then select OK from the local menu.
After you write a question and select OK, your question is applied to the current page. You may move a question within the page by clicking and dragging on the first word of the question.
There are several ways to edit questions. Whenever you add a question, it is added to the master list of questions. This means that you may use this same question on other pages or copy it to other forms.
How to make a new question
1.	Click the mouse inside the question window and type your question. Use the Font menu to change the color, size and typeface of the question.
2.	Either click on Next from the menu, or select a response type from the menu or from the toolbar. Available types include:
	Multiple choice
	Check all that apply
	Ranked scale
	Selecting Multiple choice, Check all that apply, or Ranked  scale will display a list of available responses. To view a response, select it from the list and press the View button, then click anywhere in the new window to return to form design.
	To bring the response into the question box, press Apply. Move the responses to where you want them by clicking on the first response and dragging it within the window.
	Character or number type
	When you select this type or click on its icon, a dialog box will ask you for more information. Your options are 
Single-line text, 
Multi-line text, 
Numbers (but letters may be typed in), 
Numbers only (letters may not be typed, but symbols such as $ and % may). 
You should also type in a maximum length for the response. When you are using the form, up to that number of characters and letters may be typed for responses. Standard lengths are:
Names, Addresses	30 text characters fit on standard address labels
Numbers	8 number digits
State	3 text (some countries have 3-letter state abbreviations)
Postal / Zip code	10 text for zip+4, 14 text for full code in bulk mailing
Social Sec. Num	9 text, not numbers. Don’t type in dashes
Age	3 number digits
Phone	16 text for area code, dashes, and extension or international numbers)
	For other question types (password, date, time), open the list of Question objects and select new. From there, you may use many more question types. To add a question from the list, click on the Apply button.
3.	Position the response area by clicking and dragging on the upper left hand corner of the responses. For edit controls (to change sentence length), position the mouse pointer over the upper left corner and drag the edit box.
4.	Add help, validation, or pictures (optional)
	You may write in help text to assign to particular questions, responses, or pages
5.	Select Apply. In Intermediate or advanced modes, another dialog box will ask you to name your question. This is an alias by which you may refer to the question. For printing scannable forms, the first two words of the alias are used to categorize the questions. You may accept the default name (the question text) or use a shorter name which you will use to refer to this question.
6.	To move the question when it is on the page, click and drag the mouse on the first word of the question.

You can position questions on the page by clicking and dragging on the first word of the question.
To move items within a question, such as responses or edit controls, double-click on the first word of a question to bring it into the Add question window. 
For multiple choice questions, you can click and drag on the upper-left corner of the responses. For character, comment, or number questions, you can click and drag on the upper-left corner of the edit box, as well as resize the edit box.

To select a question from the page, double click on the beginning of the first word of the question. Then, you may edit it as if it were a new question. When you are done with your changes, select OK.
	You may also click on the Question button in the toolbar to see a list of all questions used in your form. Select one of the questions from the list, then click on the Edit button to modify it.
If you select Next from the menu or if you do not select a question type, you will see the Type of question dialog box. 
Use this window to select from the standard question types. First, click on one of the response types. For choice-type responses, select a response type from the drop-down list boxes.
Standard question types
When you select one of these types, another dialog box will allow you to customize the question. For Character and Number types, you will have to choose a maximum length for responses. See the discussion under Writing or modifying a question for examples.
Plain text	Text which will show up on the form, but is not a question
Character	Text write-in or ID numbers.
Number	Numbers on which arithmetic is meaningful.
Date	Can be default-set to the current date. Dates will work after 1999.
Time	Can be default-set to the current time.
Choice questions
For these types of questions, click on the radio button in the dialog box, then select which choice of responses you wish to use from the appropriate list box. To add a new type of response (if you don’t see the one you want in the list), click on the Create new responses button.
Multiple choice	Radio buttons, responses are arbitrary.
Ranking	Radio buttons, responses are given number values.
Check all that apply	Check boxes, responses are arbitrary.
To see how your question will look, click on the Preview button.
Click on OK or Cancel to close this dialog box.
For information on creating new responses, see the next section.
Resizing questions
You can change how a question word-wraps by changing the size of the Add question window. When you resize the window and apply the question to the page, the question will wrap in a box the same size as the Add question window.
Fieldnames and field lengths
A fieldname is the name databases use to keep track of questions. Each question has an alias name and a separate fieldname, not necessarily the same phrase. SURVEYWin automatically creates fieldnames for you, but you may override the default name if you want to match an existing database. Fieldnames are not case sensitive.
The field length is the maximum number of bytes that can be stored as an answer to a question. In SURVEYWin, a field length can be up to 16,000. If you will be using another dBase database to read SURVEYWin files, you should not have any text write-in questions longer than 255.

Each multiple-choice question has a list of possible answers, called response objects. The same response object can be used in more than one question, so that you may standardize the look and feel of your forms. The standard types of response objects are
•	Single response
•	Check all that apply 
•	Ranked scale
All of these replace descriptive phrases with short codes that the computer can recognize. For the question
Which color do you prefer? Red, Green, or Blue?
the computer can use symbols to represent the words “Red,” “Green,” and “Blue.” A single letter can be stored in a database (like R, G, or B), instead of the whole word. The main reason to do this is to save disk space. By using multiple-choice questions instead of text questions (in which someone can type in a color), the database will be about 90% smaller. 
The codes attached to the possible answers are usually arbitrary, starting with A for the first and going through the alphabet. You may always select any code you wish to override the default, if you need codes to be compatible with other databases.
The way codes are assigned is something like this:
How do you commute to work?
A = Car
B = Bus
C = Bicycle
D = Walk
...
The computer uses the letters A, B, C, and D, but always shows you the words Car, Bus, Bicycle, and Walk. The letter codes can be as long as you wish, and may be upper or lower case, or even punctuation symbols (be careful, as some older mainframe databases won’t work with punctuation marks as codes).

	A single response question is a standard multiple-choice question, to which you may only give one answer. You should use this type of response whenever you know what kind of responses people will have. Often, you can add an “Other” response to the end, and then ask for comments with a text write-in question.

	Check all that apply questions can have more than one answer. Each possible answer in a multiple response question increases the size of a database record by one byte.
In intermediate and advanced modes, you can have “Pick the top five...” questions. After you have set up the question and applied it to a page, set the field length (the maximum number of codes which can be stored in a record) to five, the maximum number of answers you want to allow.

	Ranked scale questions are hybrids between number questions and multiple choice question. They are useful for questions whose answers have meaning as a number. When you analyze your results, the computer can calculate averages, standard errors, and other statistics for ranked scale questions. You should use a ranked scale for
•	Questions indicating degrees of agreement, importance, or approval
•	Questions like “On a scale from one to five...”
•	Ranking questions
•	Lickert-style questions
There can also be possible answers which do not have meaning as a number. For example, in the question
Do you agree that the sky is blue? (Select one)
m	Strongly agree
m	Somewhat agree
m	Disagree
m	Strongly disagree
m	No opinion
m	No answer
the first four answers could correspond to the values 4, 3, 2, and 1. The last two, “No option” and “No answer” do not correspond to numbers. They should be given letter codes  such as “X” and “Y.” They will be counted separately in analysis.
It is customary to have the ‘best’ answer have the highest number. Unless you are asking people to pick their first or second choices, it is advantageous to follow this convention. When you are setting up responses, type in the highest code you want for the first possible answer. Then, number values will automatically decrease for each additional possible answer.

This is the response editor window. You will use it to design for Single response, Check all that apply, and Ranked scale responses. To add a new response, click the mouse in the Response value box and type the text for your response. Press Enter to create the response in the layout area.
To move the new response, use the mouse to click and drag it within the layout area. Responses will automatically align to a grid.
You may add a label (descriptive text that is not a possible answer to the question) by clicking in the Label box, typing in the desired label, and pressing Enter.
To edit an item, select it in one of the list boxes (the list on the left for responses, the list on the right for labels). Then make any changes to either the text or the code, click in the Response value box, and press Enter. Your changes will show up immediately.
To save a set of responses, select File | Save from the menu, and type in an alias name. This is the name you will see in the object lists, so it’s a good idea to pick a name which accurately describes the responses. Alias names may be up to 32 characters long.
If you are working within the Add question window or the Edit question dialog box, you may apply these responses to the current question by selecting Apply from the menu. 
You can change the font with the Font menu. Note that Windows does not support colored radio buttons or check boxes.
You can import responses from a SURVEY for DOS (.SUR) file by selecting File | Import a text file from the menu. This will convert text in the form of
A = Response 1
b = Response 2
3 = Response 3
to a SURVEYWin object.
If you want to copy existing text, select File | View a text file and select an ASCII file. This will create a window at the bottom of the screen, with which you may copy and paste text to SURVEYWin.

	The form design window shows a page of questions from your form. You may change pages by clicking on the Previous and Next Page buttons at the top of the screen, or by clicking on the page button from the toolbar.
All the question you place on a page are formatted for the screen. Their location and sizes will scale on different computers, but you can also extend pages as far as you like down and to the right by using the scroll bars.

	A script controls the order in which SURVEYWin will display pages. Using jumps in the form, the script controls the flow of questions that the person entering data sees. Depending on a response to a previous, you can ask different pages of questions to different people.

	Bitmaps (.BMP files) may be placed on your form. Click on the Bitmap icon from the toolbar for a list of all bitmap files in the current directory. Click on the Apply button to apply the picture to the page.

	Standard headings may be applied to the page. This allows you to maintain a consistent heading on every page. If you change a heading object, those changes will be reflected on each page in the form. To create a heading, click on the heading button from the toolbar to bring up the list of heading objects. Click on the New button to make a new heading, then type your text into the window. Use the Font menu to change the typeface, size, and color. The color will not show up in this window, but it will when you apply the heading to a page.

	A ToolFrame is a template of buttons that control flow of electronic forms.  When you create a ToolFrame, you can add several standard buttons to your form. These buttons will be active when the form is running on a computer, but not during form design. If you do not apply a ToolFrame to the page, the buttons Next and Previous will always appear at the bottom.
To create a ToolFrame, click on the ToolFrame button from the toolbar. Click on the New button to open the ToolFrame editor. There, you may add new buttons by double-clicking on them from the list, drag them around on the page, or delete them by dragging them into the delete box.
The available buttons are:
Next	Goes to the next page, or saves and quits at the last page
Previous	Goes to the previous page
OK	Same as Next
Save	Saves entries to the form
Help	Opens the Help window
Abort	Closes the form and quits (does not save to the database)
Top	Goes to the top of the current page
Up	Scrolls the current page up
Down	Scrolls the current page down
These buttons do not scroll when the page beneath scrolls!
Only one ToolFrame can be applied to each page. You can customize the position of the control buttons on the page by editing a ToolFrame.

When you work with a form, you are working with a list of objects. This means that interface elements, like pushbuttons, radio boxes, and text blocks, each know how to behave on the form. What this means for you is that new objects can be put into forms.
SURVEYWin uses a streamed, compound file format that lets any information (including that which hasn’t yet been invented) to be stored in a .FRM file. This means that version 3.0 files will work with all future versions, and future versions’ files will work with SURVEYWin 3.0! This file format allows you to copy objects (such as questions, responses, ToolFrames) from other forms or libraries.
Each object is referenced by an alias. For questions, this alias may be different from the question text. When you browse through the object lists, you are looking at alias names. The toolbar buttons and the Object menu let you see object lists for the current form. When you are looking through object lists, you may:
•	Create a new object
•	Edit the currently selected object
•	View the object in a pop-up window (to make the window go away, click anywhere else on the screen)
•	Apply the object to the current page or to the current question
•	Borrow an object from another form
You can edit an object’s properties by selecting it in a list, and then using the Edit menu commands to rename or delete it.
When you change a question object (bring up the question list, select a question from the list, and click on the Edit button), those changes are made everywhere that question is used in this form. This is useful when you have many multiple-choice questions with similar types of responses, because you can change all of them by changing only one!

To change the alias of an object, click on its object type on the toolbar or use the Object menu to bring up a floating list. Click on the object in the list, then select Edit | Rename from the menu.

To remove an object, click on its object type on the toolbar or use the Object menu to bring up a floating list. In the floating list, click on the alias of the object you wish to remove. You may view that object by clicking on the View button or delete it by selecting Edit | Delete from the menu.

List commands
Apply	Puts the currently selected item in the preview window
View	Creates a new window to look at the selected item
New	Creates a new item
Edit	Edits the selected item
Borrow	Borrow an item from a library or another form

	Each page is associated with a toolbar, a heading, and several questions. To edit a specific page, click on the Page button from the toolbar. A list will pop up, from which you may select a page. Click on the name of a page with the mouse, then click on the Edit button or the Apply button. Then, that page will appear in the form design window, allowing your to change it.

	Questions can be applied to the current page, moved around on the page, and edited.
To add a question, click on New in the question window. To change a question, select it in the list and then click on Edit.
Question types:
Plain text	Text which will show up on the form, but is not a question
Character	Text write-in or ID numbers.
Number	Numbers on which arithmetic is meaningful.
Date	Can be default-set to the current date. Dates will work after 1999.
Time	Can be default-set to the current time.
Multiple choice	Radio buttons, responses are arbitrary.
Ranking	Radio buttons, responses are given number values.
Check all that apply	Check boxes, responses are arbitrary.
Password	Text write-in, but not shown on the screen.
The list of question objects represents every question used in any page in your form. This allows you to prepare standard questions to use on more than one page (or in more than one form). If you use the same question object in several pages, then changes to that question (such as spelling or placement of response items) will be reflected everywhere in the form.
If the question is borrowed by another form, changes you make in this form will affect the question in that form.