diff --git a/src/Avalonia.Controls/DateTimePickers/TimePicker.cs b/src/Avalonia.Controls/DateTimePickers/TimePicker.cs
index e4ff5e9e5b..d0cf772c01 100644
--- a/src/Avalonia.Controls/DateTimePickers/TimePicker.cs
+++ b/src/Avalonia.Controls/DateTimePickers/TimePicker.cs
@@ -8,7 +8,7 @@ using System.Globalization;
namespace Avalonia.Controls
{
///
- /// A control to allow the user to select a time
+ /// A control to allow the user to select a time.
///
[PseudoClasses(":hasnotime")]
public class TimePicker : TemplatedControl
diff --git a/src/Avalonia.Controls/Expander.cs b/src/Avalonia.Controls/Expander.cs
index 9ff2e41fa9..052b42a233 100644
--- a/src/Avalonia.Controls/Expander.cs
+++ b/src/Avalonia.Controls/Expander.cs
@@ -4,14 +4,35 @@ using Avalonia.Controls.Primitives;
namespace Avalonia.Controls
{
+ ///
+ /// Direction in which an control opens.
+ ///
public enum ExpandDirection
{
+ ///
+ /// Opens down.
+ ///
Down,
+
+ ///
+ /// Opens up.
+ ///
Up,
+
+ ///
+ /// Opens left.
+ ///
Left,
+
+ ///
+ /// Opens right.
+ ///
Right
}
+ ///
+ /// A control with a header that has a collapsible content section.
+ ///
[PseudoClasses(":expanded", ":up", ":down", ":left", ":right")]
public class Expander : HeaderedContentControl
{
diff --git a/src/Avalonia.Controls/Grid.cs b/src/Avalonia.Controls/Grid.cs
index 105a2744e5..c7d598006d 100644
--- a/src/Avalonia.Controls/Grid.cs
+++ b/src/Avalonia.Controls/Grid.cs
@@ -17,7 +17,7 @@ using Avalonia.VisualTree;
namespace Avalonia.Controls
{
///
- /// Grid
+ /// Defines a flexible grid area that consists of columns and rows.
///
public class Grid : Panel
{
diff --git a/src/Avalonia.Controls/Primitives/ScrollBarVisibility.cs b/src/Avalonia.Controls/Primitives/ScrollBarVisibility.cs
index 90727a3505..e62e087140 100644
--- a/src/Avalonia.Controls/Primitives/ScrollBarVisibility.cs
+++ b/src/Avalonia.Controls/Primitives/ScrollBarVisibility.cs
@@ -1,10 +1,28 @@
namespace Avalonia.Controls.Primitives
{
+ ///
+ /// Specifies the visibility of a for scrollable content.
+ ///
public enum ScrollBarVisibility
{
+ ///
+ /// No scrollbars and no scrolling in this dimension.
+ ///
Disabled,
+
+ ///
+ /// The scrollbar should be visible only if there is more content than fits in the viewport.
+ ///
Auto,
+
+ ///
+ /// The scrollbar should never be visible. No space should ever be reserved for the scrollbar.
+ ///
Hidden,
+
+ ///
+ /// The scrollbar should always be visible. Space should always be reserved for the scrollbar.
+ ///
Visible,
}
}
diff --git a/src/Avalonia.Controls/RadioButton.cs b/src/Avalonia.Controls/RadioButton.cs
index 4bda241497..681278d247 100644
--- a/src/Avalonia.Controls/RadioButton.cs
+++ b/src/Avalonia.Controls/RadioButton.cs
@@ -8,6 +8,9 @@ using Avalonia.VisualTree;
namespace Avalonia.Controls
{
+ ///
+ /// Represents a button that allows a user to select a single option from a group of options.
+ ///
public class RadioButton : ToggleButton
{
private class RadioButtonGroupManager
diff --git a/src/Avalonia.Controls/RelativePanel.cs b/src/Avalonia.Controls/RelativePanel.cs
index 2305d8fb9e..c5de004f09 100644
--- a/src/Avalonia.Controls/RelativePanel.cs
+++ b/src/Avalonia.Controls/RelativePanel.cs
@@ -8,6 +8,9 @@ using Avalonia.Layout;
namespace Avalonia.Controls
{
+ ///
+ /// Defines an area within which you can position and align child objects in relation to each other or the parent panel.
+ ///
public partial class RelativePanel : Panel
{
private readonly Graph _childGraph;
diff --git a/src/Avalonia.Controls/RepeatButton.cs b/src/Avalonia.Controls/RepeatButton.cs
index fcd6607feb..ba770634d9 100644
--- a/src/Avalonia.Controls/RepeatButton.cs
+++ b/src/Avalonia.Controls/RepeatButton.cs
@@ -4,6 +4,9 @@ using Avalonia.Threading;
namespace Avalonia.Controls
{
+ ///
+ /// Represents a control that raises its event repeatedly when it is pressed and held.
+ ///
public class RepeatButton : Button
{
///
diff --git a/src/Avalonia.Controls/TextBox.cs b/src/Avalonia.Controls/TextBox.cs
index 69da667011..42030c2860 100644
--- a/src/Avalonia.Controls/TextBox.cs
+++ b/src/Avalonia.Controls/TextBox.cs
@@ -17,6 +17,9 @@ using Avalonia.Controls.Metadata;
namespace Avalonia.Controls
{
+ ///
+ /// Represents a control that can be used to display or edit unformatted text.
+ ///
[PseudoClasses(":empty")]
public class TextBox : TemplatedControl, UndoRedoHelper.IUndoRedoHost
{