Introduced ExpandRelated topic query option

The new `TopicQueryOption.ExpandRelated` option allows callers to control whether or not an ExtJs TreePanel bound to a serialized `QueryResultTopicViewModel` should be expanded such that any nodes leading to marked related topics are expanded.

By default, this is enabled if `MarkRelated` is enabled, which in turn is automatically enabled if a `RelatedTopicId` is defined and a `RelatedNamespace` is declared. If `MarkRelated` or `ExpandRelated` are disabled, then it won't be used.

Author: JeremyCaney

OnTopic.Editor.AspNetCore/Infrastructure/TopicQueryService.cs

@@ -101,7 +101,7 @@ private void MapQueryResult(
           topic.GetWebPath(),
           options.EnableCheckboxes ? (options.MarkRelated ? related.Contains(topic) : true) : new bool?(),
           topic.Attributes.GetValue("DisableDelete", "0").Equals("0"),
-          options.MarkRelated && related.Any(r => r.GetUniqueKey().StartsWith(topic.GetUniqueKey(), StringComparison.Ordinal))
+          options.ExpandRelated && related.Any(r => r.GetUniqueKey().StartsWith(topic.GetUniqueKey(), StringComparison.Ordinal))
         );
 
         //Add topic to topic list

OnTopic.Editor.Models/Queryable/TopicQueryOptions.cs

@@ -19,6 +19,7 @@ public class TopicQueryOptions {
     | PRIVATE VARIABLES
     \-------------------------------------------------------------------------------------------------------------------------*/
     bool                        _markRelated                    = false;
+    bool                        _expandRelated                  = true;
     bool                        _showCheckboxes                 = false;
 
     /*==========================================================================================================================
@@ -44,6 +45,7 @@ public TopicQueryOptions() {
       AttributeValue            = null;
       Query                     = null;
       MarkRelated               = false;
+      ExpandRelated             = false;
       RelatedTopicId            = -1;
       RelatedNamespace          = null;
       EnableCheckboxes          = false;
@@ -195,18 +197,33 @@ public bool EnableCheckboxes {
     | MARK RELATED
     \-------------------------------------------------------------------------------------------------------------------------*/
     /// <summary>
-    ///   Determines whether <see cref="QueryResultTopicViewModel"/>s should be marked as <see cref="QueryResultTopicViewModel.IsChecked"/>
-    ///   based on their presence in related topics.
+    ///   Determines whether <see cref="QueryResultTopicViewModel"/>s should be marked as <see cref="QueryResultTopicViewModel.
+    ///   IsChecked"/> based on their presence in related topics.
     /// </summary>
     /// <remarks>
-    ///   This will automatically be set to true is <see cref="RelatedTopicId"/> or <see cref="RelatedNamespace"/> are set. If
+    ///   This will automatically be set to true if <see cref="RelatedTopicId"/> or <see cref="RelatedNamespace"/> are set. If
     ///   <see cref="RelatedTopicId"/> is <i>not</i> set, then the current <see cref="Topic"/> should be assumed.
     /// </remarks>
     public bool MarkRelated {
       get => (RelatedTopicId > 0 || !String.IsNullOrEmpty(RelatedNamespace) || _markRelated);
       set => _markRelated = value;
     }
 
+    /*==========================================================================================================================
+    | EXPAND RELATED
+    \-------------------------------------------------------------------------------------------------------------------------*/
+    /// <summary>
+    ///   Determines whether <see cref="QueryResultTopicViewModel"/>s should be marked ascendants as nodes marked as <see
+    ///   cref="QueryResultTopicViewModel.IsChecked"/> as <see cref="QueryResultTopicViewModel.IsExpanded"/>.
+    /// </summary>
+    /// <remarks>
+    ///   This will automatically be set to true if <see cref="MarkRelated"/> is set to true.
+    /// </remarks>
+    public bool ExpandRelated {
+      get => (MarkRelated && _expandRelated);
+      set => _expandRelated = value;
+    }
+
     /*==========================================================================================================================
     | RELATED TOPIC ID
     \-------------------------------------------------------------------------------------------------------------------------*/