ArcGIS Pro SDK （五）内容 6 工程单位

环境：Visual Studio 2022 + .NET6 + ArcGIS Pro SDK 3.0

1 获取所有可用单位格式的完整列表

//需要使用 QueuedTask.Run()var unit_formats = Enum.GetValues(typeof(UnitFormatType)).OfType<UnitFormatType>().ToList();
System.Diagnostics.Debug.WriteLine("All available units\r\n");foreach (var unit_format in unit_formats)
{var units = DisplayUnitFormats.Instance.GetPredefinedProjectUnitFormats(unit_format);System.Diagnostics.Debug.WriteLine(unit_format.ToString());foreach (var display_unit_format in units){var line = $"{display_unit_format.DisplayName}, {display_unit_format.UnitCode}";System.Diagnostics.Debug.WriteLine(line);}System.Diagnostics.Debug.WriteLine("");
}

2 获取当前项目的单位格式列表

//需要使用 QueuedTask.Run()var unit_formats = Enum.GetValues(typeof(UnitFormatType)).OfType<UnitFormatType>().ToList();
System.Diagnostics.Debug.WriteLine("Project units\r\n");foreach (var unit_format in unit_formats)
{var units = DisplayUnitFormats.Instance.GetProjectUnitFormats(unit_format);System.Diagnostics.Debug.WriteLine(unit_format.ToString());foreach (var display_unit_format in units){var line = $"{display_unit_format.DisplayName}, {display_unit_format.UnitCode}";System.Diagnostics.Debug.WriteLine(line);}System.Diagnostics.Debug.WriteLine("");
}

3 获取当前项目的特定单位格式列表

//需要使用 QueuedTask.Run()//UnitFormatType.Angular, UnitFormatType.Area, UnitFormatType.Distance, 
//UnitFormatType.Direction, UnitFormatType.Location, UnitFormatType.Page
//UnitFormatType.Symbol2D, UnitFormatType.Symbol3D
var units = DisplayUnitFormats.Instance.GetProjectUnitFormats(UnitFormatType.Distance);

4 获取当前项目的默认格式列表

//需要使用 QueuedTask.Run()var unit_formats = Enum.GetValues(typeof(UnitFormatType)).OfType<UnitFormatType>().ToList();
System.Diagnostics.Debug.WriteLine("Default project units\r\n");foreach (var unit_format in unit_formats)
{var default_unit = DisplayUnitFormats.Instance.GetDefaultProjectUnitFormat(unit_format);var line = $"{unit_format.ToString()}: {default_unit.DisplayName}, {default_unit.UnitCode}";System.Diagnostics.Debug.WriteLine(line);
}
System.Diagnostics.Debug.WriteLine("");

5 获取当前项目的特定默认单位格式

//需要使用 QueuedTask.Run()//UnitFormatType.Angular, UnitFormatType.Area, UnitFormatType.Distance, 
//UnitFormatType.Direction, UnitFormatType.Location, UnitFormatType.Page
//UnitFormatType.Symbol2D, UnitFormatType.Symbol3D
var default_unit = DisplayUnitFormats.Instance.GetDefaultProjectUnitFormat(UnitFormatType.Distance);

6 为当前项目设置特定的单位格式列表

//需要使用 QueuedTask.Run()//UnitFormatType.Angular, UnitFormatType.Area, UnitFormatType.Distance, 
//UnitFormatType.Direction, UnitFormatType.Location//获取所有可用位置单位的完整列表
var all_units = DisplayUnitFormats.Instance.GetPredefinedProjectUnitFormats(UnitFormatType.Location);
//保持单位的偶数工厂代码
var list_units = all_units.Where(du => du.UnitCode % 2 == 0).ToList();//将它们设置为新的位置单位集合。没有指定新的默认值……
DisplayUnitFormats.Instance.SetProjectUnitFormats(list_units);//将它们设置为新的位置单位集合以及新的默认值
DisplayUnitFormats.Instance.SetProjectUnitFormats(list_units, list_units.First());//Note: UnitFormatType.Page, UnitFormatType.Symbol2D, UnitFormatType.Symbol3D

7 设置项目单位格式的默认值

//需要使用 QueuedTask.Run()var unit_formats = Enum.GetValues(typeof(UnitFormatType)).OfType<UnitFormatType>().ToList();
foreach (var unit_type in unit_formats)
{var current_default = DisplayUnitFormats.Instance.GetDefaultProjectUnitFormat(unit_type);//任意选择每个单位格式列表中的最后一个单位var replacement = DisplayUnitFormats.Instance.GetProjectUnitFormats(unit_type).Last();DisplayUnitFormats.Instance.SetDefaultProjectUnitFormat(replacement);var line = $"{current_default.DisplayName}, {current_default.UnitName}, {current_default.UnitCode}";var line2 = $"{replacement.DisplayName}, {replacement.UnitName}, {replacement.UnitCode}";System.Diagnostics.Debug.WriteLine($"Format: {unit_type.ToString()}");System.Diagnostics.Debug.WriteLine($" Current default: {line}");System.Diagnostics.Debug.WriteLine($" Replacement default: {line2}");
}

8 更新项目的单位格式

//UnitFormatType.Angular, UnitFormatType.Area, UnitFormatType.Distance, 
//UnitFormatType.Direction, UnitFormatType.Location
var angle_units = DisplayUnitFormats.Instance.GetProjectUnitFormats(UnitFormatType.Angular);//编辑每个单位的显示名称-添加缩写
foreach (var unit in angle_units)
{unit.DisplayName = $"{unit.DisplayName} ({unit.Abbreviation})";
}
//将更改应用到单位上，并将默认值设置为第一个条目
DisplayUnitFormats.Instance.SetProjectUnitFormats(angle_units, angle_units.First());//项目必须保存以持久化更改……