General Properties
Most objects have properties below:
Name
Specifies the name of the object as referenced in app project.
Use Name to change the name of an object to reflect its purpose in the
current app. By default, the IDE assigns sequential names based on the
type of the object, such as 'Button1', 'Button2', and so on.
DataSet
Set DataSet to the name of an existing dataset object (DBTable or
DBQuery) at design time. At runtime the data from a dataset object is
provided to the object.
FieldName
Specifies the field from which the object displays data.
Access by the object to the dataset in which the field is located is
provided by a DataSet object, specified in the DataSet property.
FontColor
Specifies the color for the Font.
FontSize
The height of the font in points.
FontBold
Determines whether the font is bold or not.
FontItalic
Determines whether the font is italic or not.
FontUnderline
Determines whether the font is underlined or not.
FontStrikeOut
Determines whether the font is displayed with a horizontal line through it or not.
TextAlign (TextHorzAlign and TextVertAlign)
Specifies the text alignment of an object within its parent.
To set the text alignment of an object, set the TextHorzAlign property
for the horizontal axis and the TextVertAlign property for the vertical
axis.
TextAlign can have the following values:
Value Meaning
Center The text is moved to the center of the parent area.
Leading The text is moved to the beginning of the parent area.
Trailing The text is moved to end of the parent area.
TextWordWrap
Specifies whether the text wraps when it is longer than the container area of the object.
Set WordWrap to True to allow displaying multiple lines of a text. When
WordWrap is True, the text that is too long for a container area wraps
at the right margin and continues in additional lines.
Set WordWrap to False for the text to span onto a single line. However,
in this case, the text that is too long for a container area appears
truncated.
Align
Specifies the alignment options (top, left, client, and so on) of the object.
Use Align to automatically set the alignment of the current object.
Setting Align to a value different than None can affect the position,
size (height and width), and anchors of the object. By default, Align
is set to None.
Enabled
Specifies whether the object responds to mouse, keyboard, tap and timer events.
Use Enabled to change the availability of the object to the user. To
disable an object, set Enabled to False. Some disabled objects appear
dimmed (for example: buttons, check boxes, labels), while others
(container objects) simply lose their functionality
without changing their appearance. If Enabled is set to False, the object ignores mouse, keyboard, tap and timer events.
To re-enable an object, set Enabled to True.
Visible
Specifies whether the object appears onscreen.
Use the Visible property to control the visibility of the object at run
time. If Visible is True, the object appears. If Visible is False, the
object is not visible.
Opacity
Specifies the object opacity.
Set Opacity to customize the transparency of the current object.
Opacity takes values between 0 and 1. If Opacity is 1, the object is
completely opaque; if it is 0, the object is completely transparent.
The values over 1 are treated as 1, and the ones under 0 are treated as
0.
Opacity applies to the container object's children.
Tag
Stores a integral value as a part of an object.
Tag has no predefined meaning. The Tag property can store any additional integer value for the convenience of developers.
ScaleX and ScaleY
Specifies the scale of the object.
Set the Scale coordinates to specify the scale on each axis.
The initial scale rate is 1 on each axis.
RotationAngle
Specifies the amount (in degrees) by which the object is rotated from the x-axis at runtime.
Positive angles correspond to clockwise rotation. For counterclockwise rotation, use negative values.
To set the rotation center, use RotationCenterX and RotationCenterY.
RotationCenterX and RotationCenterY
Specifies the position of the pivot point of the object.
The coordinates of the rotation center take values in the range from 0
through 1. The point with the coordinates (0,0) corresponds to the
upper-left corner of the object, the point with the coordinates (1,1)
corresponds to the lower-right corner of the object. The
default center of rotation is (0.5, 0.5).
Values outside of [0,0] and [1,1] are clipped.
Margins (MarginLeft, MarginRight, MarginTop and MarginBottom)
Specifies the object's margins.
The Margins of an object are the distances (in pixels) from each edge
(top, left, bottom, right) to another object within the same Parent or
to the edge of its Parent. Margins adds space to the outer side of the
object.
If a margin is not 0, no other object will come closer to the object
than the specified distance. If the distance from a Parent edge to the
corresponding object edge is smaller than the specified Margins for
that edge, the object is repositioned and resized, if necessary, to
maintain the specified distance.
Padding (PaddingLeft, PaddingRight, PaddingTop and PaddingBottom)
Specifies the object's padding.
The Padding of an container object specifies how close, in pixels, the
container object's children can come to each of its edges (top, left,
bottom, right). Padding adds space to the inner side of the object.
The container object's children are repositioned and resized, if necessary, to maintain the Padding.
The following image shows how Padding and Margins properties affect alignment, position, and size of objects.
StrokeThickness
Specifies the width, in pixels, of the stroke outline to draw a line or a contour.
StrokeColor
Specifies the color of the stroke outline to draw a line or a contour.
FillKind
Determines the pattern for the fill brush.
Use Kind to specify the pattern painted by the brush. Kind can have one of the following values:
Value Meaning
Bitmap The brush's pattern is defined by an external bitmap image.
Gradient The brush's pattern is a gradient and you can set the gradient type and colors.
None The brush has no pattern. The fill of the object is transparent and the Color property has no effect.
Solid The brush's pattern is a solid color, which you can set by using the Color property.
GradientStyle
Determines the style for the gradient object.
Use Style to specify the direction of the gradient.
Style can have one of the following values:
Value Meaning
Linear The gradient is linear (top to bottom, left to right, top-left to bottom-right, etc.)
Radial The gradient is radial (concentric circles, with the center being a given point.)
GradientFirstColor
Specifies the first color of the gradient.
The GradientFirstColor property specifies one of the gradient's colors.
If Style is set to Linear, this would be the top color. If Style is set
to Radial, this would be the exterior color.
GradientSecondColor
Specifies the second color of the gradient.
The GradientSecondColor property specifies one of the gradient's
colors. If Style is set to Linear, this would be the bottom color. If
Style is set to Radial, this would be the interior color.
GradientStartPosition (GradientStartPositionX, GradientStartPositionY)
Specifies the starting point of the gradient.
Use the StartPosition property to specify the starting point of the
gradient. StartPosition is in unit coordinates, from (0,0) in the
top-left to (1,1) in the bottom-right of the rectangle being painted.
Changing the rotation of a linear gradient modifies these coordinates
so that the gradient goes in the desired direction.
Note: The changes made to StartPosition are visible only when the Style property is set to Linear.
GradientStopPosition (GradientStopPositionX, GradientStopPositionY)
Specifies the stopping point of the gradient.
Use the StopPosition property to specify the stopping point of the
gradient. StopPosition is in unit coordinates, from (0,0) in the
top-left to (1,1) in the bottom-right of the rectangle being painted.
Changing the rotation of a linear gradient modifies these coordinates
so that the gradient goes in the desired direction.
Note: The changes made to StopPosition are visible only when the Style property is set to Linear.
FillBitmap
Specifies the external bitmap object that defines a pattern for the fill brush.
Note: To properly use the FillBitmap property, you must set the FillKind property to Bitmap.
FillBitmapWrapMode
Specifies the wrapping mode for creating a fill brush pattern from an image.
The following table lists the possible values for the WrapMode property:
Value Meaning
Tile The image is used repeatedly to tile the area.
TileOriginal The image is used repeatedly at its original size.
TileStretch The image is stretched to fit the area.
Note: To properly use the FillBitmap property, you must set the FillKind property to Bitmap.
Position (Left, Top)
Specifies the upper-left corner of the current object, relative to its parent.
Position can be affected by the Padding of its parent and the Margins of the object.
Size (Width, Height)
Specifies the vertical and horizontal size (Height and Width) of the object (in pixels).
Use the Width and Height properties to read or change the size of the object.
|
|