UICorner
UI modifier which applies deformation to corners of its parent GuiObject.
| Memory category | Instances |
|---|
Member index 1
Description
UICorner is a modifier which applies deformation to corners of its parent
GuiObject. Input, but not descendants, will be clipped to the round
corner area. See
UI appearance modifiers for
examples.
In order to keep the circular shape of round corners, each corner radius (UDim) is internally calculated as follows:
- The radius of the X axis is always the same as the radius of Y axis.
- Scale rounding will always apply to the minimum width or height.
- Rounded rectangles will always be in a "pill" shape if CornerRadius is set to a value that leads to a calculated result greater than half of the rectangle's minimum width or height.
Alternatively to UICorner, rounded corners can be accomplished using
slices which are suitable for decorative borders that are not simply
rounded. See 9‑Slice Design for details.
Note that UICorner can not be applied to a ScrollingFrame.
Individual Corners
Each corner has its own radius property (TopLeftRadius, TopRightRadius, BottomRightRadius, BottomLeftRadius). The CornerRadius property is a convenience shorthand that sets all four corners at once and reads from TopLeftRadius.
When using styling with UICorner, avoid
configuring both CornerRadius and the individual
corner radii in style rules at the same time, as this may produce unexpected
results.
History 5
- 553 Change Default of CornerRadius from to UDim(0, 8)
- 486 Change ThreadSafety of CornerRadius from ReadOnly to ReadSafe
- 462 Change ThreadSafety of CornerRadius from to ReadOnly
- 435 Add CornerRadius
- 435 Add UICorner
Members 1
CornerRadius
| Type | Default | |
|---|---|---|
| UDim | 0, 8 | |
A convenience UDim property that acts as a shorthand for the four individual corner radius properties. Writing to this property sets TopLeftRadius, TopRightRadius, BottomRightRadius, and BottomLeftRadius to the same value. Reading this property returns the value of TopLeftRadius.
| Thread safety | ReadSafe |
|---|---|
| Category | Appearance |
| Loaded/Saved | true |
History 4
- 553 Change Default of CornerRadius from to UDim(0, 8)
- 486 Change ThreadSafety of CornerRadius from ReadOnly to ReadSafe
- 462 Change ThreadSafety of CornerRadius from to ReadOnly
- 435 Add CornerRadius