-
Notifications
You must be signed in to change notification settings - Fork 1.9k
Add CornerRadius parameter order notes #30930
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR adds important clarification notes to properties that use the CornerRadius type, addressing a documentation gap where the parameter order differs from other frameworks. The main goal is to inform developers that corner radius values should be specified in the order: top left, top right, bottom left, and bottom right.
Key changes include:
- Addition of parameter order notes to all
CornerRadiusproperties across multiple UI components - Migration of XML documentation from external files to inline source code comments
- Modernization of code structure with file-scoped namespaces
Reviewed Changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
src/Controls/src/Core/Shapes/RoundRectangleGeometry.cs |
Replaced XML includes with inline documentation and added corner radius parameter order notes |
src/Controls/src/Core/Shapes/RoundRectangle.cs |
Added inline documentation with corner radius parameter order clarification |
src/Controls/src/Core/ICornerElement.cs |
Converted to file-scoped namespace and added comprehensive interface documentation with parameter order notes |
src/Controls/src/Core/BoxView/BoxView.cs |
Replaced XML includes with inline documentation and added corner radius parameter order notes |
src/Controls/docs/Microsoft.Maui.Controls/BoxView.xml |
Removed external XML documentation file (content moved to source) |
src/Controls/docs/Microsoft.Maui.Controls.Shapes/RoundRectangleGeometry.xml |
Removed external XML documentation file (content moved to source) |
|
This PR adds notes to properties with the
CornerRadiustype. The order of declaring the parameter values is a bit out of line with other frameworks. That is hard to fix (not from a technical standpoint, but from a breaking change perspective) so this is our "fix" for now. Also see: #13136 (comment)Additionally, minor code improvements: move XML into source, file-scope namespace, etc.
Fixes #13136