如何在 Visio 中读取形状的属性

Question

我有以下任务。我正在 Studio 2010 中的 C# 上编写 Visio 2010 的加载项。 假设我打开了一个图表。在此图中我有任何类型的形状（让我们尝试从一开始就管理一种形状）。问题是我如何读取这个形状的任何属性？我应该使用哪个 API？

基本算法：

1. 扫描打开的文档中的形状
2. 如果文档中存在任何形状，则返回所有形状的数组（或列表）（如果当前文档中没有形状，则返回 null）
3. 运行形状数组并读取任何属性每个元素（如果有机会编写/修改属性就太好了）

（代码示例将不胜感激）

Answer 1

我假设您所说的属性指的是形状数据，它曾经在 UI 中称为“自定义属性”，并且在 API 中仍然以该名称为人所知。

如果您不熟悉 ShapeSheet，您应该首先查看 ShapeSheet 中具有自定义属性的形状，以了解如何定义属性。请参阅“ShapeSheet 发生了什么?”了解如何在 Visio 2010 中打开 Shapesheet

。以下示例程序应该可以帮助您入门。此示例假设您的电脑上安装了 Visio Primary Interop Assembly并且您已在项目中包含了 Microsoft.Office.Interop.Visio 的引用者。

namespace VisioEventsExample
{
    using System;
    using Microsoft.Office.Interop.Visio;

    class Program
    {
        public static void Main(string[] args)
        {
            // Open up one of Visio's sample drawings.
            Application app = new Application();
            Document doc = app.Documents.Open(
                @"C:\Program Files\Microsoft Office\Office14\visio content\1033\ASTMGT_U.VST");

            // Get the first page in the sample drawing.
            Page page = doc.Pages[1];

            // Start with the collection of shapes on the page and 
            // print the properties we find,
            printProperties(page.Shapes);
        }

        /* This function will travel recursively through a collection of 
         * shapes and print the custom properties in each shape. 
         * 
         * The reason I don't simply look at the shapes in Page.Shapes is 
         * that when you use the Group command the shapes you group become 
         * child shapes of the group shape and are no longer one of the 
         * items in Page.Shapes.
         * 
         * This function will not recursive into shapes which have a Master. 
         * This means that shapes which were created by dropping from stencils 
         * will have their properties printed but properties of child shapes 
         * inside them will be ignored. I do this because such properties are 
         * not typically shown to the user and are often used to implement 
         * features of the shapes such as data graphics.
         * 
         * An alternative halting condition for the recursion which may be 
         * sensible for many drawing types would be to stop when you 
         * find a shape with custom properties.
         */
        public static void printProperties(Shapes shapes)
        {
            // Look at each shape in the collection.
            foreach (Shape shape in shapes)
            {               
                // Use this index to look at each row in the properties 
                // section.
                short iRow = (short) VisRowIndices.visRowFirst;

                // While there are stil rows to look at.
                while (shape.get_CellsSRCExists(
                    (short) VisSectionIndices.visSectionProp, 
                    iRow, 
                    (short) VisCellIndices.visCustPropsValue,
                    (short) 0) != 0)
                {
                    // Get the label and value of the current property.
                    string label = shape.get_CellsSRC(
                            (short) VisSectionIndices.visSectionProp, 
                            iRow,
                            (short) VisCellIndices.visCustPropsLabel
                        ).get_ResultStr(VisUnitCodes.visNoCast);

                    string value = shape.get_CellsSRC(
                            (short) VisSectionIndices.visSectionProp, 
                            iRow,
                            (short) VisCellIndices.visCustPropsValue
                        ).get_ResultStr(VisUnitCodes.visNoCast);

                    // Print the results.
                    Console.WriteLine(string.Format(
                        "Shape={0} Label={1} Value={2}",
                        shape.Name, label, value));

                    // Move to the next row in the properties section.
                    iRow++;
                }

                // Now look at child shapes in the collection.
                if (shape.Master == null && shape.Shapes.Count > 0)
                    printProperties(shape.Shapes);
            }
        }
    }
}

Answer 2

我编写了一个库，使这变得更容易

检索多个形状的属性：

var shapes = new[] {s1, s2};
var props = VA.CustomProperties.CustomPropertyHelper.GetCustomProperties(page, shapes);

props中存储的返回值将是一个字典列表。每个字典对应于指定形状的属性。属性的名称是字典中的键。

要获取第一个形状的“Foo”属性...

props[0]["Foo"] 

它检索包含公式和形状的对象。属性这些方面的结果：

• 日历
• 格式
• 不可见
• 标签
• LangId
• 提示 排序
• 键
• 类型
• 值
• 验证

Answer 3

对于所有稍后在这个问题上需要代码帮助的人：

...
using Visio = Microsoft.Office.Interop.Visio;

namespace RibbonCustomization
{
   [ComVisible(true)]
   public class Ribbon1 : Office.IRibbonExtensibility
   {

      public void ReadShapes(Microsoft.Office.Core.IRibbonControl control)
      {
         ExportElement exportElement;
         ArrayList exportElements = new ArrayList();

         Visio.Document currentDocument = Globals.ThisAddIn.Application.ActiveDocument;
         Visio.Pages Pages = currentDocument.Pages;
         Visio.Shapes Shapes;

         foreach(Visio.Page Page in Pages)
         {
            Shapes = Page.Shapes;
            foreach (Visio.Shape Shape in Shapes)
            {
               exportElement = new ExportElement();
               exportElement.Name = Shape.Master.NameU;
               exportElement.ID = Shape.ID;               
               exportElement.Text = Shape.Text;
               ...
               // and any other properties you'd like

               exportElements.Add(exportElement);
            }
         }
....