ArcGIS Pro SDK (四)框架 2

2024-06-18 14:52
文章标签 arcgis sdk 框架 pro

本文主要是介绍ArcGIS Pro SDK (四)框架 2,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

ArcGIS Pro SDK 框架 2

目录

  • ArcGIS Pro SDK 框架 2
    • 18 访问当前主题
    • 19 显示Pro消息框
    • 20 添加吐司通知
    • 21 更改按钮标题或图像
    • 22 获取按钮的工具提示标题
    • 23 订阅活动工具更改事件
    • 24 进度器 - 简单且不可取消
    • 25 进度器 - 可取消
    • 26 自定义按钮或工具的 disabedText 属性
    • 27 从当前程序集获取图像资源
    • 28 阻止 ArcGIS Pro 关闭
    • 29 如何在 MapView 中定位可嵌入控件
    • 30 激活选项卡时命令搜索中建议的命令选项。
    • 31 从命令行启动 ArcGIS Pro
    • 32 获取命令行参数
    • 33 应用程序加速器(快捷键)
    • 34 使用专业样式在 DAML 中定义控件

18 访问当前主题

// 获取应用程序的主题
var theme = FrameworkApplication.ApplicationTheme;
// 主题
if (FrameworkApplication.ApplicationTheme == ApplicationTheme.Dark)
{// 黑暗主题
}if (FrameworkApplication.ApplicationTheme == ApplicationTheme.HighContrast)
{// 高对比度
}
if (FrameworkApplication.ApplicationTheme == ApplicationTheme.Default)
{// 明亮/默认主题
}

19 显示Pro消息框

ArcGIS.Desktop.Framework.Dialogs.MessageBox.Show("Some Message", "Some title", MessageBoxButton.YesNo, MessageBoxImage.Information, MessageBoxResult.Yes);

20 添加吐司通知

Notification notification = new Notification();
notification.Title = FrameworkApplication.Title;
notification.Message = "Notification 1";
notification.ImageUrl = @"pack://application:,,,/ArcGIS.Desktop.Resources;component/Images/ToastLicensing32.png";ArcGIS.Desktop.Framework.FrameworkApplication.AddNotification(notification);

21 更改按钮标题或图像

