我有以下任务。我正在 Studio 2010 的 C# 上为 Visio 2010 编写加载项。 假设我打开了一个图表。在这张图中，我有任何一种形状（让我们一开始就尝试管理一个形状）。问题是我怎样才能读取这个形状的任何属性？我应该使用哪个 API？
基本算法：
（非常感谢代码示例）
【问题讨论】：
我假设您所指的属性指的是形状数据，过去在 UI 中称为自定义属性，并且在 API 中仍以该名称知道。
如果您不熟悉 ShapeSheet，您应该首先在 ShapeSheet 中查看具有自定义属性的形状，以了解属性是如何定义的。请参阅“What happened to the ShapeSheet?”了解如何在 Visio 2010 中打开 Shapesheet。
以下示例程序应该可以帮助您入门。此示例假定您的 PC 上安装了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);
}
}
}
}
【讨论】：
我写了a library that makes this a easier
要检索多个形状的属性：
var shapes = new[] {s1, s2};
var props = VA.CustomProperties.CustomPropertyHelper.GetCustomProperties(page, shapes);
props 中存储的返回值将是一个字典列表。每个字典对应于指定形状的属性。属性的名称是字典中的键。
要获取第一个形状的“Foo”属性...
props[0]["Foo"]
检索包含属性这些方面的公式和结果的对象：
【讨论】：
致所有在这个问题上需要代码帮助的人：
...
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);
}
}
....
【讨论】：