The Ring programming language version 1.5.3 book - Part 17 of 184

1. CHAPTER
FOURTEEN
USING RING NOTEPAD
In this chapter we will learn about using Ring Notepad to write and execute Ring programs quickly
Ring Notepad is just a simple application developed using the Ring language.
14.1 Ring Notepad - Main Window
When we run the Ring Notepad we get the next dockable windows
• Project Files Window : where we can select and open any ring file (*.ring) quickly.
• Source Code Window : Where we write the source code.
• Form Designer Window : The Form Designer to create GUI application forms.
• Web Browser Window : Where we read the documentation or quickly open any website.
• Output Window : Output when we run programs that print to the standard output
• Function Window : List of functions in the current source file
• Classes Window : List of classes in the current source file
135

2. Ring Documentation, Release 1.5.3
14.2 Creating and running your first Console Application
At first we will type the source code
See "Hello, World!"
As in the next image
Then we will click on the “Save” button from the toolbar (or press CTRL+S)
Determine the source code file name and location.
For example type : hello
This will create a new source code file called : hello.ring
14.2. Creating and running your first Console Application 136

3. Ring Documentation, Release 1.5.3
To run the program click on “Debug (Run then wait!)” button from the toolbar
The next screen shot present the application during the runtime
Press Enter to continue and return to the Ring Notepad.
14.2. Creating and running your first Console Application 137

4. Ring Documentation, Release 1.5.3
14.3 Creating and running your first GUI/Mobile Application
To learn how to create GUI applications using Ring check the “Desktop and Mobile development using RingQt”
chapter.
Source Code:
Load "guilib.ring"
New qApp {
new qWidget() {
resize(400,400)
setWindowTitle("Hello, World!")
show()
}
exec()
}
In Ring notepad we have a special button to run GUI applications without displaying the console window.
14.3. Creating and running your first GUI/Mobile Application 138

5. Ring Documentation, Release 1.5.3
The next screen shot present the application during the runtime
14.4 Creating and running your first Web Application
To learn how support Ring in your web server and how to create web applications using Ring check the “Web Devel-
opment (CGI Library)” chapter.
Note: You need to support the Ring language in your web server to be able to run the next example.
Source Code:
14.4. Creating and running your first Web Application 139

6. Ring Documentation, Release 1.5.3
#!b:ringbinring.exe -cgi
load "weblib.ring"
Import System.Web
new page {
text("Hello, World!")
}
We can run the application in any web browser or in the browser that are embedded in Ring Notepad.
14.5 Creating and running your first Desktop/Mobile Game
To learn about creating 2D Games using Ring check the “Demo Project - Game Engine for 2D Games” chapter.
Source Code:
Load "gameengine.ring"
func main
oGame = New Game
{
title = "My First Game"
sprite
{
type = GE_TYPE_PLAYER
x=400 y=400 width=100 height=100
file = "images/player.png"
transparent = true
Animate=false
14.5. Creating and running your first Desktop/Mobile Game 140

7. Ring Documentation, Release 1.5.3
Move=true
Scaled=true
}
}
We can run the application as any GUI application.
14.6 The Main File in the Project
The idea of the Main File ToolBar is to determine the main file in the project When the project contains many source
code files
Using this feature we can run the project (Main File) at any time while opening other files in the project without the
need to switch to the Main File to run the project.
To quickly use this feature
(Open the project main file)
Press Ctrl+Shift+M to set the current source code file as the main file
Open and modify other source code files in the project
To run the project (Main File) at any time press Ctrl+Shift+F5 (GUI) or Ctrl+Shift+D (Console)
Screen Shots:
14.6. The Main File in the Project 141

8. Ring Documentation, Release 1.5.3
14.7 The File Menu
From this menu we can create, open and save the source code files.
Another feature in this menu is “Print to PDF”
14.7. The File Menu 142

9. Ring Documentation, Release 1.5.3
14.8 The Edit Menu
From the Edit menu we can Cut, Copy and Paste text.
Also we can change the font and the colors.
We can Go to a specific line or use the Find and Replace window to find and replace text.
Also We can set the Tab Width (Number of Spaces)
14.9 The View Menu
From this menu we can show/hide the dockable windows
Also we can change the Style of the Ring Notepad
Common Styles are (Fusion White and Modern Black)
14.8. The Edit Menu 143

10. Ring Documentation, Release 1.5.3
14.10 The Program Menu
From this menu we can run the programs
Also we can set the Main file in the project
14.10. The Program Menu 144