assets/samples/Samples/DockableDialogs/CS/APIUtility/APIUtility.cs

//
// (C) Copyright 2003-2019 by Autodesk, Inc.
//
// Permission to use, copy, modify, and distribute this software in
// object code form for any purpose and without fee is hereby granted,
// provided that the above copyright notice appears in all copies and
// that both that copyright notice and the limited warranty and
// restricted rights notice below appear in all supporting
// documentation.
//
// AUTODESK PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS.
// AUTODESK SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. AUTODESK, INC.
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
//
// Use, duplication, or disclosure by the U.S. Government is subject to
// restrictions set forth in FAR 52.227-19 (Commercial Computer
// Software - Restricted Rights) and DFAR 252.227-7013(c)(1)(ii)
// (Rights in Technical Data and Computer Software), as applicable.
//

using System;
using System.IO;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media.Imaging;
using System.Collections.ObjectModel;
using System.ComponentModel;
using System.Net;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using Microsoft.Win32;
using System.Windows.Navigation;
using System.Windows.Controls.Primitives;
using System.Reflection;
using System.Drawing;
using System.Configuration;
using System.Collections.Generic;
using Autodesk.Revit.DB.Macros;
using Autodesk.Revit.UI.Macros;
using System.Collections.Specialized;

using Autodesk.Revit.DB;
using Autodesk.Revit.UI;
using System.Text;

namespace Revit.SDK.Samples.DockableDialogs.CS
{
   /// <summary>
   /// A simple class to manage an interface into the Revit API.
   /// </summary>
   public partial class APIUtility
   {
      /// <summary>
      /// Store a reference to the application.
      /// </summary>
      public void Initialize(UIApplication uiApplication)
      {
         m_uiApplication = uiApplication;
      }

      /// <summary>
      /// Get the current Modeless command.
      /// </summary>
      public  ModelessCommand ModelessCommand { get { return m_ModelessCommand; } }

      /// <summary>
      /// Return dockable pane inforamtion, given a dockable pane Guid.
      /// </summary>
      public string GetPaneSummary(string paneGuidString)
      {
         Guid paneGuid;
         try
         {
            paneGuid = new Guid(paneGuidString);
         }
         catch (Exception)
         {
            return "Invalid Guid";
         }
         DockablePaneId paneId = new DockablePaneId(paneGuid);
         return GetPaneSummary(paneId);
      }


      /// <summary>
      /// Return dockable pane inforamtion, given a DockablePaneId
      /// </summary>
      public string GetPaneSummary(DockablePaneId id)
      {
         DockablePane pane = null;
         try
         {
            pane = m_uiApplication.GetDockablePane(id);
            return GetPaneSummary(pane);
         }
         catch (Exception ex)
         {
            return ex.Message;
         }  
      }

      /// <summary>
      /// Return dockable pane inforamtion, given a DockablePaneId
      /// </summary>
      public static string GetPaneSummary(DockablePane pane)
      {
         System.Text.StringBuilder sb = new System.Text.StringBuilder();
         sb.AppendLine("-RevitDockablePane- Title: " + pane.GetTitle() + ", Id-Guid: " + pane.Id.Guid.ToString());
         return sb.ToString();
      }

      /// <summary>
      /// Display docking state information as a string.
      /// </summary>
      public static  string GetDockStateSummary(DockablePaneState paneState)
      { 
         System.Text.StringBuilder sb = new System.Text.StringBuilder();
         sb.AppendLine(" -DockablePaneState-");
         sb.AppendLine(" Left: " + paneState.FloatingRectangle.Left.ToString());
         sb.AppendLine(" Right: " + paneState.FloatingRectangle.Right.ToString());
         sb.AppendLine(" Top: " + paneState.FloatingRectangle.Top.ToString());
         sb.AppendLine(" Bottom: " + paneState.FloatingRectangle.Bottom.ToString());
         sb.AppendLine(" Position: " + paneState.DockPosition.ToString());
         sb.AppendLine(" Tab target guid:" + paneState.TabBehind.Guid.ToString());
         return sb.ToString();
      }

      #region Data
      private Autodesk.Revit.UI.UIApplication m_uiApplication;
      private ModelessCommand m_ModelessCommand = new ModelessCommand();
      #endregion

   }
}