About the Updating the purge rule on a real-time temporal layer Sample
[C#]
TAPurgeRuleCmd.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.esriSystem; using ESRI.ArcGIS.Carto; namespace TAPurgeRuleCommand { /// <summary> /// Command that works in ArcMap/Map/PageLayout, ArcScene/SceneControl /// or ArcGlobe/GlobeControl /// </summary> [Guid("4a9ae2c3-dfdb-4b55-922d-558a1a9ccfe1")] [ClassInterface(ClassInterfaceType.None)] [ProgId("TAPurgeRuleCommand.TAPurgeRuleCmd")] public sealed class TAPurgeRuleCmd : BaseCommand { #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); GMxCommands.Register(regKey); MxCommands.Register(regKey); SxCommands.Register(regKey); ControlsCommands.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); GMxCommands.Unregister(regKey); MxCommands.Unregister(regKey); SxCommands.Unregister(regKey); ControlsCommands.Unregister(regKey); } #endregion #endregion private IHookHelper m_hookHelper = null; private IGlobeHookHelper m_globeHookHelper = null; private const string TEMPORALLAYERCLSID = "{78C7430C-17CF-11D5-B7CF-00010265ADC5}"; //CLSID for ITemporalLayer private PurgeRuleForm m_PRForm; public TAPurgeRuleCmd() { // // TODO: Define values for the public properties // base.m_category = ".NET Samples"; //localizable text base.m_caption = "Change the purge rule for temporal layers"; //localizable text base.m_message = "Change the purge rule for temporal layers"; //localizable text base.m_toolTip = "Change the purge rule for temporal layers"; //localizable text base.m_name = "TAPurgeRuleCommand_TAPurgeRuleCmd"; //unique id, non-localizable (e.g. "MyCategory_MyCommand") m_PRForm = new PurgeRuleForm(); try { // // TODO: change bitmap name if necessary // string bitmapResourceName = GetType().Name + ".bmp"; base.m_bitmap = new Bitmap(GetType(), bitmapResourceName); } catch (Exception ex) { System.Diagnostics.Trace.WriteLine(ex.Message, "Invalid Bitmap"); } } #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; // Test the hook that calls this command and disable if nothing is valid try { m_hookHelper = new HookHelperClass(); m_hookHelper.Hook = hook; if (m_hookHelper.ActiveView == null) { m_hookHelper = null; } } catch { m_hookHelper = null; } if (m_hookHelper == null) { //Can be globe try { m_globeHookHelper = new GlobeHookHelperClass(); m_globeHookHelper.Hook = hook; if (m_globeHookHelper.ActiveViewer == null) { m_globeHookHelper = null; } } catch { m_globeHookHelper = null; } } if (m_globeHookHelper == null && m_hookHelper == null) base.m_enabled = false; else base.m_enabled = true; //TODO: Add other initialization code } /// <summary> /// Occurs when this command is clicked /// </summary> public override void OnClick() { //Show the dialog, pass it the temporal layers from the map, have it initialize the dialog if (!m_PRForm.Visible) { m_PRForm.Show(); m_PRForm.TrackingLayers = GetAllTrackingLayers(); m_PRForm.PopulateDialog(); } else { m_PRForm.Hide(); } } //Show the command as depressed when the dialog is visible public override bool Checked { get { return m_PRForm.Visible; } } #endregion //Query the map for all the tracking layers in it private IEnumLayer GetAllTrackingLayers() { IEnumLayer eLayers = null; try { IBasicMap basicMap = null; IUID uidTemoralLayer = new UIDClass(); uidTemoralLayer.Value = TEMPORALLAYERCLSID; if (m_hookHelper != null) { basicMap = m_hookHelper.FocusMap as IBasicMap; } else if (m_globeHookHelper != null) { basicMap = m_globeHookHelper.Globe as IBasicMap; } //This call throws an E_FAIL exception if the map has no layers, caught below if (basicMap != null) { eLayers = basicMap.get_Layers((UID)uidTemoralLayer, true); } } catch { } return eLayers; } } }
[Visual Basic .NET]
TAPurgeRuleCmd.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.esriSystem Imports ESRI.ArcGIS.Carto Namespace TAPurgeRuleCommand ''' <summary> ''' Command that works in ArcMap/Map/PageLayout, ArcScene/SceneControl ''' or ArcGlobe/GlobeControl ''' </summary> <Guid("4a9ae2c3-dfdb-4b55-922d-558a1a9ccfe1"), ClassInterface(ClassInterfaceType.None), ProgId("TAPurgeRuleCommand.TAPurgeRuleCmd")> _ Public NotInheritable Class TAPurgeRuleCmd : Inherits BaseCommand #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) GMxCommands.Register(regKey) MxCommands.Register(regKey) SxCommands.Register(regKey) ControlsCommands.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) GMxCommands.Unregister(regKey) MxCommands.Unregister(regKey) SxCommands.Unregister(regKey) ControlsCommands.Unregister(regKey) End Sub #End Region #End Region Private m_hookHelper As IHookHelper = Nothing Private m_globeHookHelper As IGlobeHookHelper = Nothing Private Const TEMPORALLAYERCLSID As String = "{78C7430C-17CF-11D5-B7CF-00010265ADC5}" 'CLSID for ITemporalLayer Private m_PRForm As PurgeRuleForm Public Sub New() ' ' TODO: Define values for the public properties ' MyBase.m_category = ".NET Samples" 'localizable text MyBase.m_caption = "Change the purge rule for temporal layers" 'localizable text MyBase.m_message = "Change the purge rule for temporal layers" 'localizable text MyBase.m_toolTip = "Change the purge rule for temporal layers" 'localizable text MyBase.m_name = "TAPurgeRuleCommand_TAPurgeRuleCmd" 'unique id, non-localizable (e.g. "MyCategory_MyCommand") m_PRForm = New PurgeRuleForm() Try ' ' TODO: change bitmap name if necessary ' 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 #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 ' Test the hook that calls this command and disable if nothing is valid Try m_hookHelper = New HookHelperClass() m_hookHelper.Hook = hook If m_hookHelper.ActiveView Is Nothing Then m_hookHelper = Nothing End If Catch m_hookHelper = Nothing End Try If m_hookHelper Is Nothing Then 'Can be globe Try m_globeHookHelper = New GlobeHookHelperClass() m_globeHookHelper.Hook = hook If m_globeHookHelper.ActiveViewer Is Nothing Then m_globeHookHelper = Nothing End If Catch m_globeHookHelper = Nothing End Try End If If m_globeHookHelper Is Nothing AndAlso m_hookHelper Is Nothing Then MyBase.m_enabled = False Else MyBase.m_enabled = True End If 'TODO: Add other initialization code End Sub ''' <summary> ''' Occurs when this command is clicked ''' </summary> Public Overrides Sub OnClick() 'Show the dialog, pass it the temporal layers from the map, have it initialize the dialog If (Not m_PRForm.Visible) Then m_PRForm.Show() m_PRForm.TrackingLayers = GetAllTrackingLayers() m_PRForm.PopulateDialog() Else m_PRForm.Hide() End If End Sub 'Show the command as depressed when the dialog is visible Public Overrides ReadOnly Property Checked() As Boolean Get Return m_PRForm.Visible End Get End Property #End Region 'Query the map for all the tracking layers in it Private Function GetAllTrackingLayers() As IEnumLayer Dim eLayers As IEnumLayer = Nothing Try Dim basicMap As IBasicMap = Nothing Dim uidTemoralLayer As IUID = New UIDClass() uidTemoralLayer.Value = TEMPORALLAYERCLSID If Not m_hookHelper Is Nothing Then basicMap = TryCast(m_hookHelper.FocusMap, IBasicMap) ElseIf Not m_globeHookHelper Is Nothing Then basicMap = TryCast(m_globeHookHelper.Globe, IBasicMap) End If 'This call throws an E_FAIL exception if the map has no layers, caught below If Not basicMap Is Nothing Then eLayers = basicMap.Layers(CType(uidTemoralLayer, UID), True) End If Catch End Try Return eLayers End Function End Class End Namespace