private void ChangeCaptionImage()
{IPlugInWrapper wrapper = FrameworkApplication.GetPlugInWrapper("MyAddin_MyCustomButton");if (wrapper != null){wrapper.Caption = "new caption";// 确保T-Rex16和T-Rex32包含在你的插件中的images文件夹下,并设置生成`操作 = 资源`和`复制到输出目录 = 不复制`wrapper.SmallImage = BuildImage("T-Rex16.png");wrapper.LargeImage = BuildImage("T-Rex32.png");}
}private ImageSource BuildImage(string imageName)
{return new BitmapImage(PackUriForResource(imageName));
}private Uri PackUriForResource(string resourceName)
{string asm = System.IO.Path.GetFileNameWithoutExtension(System.Reflection.Assembly.GetExecutingAssembly().Location);return new Uri(string.Format("pack://application:,,,/{0};component/Images/{1}", asm, resourceName), UriKind.Absolute);
}

22 获取按钮的工具提示标题

// 传入按钮的daml id。或者传入任何Pro按钮ID。
IPlugInWrapper wrapper = FrameworkApplication.GetPlugInWrapper("button_id_from daml");
var buttonTooltipHeading = wrapper.TooltipHeading;

23 订阅活动工具更改事件

private void SubscribeEvent()
{ArcGIS.Desktop.Framework.Events.ActiveToolChangedEvent.Subscribe(OnActiveToolChanged);
}
private void UnSubscribeEvent()
{ArcGIS.Desktop.Framework.Events.ActiveToolChangedEvent.Unsubscribe(OnActiveToolChanged);
}
private void OnActiveToolChanged(ArcGIS.Desktop.Framework.Events.ToolEventArgs args)
{string prevTool = args.PreviousID;string newTool = args.CurrentID;
}

24 进度器 - 简单且不可取消

public async Task Progressor_NonCancelable()
{ArcGIS.Desktop.Framework.Threading.Tasks.ProgressorSource ps = new ArcGIS.Desktop.Framework.Threading.Tasks.ProgressorSource("Doing my thing...", false);int numSecondsDelay = 5;// 如果您在调试器中运行此程序,则不会看到对话框await ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() => Task.Delay(numSecondsDelay * 1000).Wait(), ps.Progressor);
}

25 进度器 - 可取消

public async Task Progressor_Cancelable()
{ArcGIS.Desktop.Framework.Threading.Tasks.CancelableProgressorSource cps =new ArcGIS.Desktop.Framework.Threading.Tasks.CancelableProgressorSource("Doing my thing - cancelable", "Canceled");int numSecondsDelay = 5;// 如果您在调试器中运行此程序,则不会看到对话框// 模拟做一些可以取消的工作await ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>{cps.Progressor.Max = (uint)numSecondsDelay;// 每秒钟检查一次while (!cps.Progressor.CancellationToken.IsCancellationRequested){cps.Progressor.Value += 1;cps.Progressor.Status = "Status " + cps.Progressor.Value;cps.Progressor.Message = "Message " + cps.Progressor.Value;if (System.Diagnostics.Debugger.IsAttached){System.Diagnostics.Debug.WriteLine(string.Format("RunCancelableProgress Loop{0}", cps.Progressor.Value));}if (cps.Progressor.Value == cps.Progressor.Max) break;// 阻塞一秒钟Task.Delay(1000).Wait();}System.Diagnostics.Debug.WriteLine(string.Format("RunCancelableProgress: Canceled {0}",cps.Progressor.CancellationToken.IsCancellationRequested));}, cps.Progressor);
}

26 自定义按钮或工具的 disabedText 属性

// 在config.daml中将工具的loadOnClick属性设置为“false”。
// 这将允许在Pro启动时创建工具,以便disabledText属性可以在启动时显示自定义文本。
// 从工具中删除“condition”属性。使用下面的OnUpdate方法设置工具的启用/禁用状态。
// 添加OnUpdate方法到工具中。
// 注意:由于OnUpdate调用非常频繁,您应该避免在此方法中进行冗长的操作
// 因为这将降低应用程序用户界面的响应性。
internal class SnippetButton : ArcGIS.Desktop.Framework.Contracts.Button
{protected override void OnUpdate(){bool enableSate = true; //TODO: 编写你的启用状态bool criteria = true;  //TODO: 评估disabledText的标准if (enableSate){this.Enabled = true;  // 工具已启用}else{this.Enabled = false;  // 工具已禁用// 在这里自定义你的disabledTextif (criteria)this.DisabledTooltip = "Missing criteria 1";}}
}

27 从当前程序集获取图像资源

public static void ExampleUsage()
{// 图片` Dino32.png `,并设置生成`操作 = 资源`和`复制到输出目录 = 不复制`var img = ForImage("Dino32.png");// 使用图片…
}public static BitmapImage ForImage(string imageName)
{return new BitmapImage(PackUriForResource(imageName));
}
public static Uri PackUriForResource(string resourceName, string folderName = "Images")
{string asm = System.IO.Path.GetFileNameWithoutExtension(System.Reflection.Assembly.GetExecutingAssembly().Location);string uriString = folderName.Length > 0? string.Format("pack://application:,,,/{0};component/{1}/{2}", asm, folderName, resourceName): string.Format("pack://application:,,,/{0};component/{1}", asm, resourceName);return new Uri(uriString, UriKind.Absolute);
}

28 阻止 ArcGIS Pro 关闭

// 有两种方法可以防止ArcGIS Pro关闭
// 1. 覆盖加载项模块上的CanUnload方法并返回false。
// 2. 订阅ApplicationClosing事件,并在收到它时取消该事件internal class Module1 : Module
{// 在ArcGIS Pro关闭时被框架调用protected override bool CanUnload(){// 返回false 取消应用程序关闭return false;}internal class Module2 : Module{public Module2(){ArcGIS.Desktop.Framework.Events.ApplicationClosingEvent.Subscribe(OnApplicationClosing);}~Module2(){ArcGIS.Desktop.Framework.Events.ApplicationClosingEvent.Unsubscribe(OnApplicationClosing);}private Task OnApplicationClosing(System.ComponentModel.CancelEventArgs args){args.Cancel = true;return Task.FromResult(0);}// cref: ARCGIS.DESKTOP.CORE.EVENTS.PROJECTOPENEDEVENT// cref: ARCGIS.DESKTOP.CORE.EVENTS.PROJECTOPENEDEVENT.SUBSCRIBE// cref: ARCGIS.DESKTOP.CORE.EVENTS.PROJECTOPENEDEVENT.UNSUBSCRIBE// cref: ARCGIS.DESKTOP.FRAMEWORK.CONTRACTS.MODULE.INITIALIZE// cref: ARCGIS.DESKTOP.FRAMEWORK.CONTRACTS.MODULE.UNINITIALIZE#region 如何确定项目何时打开protected override bool Initialize() // 在模块初始化时调用。{ProjectOpenedEvent.Subscribe(OnProjectOpened); // 订阅项目打开事件return base.Initialize();}private void OnProjectOpened(ProjectEventArgs obj) // 项目打开事件处理程序{MessageBox.Show($"{Project.Current} has opened"); // 显示您的消息框}protected override void Uninitialize() // 取消订阅项目打开的事件{ProjectOpenedEvent.Unsubscribe(OnProjectOpened); // 取消订阅return;}

29 如何在 MapView 中定位可嵌入控件

public ProSnippetMapTool()
{// 在构造函数中将MapTool基类的OverlayControlID设置为可嵌入控件的DAML idthis.OverlayControlID = "ProAppModule1_EmbeddableControl1";
}protected override void OnToolMouseDown(MapViewMouseButtonEventArgs e)
{if (e.ChangedButton == System.Windows.Input.MouseButton.Left)e.Handled = true;
}protected override Task HandleMouseDownAsync(MapViewMouseButtonEventArgs e)
{return QueuedTask.Run(() =>{// 将屏幕坐标点分配给MapTool基类的OverlayControlLocation属性。this.OverlayControlPositionRatio = e.ClientPoint;});
}

30 激活选项卡时命令搜索中建议的命令选项。

//在 module class..
public override string[] GetSuggestedCMDIDs(string activeTabID)
{//返回您希望成为(建议)的daml id的静态列表//默认值与给定选项卡相关。它可以是none、some或all of//与activeTabID相关的命令。//在这个例子中,有两个选项卡。这个例子是任意的//标识每个选项卡上只有一个命令作为默认显示在//命令搜索列表(when _that_ particular tab is active)switch (activeTabID){case "CommandSearch_Example_Tab1":return new string[] { "CommandSearch_Example_Button2" };case "CommandSearch_Example_Tab2":return new string[] { "CommandSearch_Example_Button4" };}return new string[] { "" };
}

31 从命令行启动 ArcGIS Pro

C:\>"C:\Program Files\ArcGIS Pro\bin\ArcGISPro.exe"

32 获取命令行参数

如果您的外接程序需要使用自定义命令行参数,则参数的格式必须为“/argument” - 请注意正斜杠“/”。不能有空格。如果命令行包含要打开的项目(请参阅从命令行打开项目),则必须将自定义参数或开关放在项目文件名参数之前。

string[] args = System.Environment.GetCommandLineArgs();
foreach (var arg in args)
{// 寻找你的命令行开关
}

33 应用程序加速器(快捷键)

可以使用加速器/插入加速器 DAML 元素将应用程序加速器添加到外接程序 config.daml 中,该元素具有要与加速器关联的元素的 refID(即快捷方式)。

<accelerators><insertAccelerator refID="esri_core_openProjectButton" flags="Ctrl" key="O" /><insertAccelerator refID="esri_core_redoButton" flags="Ctrl" key="Y" /><insertAccelerator refID="esri_core_undoButton" flags="Ctrl" key="Z" />
</accelerators>

注意:使用 updateModule 元素中的 deleteAccelerator 和 updateAccelerator DAML 元素分别删除或更改应用程序加速器。 标志可以是以下之一:Shift、Ctrl、Alt、Ctrl+Shift、Alt+Shift、Ctrl+Alt、Ctrl+Alt+Shift

34 使用专业样式在 DAML 中定义控件

定义了许多 ArcGIS Pro 样式,这些样式可应用于窗格和停靠窗格上的按钮、标注和其他控件,以使加载项的外观与 ArcGIS Pro 无缝衔接。下面列出了一些最常见的样式。有关更多样式和颜色,请参阅社区示例存储库中的使用 ArcGIS Pro 设置样式示例。

按钮样式

<Button Content="Button" Style="{StaticResource Esri_SimpleButton}" ToolTip="Button">
<Button Content="Button" Style="{StaticResource Esri_BackButton}" ToolTip="Button">
<Button Content="Button" Style="{StaticResource Esri_BackButtonSmall}" ToolTip="Button">
<Button Content="Button" Style="{StaticResource Esri_CloseButton}" ToolTip="Button">

码头窗格标题样式

<TextBlock Text="MyDockPane" Style="{StaticResource DockPaneHeading}" VerticalAlignment="Center" HorizontalAlignment="Center"/>

这篇关于ArcGIS Pro SDK (四)框架 2的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1072305

相关文章

GSON框架下将百度天气JSON数据转JavaBean

《GSON框架下将百度天气JSON数据转JavaBean》这篇文章主要为大家详细介绍了如何在GSON框架下实现将百度天气JSON数据转JavaBean,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下... 目录前言一、百度天气jsON1、请求参数2、返回参数3、属性映射二、GSON属性映射实战1、类对象映

解决若依微服务框架启动报错的问题

《解决若依微服务框架启动报错的问题》Invalidboundstatement错误通常由MyBatis映射文件未正确加载或Nacos配置未读取导致,需检查XML的namespace与方法ID是否匹配,... 目录ruoyi-system模块报错报错详情nacos文件目录总结ruoyi-systnGLNYpe

Python Web框架Flask、Streamlit、FastAPI示例详解

《PythonWeb框架Flask、Streamlit、FastAPI示例详解》本文对比分析了Flask、Streamlit和FastAPI三大PythonWeb框架:Flask轻量灵活适合传统应用... 目录概述Flask详解Flask简介安装和基础配置核心概念路由和视图模板系统数据库集成实际示例Stre

Olingo分析和实践之OData框架核心组件初始化(关键步骤)

《Olingo分析和实践之OData框架核心组件初始化(关键步骤)》ODataSpringBootService通过初始化OData实例和服务元数据,构建框架核心能力与数据模型结构,实现序列化、URI... 目录概述第一步:OData实例创建1.1 OData.newInstance() 详细分析1.1.1

升级至三频BE12000! 华硕ROG魔盒Pro路由器首发拆解评测

《升级至三频BE12000!华硕ROG魔盒Pro路由器首发拆解评测》华硕前两天推出新一代电竞无线路由器——ROG魔盒Pro(StrixGR7Pro),该产品在无线规格、硬件配置及功能设计上实现全... 作为路由器行业的T1梯队厂商,华硕近期发布了新旗舰华硕ROG魔盒Pro,除了保留DIY属性以外,高达120

三频BE12000国补到手2549元! ROG 魔盒Pro WIFI7电竞AI路由器上架

《三频BE12000国补到手2549元!ROG魔盒ProWIFI7电竞AI路由器上架》近日,华硕带来了ROG魔盒ProWIFI7电竞AI路由器(ROGSTRIXGR7Pro),目前新... 华硕推出了ROG 魔盒Pro WIFI7电竞AI路由器(ROG STRIX GR7 Phttp://www.cppcn

Spring 框架之Springfox使用详解

《Spring框架之Springfox使用详解》Springfox是Spring框架的API文档工具,集成Swagger规范,自动生成文档并支持多语言/版本,模块化设计便于扩展,但存在版本兼容性、性... 目录核心功能工作原理模块化设计使用示例注意事项优缺点优点缺点总结适用场景建议总结Springfox 是

Python的端到端测试框架SeleniumBase使用解读

《Python的端到端测试框架SeleniumBase使用解读》:本文主要介绍Python的端到端测试框架SeleniumBase使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全... 目录SeleniumBase详细介绍及用法指南什么是 SeleniumBase?SeleniumBase

VSCode设置python SDK路径的实现步骤

《VSCode设置pythonSDK路径的实现步骤》本文主要介绍了VSCode设置pythonSDK路径的实现步骤,包括命令面板切换、settings.json配置、环境变量及虚拟环境处理,具有一定... 目录一、通过命令面板快速切换(推荐方法)二、通过 settings.json 配置(项目级/全局)三、

C++ HTTP框架推荐(特点及优势)

《C++HTTP框架推荐(特点及优势)》:本文主要介绍C++HTTP框架推荐的相关资料,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录1. Crow2. Drogon3. Pistache4. cpp-httplib5. Beast (Boos