Sie sind auf Seite 1von 10

Ring Documentation, Release 1.

In the next code for example (from FirstWindowController.ring)


The Open_WindowAndLink() will create an object from the SecondWindowController Class
Then will add the Method : SecondWindow(), IsSecondWindow() Methods to the FirstWindowController Class
Also will add the Method : FirstWindow(), IsFirstWindow() Methods to the SecondWindowController Class
So the SendMessage() method in FirstWindowController class can use the SecondWindow() method to access the
object.
This is more simple than using Last_Window(), Parent() and SetParentObject() methods.
class firstwindowController from windowsControllerParent

oView = new firstwindowView

func OpenSecondWindow
Open_WindowAndLink(:SecondWindowController,self)

func SendMessage
if IsSecondWindow()
SecondWindow().setMessage("Message from the first window")
ok

func setMessage cMessage


oView.Label1.setText(cMessage)

59.4 Open_WindowInPackages() Function

The Open_WindowInPackages() function is the same as Open_Window() but takes an extra list that determine the
packages to import before opening the window.
Syntax:
Open_WindowInPackages(cClassName,aPackagesList)

Example:
The next example from the Form Designer source code, Open the Window Flags window using the
open_windowInPackages() function.
We determine the class name “WindowFlagsController” and the packages name.
The Window Flags window uses the FormDesigner and System.GUI packages.
open_windowInPackages(:WindowFlagsController,[
"formdesigner",
"System.GUI"
])

59.5 Objects Library Source Code

The library source code is very simple, You can check the source code files
• https://github.com/ring-lang/ring/blob/master/extensions/ringqt/objectslib/objects.ring
• https://github.com/ring-lang/ring/blob/master/extensions/ringqt/objectslib/subwindows.ring

59.4. Open_WindowInPackages() Function 703


CHAPTER

SIXTY

USING THE FORM DESIGNER

In this chapter we will learn about using the Form Designer.


We can run the From Designer from Ring Notepad
From the Menubar in Ring Notepad - View Menu - We can Show/Hide the Form Designer window.

Also we can run the Form Designer in another window.


From the Ring Notepad - Tools Menu - Select the Form Designer.

704
Ring Documentation, Release 1.6

60.1 The Designer Windows

• Toolbox : To select controls to be added to the window.


• Properties : To set the properties of the active window or controls.
• Design Region : To select, move and resize the window and the controls.

60.2 The Toolbox

We have many buttons.


• Lock : We can use it to draw many controls of the same type quickly.
• Select : We can use it to select a control in the Design Region
• Controls Buttons : Select a control to be added to the window.

60.3 The Properties

• When we select the window or one control, We will have the selected object properties.
• Also In the properties window we have a combobox to select the active control.
• Some properties provide a button next to the property value. We can click on the button to get more options.
• When we select more than one control, We will have options for multi-selection

60.1. The Designer Windows 705


Ring Documentation, Release 1.6

60.4 Running Forms

When we save the form file (*.rform), The Form Designer will create two Ring files
• The Controller Class
• The View Class
For example, if the form file is helloworld.rform
The form designer will generate two files
• helloworldcontroller.ring
• helloworldview.ring
To run the program, Open the controller class file then click the Run button (CTRL+F5)

Tip: When you open a form using Ring Notepad, the controller class will be opened automatically, So we can press
(CTRL+F5) or click on the Run button while the form designer window is active.

60.5 Events Code

1. Just type the method name in the event property.

60.4. Running Forms 706


Ring Documentation, Release 1.6

(2) Then write the method code in the controller class.

60.5. Events Code 707


Ring Documentation, Release 1.6

In this example we write


func CloseWindow
oView.win.close()

Where inside the controller class, We uses the oView object to access the form.
Another Example :

60.5. Events Code 708


Ring Documentation, Release 1.6

The Event Code


func SayHello
oView {
LineEdit2.setText("Hello "+ LineEdit1.text() )
}

60.6 Keyboard Shortcuts

After selecting one or group of controls


• Use the Arrows (Up, Down, Left and Right) to move them around.
• Shift + the Arrows (Up, Down, Left and Right) to Resize the controls.
• Del button to delete the controls.
• CTRL+SHIFT+V to Duplicate the controls.

60.7 Menubar Designer

From the Window properties we can open the Menubar Designer

60.6. Keyboard Shortcuts 709


Ring Documentation, Release 1.6

60.8 Window Flags

From the Window properties we can open the Window Flags window.

60.8. Window Flags 710


Ring Documentation, Release 1.6

60.9 Entering Items

For some controls like the List Widget we can enter items separated by comma ‘,’

60.10 Using Layouts

1. To use layouts, At first add the layout control to the window.


2. Use the window “Set Layout” property to determine the main layout.
3. From the layout properties determine the controls and the layout type.

60.11 More Samples and Tests

Check the folder : ring/applications/formdesigner/tests


Online : https://github.com/ring-lang/ring/tree/master/applications/formdesigner/tests

60.9. Entering Items 711


CHAPTER

SIXTYONE

SCOPE RULES FOR VARIABLES AND ATTRIBUTES

In this chapter we will learn about scope rules and how Ring find variables.
Also we will learn about conflicts and how to solve/avoid them.
The next information are important once you start developing large applications using Ring
These application may uses
• Global variables (Try to avoid them)
• Classes (Object-Oriented)
• braces { } to access objects
• Declarative Programming
• Natural Programming

61.1 Three Scopes

In Ring we have three scopes :-


1. Public/Global Scope - Each variable you define in the statements part (before functions and classes)
2. Object Scope - When you are inside an object (Inside class method or using { } to access the object )
3. Local Scope - Related to functions and methods

61.2 Defining Variables and Variables Access

1. Ring uses lexical scoping, i.e. the scope of the variable is based on where we defined the variable.
2. Inside braces { } when you access an object, You will change the current active object scope to this object scope
but you still can access the global scope and the local scope.
3. After the ‘Class’ keyword and the class name, when you write variable names to be defined as attributes, You
still can access the global scope.
In this region (class region - after the class name and before methods) we have
• Global Scope —-> The Global Scope
• Object Scope —-> The Object Scope
• Local Scope —-> The Object Scope

712

Das könnte Ihnen auch gefallen