PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • WLanguage properties that can be used with the Rectangle type
  • Assigning a Rectangle variable
  • Assigning an array of Rectangles
  • Comparison and serialization
  • Notes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Rectangle (Type of variable)
In french: Rectangle
A Rectangle variable is a structured type that is used to represent a rectangle (X, Y, Width, Height) in 2 dimensions.
Versions 24 and later
Java This type of variable is now available for the Java applications.
New in version 24
Java This type of variable is now available for the Java applications.
Java This type of variable is now available for the Java applications.
Example
MyRectangle is Rectangle
MyRectangle..X = 280
MyRectangle..Y = 54
MyRectangle..Width = 50
MyRectangle..Height = 150
Syntax

Declaring and initializing a rectangle Hide the details

<Rectangle Name> is Rectangle
<Rectangle Name>:
Name of the Rectangle variable to declare.
Remarks

WLanguage properties that can be used with the Rectangle type

The initial value of a rectangle is set to (0,0,0,0).
The following properties can be used to handle a Rectangle variable:
Property nameEffect
HeightHeight of the rectangle. This coordinate corresponds to a signed 4-byte integer.
WidthWidth of the rectangle. This coordinate corresponds to a signed 4-byte integer.
XX coordinate of the top left point. This coordinate corresponds to a signed 4-byte integer.
YY coordinate of the top left point. This coordinate corresponds to a signed 4-byte integer.

Assigning a Rectangle variable

A Rectangle variable can be assigned with:
  • another Rectangle variable.
    For example:
    MyRectangle is Rectangle
    MyRectangle..X = 280
    MyRectangle..Y = 54
    MyRectangle..Width = 50
    MyRectangle..Height = 150
    MyRectangle1 is Rectangle = MyRectangle
  • an array of four values that can be converted into integer.
    For example:
    MyRectangle is Rectangle
    MyRectangle = [280, 54, 50, 150]
  • two Point variables (corresponding respectively to the top left corner and to the bottom right corner of the rectangle).
    For example:
    MyRectangle is Rectangle
    MyRectangle = [[280, 54], [330, 204]]

Assigning an array of Rectangles

An array of rectangles can be assigned with:
  • an array of values containing rectangles.
    For example:
    ArrayOfRectangles is array of Rectangles
    ArrayOfRectangles = [MyRectangle1, MyRectangle2]
  • an array of four values that can be converted into integer.
    For example:
    ArrayOfRectangles is array of Rectangles
    ArrayOfRectangles = [[1,2,3,4], [5,6,7,8]

Comparison and serialization

  • Comparison: The comparison operators = and <> are available.
  • Serialization: The binary, XML and JSON serializations are available.
    Caution: During an XML serialization, the xmlAttribute constant cannot be used on a Rectangle class member or on a Rectangle structure member.

Notes

  • A Rectangle variable can be stored in a variant.
  • A Rectangle variable is never null:
    • The "RectangleVariable = NULL" condition always returns False.
    • The "RectangleVariable <> NULL" condition always returns True.
  • You cannot reference a Rectangle variable.
    The "RectangleVariable2 <- RectangleVariable1" syntax triggers an error.
  • You cannot force the copy of a Rectangle variable.
    The "RectangleVariable2 <= RectangleVariable1" syntax triggers an error.
  • You have the ability to add a Point variable and a Rectangle variable. This operation is used to perform a relocation of the rectangle.
  • You have the ability to subtract a Point variable to a Rectangle variable. This operation is used to perform a relocation of the rectangle.
  • The Rectangle variables can be passed to the system APIs.
Minimum version required
  • Version 21
This page is also available for…
Comments
Click [Add] to post a comment