Доработан Docking

Lattice.Core.Docking/Models/AutoHidePanel.cs

@@ -5,44 +5,81 @@ namespace Lattice.Core.Docking.Models;
 
 /// <summary>
 /// Представляет автоскрываемую панель, которая может быть прикреплена к одной из сторон окна.
-/// Автоскрываемые панели скрываются, оставляя только заголовок, и появляются при наведении курсора.
+/// Автоскрываемые панели скрываются, оставляя видимой только полоску-заголовок,
+/// и разворачиваются при наведении курсора или клике.
 /// </summary>
 /// <remarks>
-/// Автоскрываемые панели являются ключевым элементом интерфейса современных IDE,
+/// Автоскрываемые панели являются важным элементом современных IDE-подобных приложений,
 /// позволяя экономить пространство экрана при сохранении быстрого доступа к инструментам.
 /// </remarks>
 public class AutoHidePanel : INotifyPropertyChanged
 {
+    /// <summary>
+    /// Происходит при изменении значения свойства.
+    /// </summary>
     public event PropertyChangedEventHandler? PropertyChanged;
-    protected void OnPropertyChanged([CallerMemberName] string? name = null) =>
-        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
 
     private bool _isVisible = false;
     private double _slideOffset = 0;
 
     /// <summary>
-    /// Уникальный идентификатор автоскрываемой панели.
+    /// Получает уникальный идентификатор автоскрываемой панели.
     /// </summary>
+    /// <value>
+    /// Строковый идентификатор, сгенерированный с помощью GUID.
+    /// </value>
     public string Id { get; } = Guid.NewGuid().ToString();
 
     /// <summary>
-    /// Содержимое панели.
+    /// Получает или задает содержимое панели.
     /// </summary>
-    public Abstractions.IDockContent Content { get; set; }
+    /// <value>
+    /// Объект, реализующий <see cref="Abstractions.IDockContent"/>.
+    /// </value>
+    /// <exception cref="ArgumentNullException">
+    /// Выбрасывается при попытке установить значение null.
+    /// </exception>
+    public Abstractions.IDockContent Content
+    {
+        get => _content;
+        set
+        {
+            if (_content != value)
+            {
+                _content = value ?? throw new ArgumentNullException(nameof(value));
+                OnPropertyChanged();
+                OnPropertyChanged(nameof(Title));
+            }
+        }
+    }
+    private Abstractions.IDockContent _content;
 
     /// <summary>
-    /// Сторона окна, к которой прикреплена панель.
+    /// Получает или задает сторону окна, к которой прикреплена панель.
     /// </summary>
+    /// <value>
+    /// Значение перечисления <see cref="DockSide"/>, указывающее сторону прикрепления.
+    /// </value>
     public DockSide Side { get; set; }
 
     /// <summary>
-    /// Ширина панели (для левой/правой сторон) или высота (для верхней/нижней сторон).
+    /// Получает или задает ширину панели (для левой/правой сторон)
+    /// или высоту (для верхней/нижней сторон).
     /// </summary>
+    /// <value>
+    /// Размер панели в пикселях. Значение по умолчанию: 300.
+    /// </value>
     public double Size { get; set; } = 300;
 
     /// <summary>
-    /// Признак видимости панели.
+    /// Получает или задает признак видимости панели.
     /// </summary>
+    /// <value>
+    /// true, если панель развернута и видима; в противном случае false.
+    /// </value>
+    /// <remarks>
+    /// При изменении этого свойства генерируется событие <see cref="PropertyChanged"/>.
+    /// </remarks>
     public bool IsVisible
     {
         get => _isVisible;
@@ -57,8 +94,14 @@ public class AutoHidePanel : INotifyPropertyChanged
     }
 
     /// <summary>
-    /// Смещение для анимации выезда/заезда панели (0-1).
+    /// Получает или задает смещение для анимации выезда/заезда панели.
     /// </summary>
+    /// <value>
+    /// Значение от 0.0 до 1.0, где 0.0 - полностью скрыта, 1.0 - полностью развернута.
+    /// </value>
+    /// <remarks>
+    /// Используется для плавной анимации отображения/скрытия панели.
+    /// </remarks>
     public double SlideOffset
     {
         get => _slideOffset;
@@ -73,15 +116,22 @@ public class AutoHidePanel : INotifyPropertyChanged
     }
 
     /// <summary>
-    /// Заголовок панели (обычно берется из содержимого).
+    /// Получает заголовок панели.
     /// </summary>
+    /// <value>
+    /// Заголовок, взятый из содержимого панели.
+    /// Если содержимое не установлено, возвращает "Auto-hide Panel".
+    /// </value>
     public string Title => Content?.Title ?? "Auto-hide Panel";
 
     /// <summary>
-    /// Инициализирует новый экземпляр автоскрываемой панели.
+    /// Инициализирует новый экземпляр класса <see cref="AutoHidePanel"/>.
     /// </summary>
     /// <param name="content">Содержимое панели.</param>
     /// <param name="side">Сторона окна для прикрепления.</param>
+    /// <exception cref="ArgumentNullException">
+    /// Выбрасывается, когда <paramref name="content"/> равен null.
+    /// </exception>
     public AutoHidePanel(Abstractions.IDockContent content, DockSide side)
     {
         Content = content ?? throw new ArgumentNullException(nameof(content));
@@ -91,6 +141,9 @@ public class AutoHidePanel : INotifyPropertyChanged
     /// <summary>
     /// Переключает видимость панели.
     /// </summary>
+    /// <remarks>
+    /// Если панель была видимой, становится скрытой, и наоборот.
+    /// </remarks>
     public void Toggle()
     {
         IsVisible = !IsVisible;
@@ -111,4 +164,15 @@ public class AutoHidePanel : INotifyPropertyChanged
     {
         IsVisible = false;
     }
-}
+
+    /// <summary>
+    /// Вызывает событие <see cref="PropertyChanged"/>.
+    /// </summary>
+    /// <param name="name">
+    /// Имя изменившегося свойства. Если не указано, определяется автоматически.
+    /// </param>
+    protected void OnPropertyChanged([CallerMemberName] string? name = null)
+    {
+        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
+    }
+}