ArcObjects Library Reference  

GraphicsLayersListToolCtrl

About the Graphics layers ToolControl Sample

[C#]

GraphicsLayersListToolCtrl.cs

using System;
using System.Drawing;
using System.Runtime.InteropServices;
using ESRI.ArcGIS.ADF.BaseClasses;
using ESRI.ArcGIS.ADF.CATIDs;
using ESRI.ArcGIS.Controls;
using ESRI.ArcGIS.SystemUI;

namespace GraphicsLayerToolControl
{
  /// <summary>
  /// ToolControl implementation
  /// </summary>
  [Guid("f6d7f99f-2a94-472c-9981-b7d7d6edc518")]
  [ClassInterface(ClassInterfaceType.None)]
  [ProgId("GraphicsLayerToolControl.GraphicsLayersListToolCtrl")]
  public sealed class GraphicsLayersListToolCtrl : BaseCommand, IToolControl
  {
    #region COM Registration Function(s)
    [ComRegisterFunction()]
    [ComVisible(false)]
    static void RegisterFunction(Type registerType)
    {
      // Required for ArcGIS Component Category Registrar support
      ArcGISCategoryRegistration(registerType);

      //
      // TODO: Add any COM registration code here
      //
    }

    [ComUnregisterFunction()]
    [ComVisible(false)]
    static void UnregisterFunction(Type registerType)
    {
      // Required for ArcGIS Component Category Registrar support
      ArcGISCategoryUnregistration(registerType);

      //
      // TODO: Add any COM unregistration code here
      //
    }

    #region ArcGIS Component Category Registrar generated code
    /// <summary>
    /// Required method for ArcGIS Component Category registration -
    /// Do not modify the contents of this method with the code editor.
    /// </summary>
    private static void ArcGISCategoryRegistration(Type registerType)
    {
      string regKey = string.Format("HKEY_CLASSES_ROOT\\CLSID\\{{{0}}}", registerType.GUID);
      ControlsCommands.Register(regKey);
      MxCommands.Register(regKey);

    }
    /// <summary>
    /// Required method for ArcGIS Component Category unregistration -
    /// Do not modify the contents of this method with the code editor.
    /// </summary>
    private static void ArcGISCategoryUnregistration(Type registerType)
    {
      string regKey = string.Format("HKEY_CLASSES_ROOT\\CLSID\\{{{0}}}", registerType.GUID);
      ControlsCommands.Unregister(regKey);
      MxCommands.Unregister(regKey);

    }

    #endregion
    #endregion

    #region class members
    private IHookHelper m_hookHelper = null;
    private GraphicsLayersListCtrl m_graphicsLayerListCtrl = null;
    #endregion

    #region constructor
    public GraphicsLayersListToolCtrl()
    {
      base.m_category = ".NET Samples";
      base.m_caption = "Graphics Layers";
      base.m_message = "Active Graphics Layer";
      base.m_toolTip = "Active Graphics Layer";
      base.m_name = "ToolControlSample_GraphicsLayersListToolCtrl";

      try
      {
        string bitmapResourceName = GetType().Name + ".bmp";
        base.m_bitmap = new Bitmap(GetType(), bitmapResourceName);
      }
      catch (Exception ex)
      {
        System.Diagnostics.Trace.WriteLine(ex.Message, "Invalid Bitmap");
      }
    }
    #endregion

    #region Overriden Class Methods

    /// <summary>
    /// Occurs when this command is created
    /// </summary>
    /// <param name="hook">Instance of the application</param>
    public override void OnCreate(object hook)
    {
      if (hook == null)
        return;

      if (m_hookHelper == null)
        m_hookHelper = new HookHelperClass();

      m_hookHelper.Hook = hook;

      //make sure that the usercontrol has been initialized
      if (null == m_graphicsLayerListCtrl)
      {
        m_graphicsLayerListCtrl = new GraphicsLayersListCtrl();
        m_graphicsLayerListCtrl.CreateControl();
      }
      //set the Map property of the control
      m_graphicsLayerListCtrl.Map = m_hookHelper.FocusMap;
    }

    /// <summary>
    /// Occurs when this command is clicked
    /// </summary>
    public override void OnClick()
    {
      //not much to do here
    }

    #endregion

    #region IToolControl Members

    public bool OnDrop(esriCmdBarType barType)
    {
      return true;
    }

    public void OnFocus(ICompletionNotify complete)
    {

    }

    public int hWnd
    {
      get
      {
        //pass the handle of the usercontrol
        if (null == m_graphicsLayerListCtrl)
        {
          m_graphicsLayerListCtrl = new GraphicsLayersListCtrl();
          m_graphicsLayerListCtrl.CreateControl();
        }

        return m_graphicsLayerListCtrl.Handle.ToInt32();

      }
    }

    #endregion
  }
}

[Visual Basic .NET]

GraphicsLayersListToolCtrl.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Drawing
Imports System.Runtime.InteropServices
Imports ESRI.ArcGIS.ADF.BaseClasses
Imports ESRI.ArcGIS.ADF.CATIDs
Imports ESRI.ArcGIS.Controls
Imports ESRI.ArcGIS.SystemUI

  ''' <summary>
  ''' ToolControl implementation
  ''' </summary>
<Guid("f6d7f99f-2a94-472c-9981-b7d7d6edc518"), ClassInterface(ClassInterfaceType.None), ProgId("GraphicsLayerToolControl.GraphicsLayersListToolCtrl")> _
Public NotInheritable Class GraphicsLayersListToolCtrl : Inherits BaseCommand : Implements IToolControl
#Region "COM Registration Function(s)"
  <ComRegisterFunction(), ComVisible(False)> _
  Private Shared Sub RegisterFunction(ByVal registerType As Type)
    ' Required for ArcGIS Component Category Registrar support
    ArcGISCategoryRegistration(registerType)

    '
    ' TODO: Add any COM registration code here
    '
  End Sub

  <ComUnregisterFunction(), ComVisible(False)> _
  Private Shared Sub UnregisterFunction(ByVal registerType As Type)
    ' Required for ArcGIS Component Category Registrar support
    ArcGISCategoryUnregistration(registerType)

    '
    ' TODO: Add any COM unregistration code here
    '
  End Sub

#Region "ArcGIS Component Category Registrar generated code"
  ''' <summary>
  ''' Required method for ArcGIS Component Category registration -
  ''' Do not modify the contents of this method with the code editor.
  ''' </summary>
  Private Shared Sub ArcGISCategoryRegistration(ByVal registerType As Type)
    Dim regKey As String = String.Format("HKEY_CLASSES_ROOT\CLSID\{{{0}}}", registerType.GUID)
    ControlsCommands.Register(regKey)
    MxCommands.Register(regKey)

  End Sub
  ''' <summary>
  ''' Required method for ArcGIS Component Category unregistration -
  ''' Do not modify the contents of this method with the code editor.
  ''' </summary>
  Private Shared Sub ArcGISCategoryUnregistration(ByVal registerType As Type)
    Dim regKey As String = String.Format("HKEY_CLASSES_ROOT\CLSID\{{{0}}}", registerType.GUID)
    ControlsCommands.Unregister(regKey)
    MxCommands.Unregister(regKey)

  End Sub

#End Region
#End Region

#Region "class members"
  Private m_hookHelper As IHookHelper = Nothing
  Private m_graphicsLayerListCtrl As GraphicsLayersListCtrl = Nothing
#End Region

#Region "constructor"
  Public Sub New()
    MyBase.m_category = ".NET Samples"
    MyBase.m_caption = "Graphics Layers"
    MyBase.m_message = "Active Graphics Layer"
    MyBase.m_toolTip = "Active Graphics Layer"
    MyBase.m_name = "ToolControlSample_GraphicsLayersListToolCtrl"

    Try
      Dim bitmapResourceName As String = Me.GetType().Name & ".bmp"
      MyBase.m_bitmap = New Bitmap(Me.GetType(), bitmapResourceName)
    Catch ex As Exception
      System.Diagnostics.Trace.WriteLine(ex.Message, "Invalid Bitmap")
    End Try
  End Sub
#End Region

#Region "Overridden Class Methods"

    ''' <summary>
    ''' Occurs when this command is created
    ''' </summary>
    ''' <param name="hook">Instance of the application</param>
    Public Overrides Sub OnCreate(ByVal hook As Object)
        If hook Is Nothing Then
            Return
        End If

        If m_hookHelper Is Nothing Then
            m_hookHelper = New HookHelperClass()
        End If

        m_hookHelper.Hook = hook

        'make sure that the usercontrol has been initialized
        If Nothing Is m_graphicsLayerListCtrl Then
            m_graphicsLayerListCtrl = New GraphicsLayersListCtrl()
            m_graphicsLayerListCtrl.CreateControl()
        End If
        'set the Map property of the control
        m_graphicsLayerListCtrl.Map = m_hookHelper.FocusMap
    End Sub

    ''' <summary>
    ''' Occurs when this command is clicked
    ''' </summary>
    Public Overrides Sub OnClick()
        'not much to do here
    End Sub

#End Region

#Region "IToolControl Members"

  Public Function OnDrop(ByVal barType As esriCmdBarType) As Boolean Implements IToolControl.OnDrop
    Return True
  End Function

  Public Sub OnFocus(ByVal complete As ICompletionNotify) Implements IToolControl.OnFocus

  End Sub

  Public ReadOnly Property hWnd() As Integer Implements IToolControl.hWnd
    Get
      'pass the handle of the usercontrol
      If Nothing Is m_graphicsLayerListCtrl Then
        m_graphicsLayerListCtrl = New GraphicsLayersListCtrl()
        m_graphicsLayerListCtrl.CreateControl()
      End If

      Return m_graphicsLayerListCtrl.Handle.ToInt32()

    End Get
  End Property

#End Region
End Class