c# - 使形状最顶层

Question

在我的 Word 加载项中，我有一个 Word Document 对象，其中包含一个特定的 Section。在此 Section 中，我附加了一个 Shape:

var shape = section.Headers[WdHeaderFooterIndex.wdHeaderFooterFirstPage].Shapes.AddTextEffect(MsoPresetTextEffect.msoTextEffect1, "Example text...", "Calibri", 72, MsoTriState.msoFalse, MsoTriState.msoFalse, 0, 0, section.Headers[WdHeaderFooterIndex.wdHeaderFooterFirstPage].Range) as Shape;

我的问题是某些 Word 文档模板的图像或其他内容出现在我的形状之上。最初，我认为设置 Z 顺序就足以解决这个问题:

shape.ZOrder(MsoZOrderCmd.msoBringToFront);

它没有。所以我的问题是，我怎样才能完全设置我的 Shape 的 Z 顺序，或者换句话说，为了制作我的 Shape 我还需要做些什么来设置> 这样它就成为您在文档中看到的最顶层的东西(意思是，它出现在所有其他东西之上)？

Answer 1

我终于弄清楚为什么这些方法不起作用:

shape.ZOrder(MsoZOrderCmd.msoBringInFrontOfText);
shape.ZOrder(MsoZOrderCmd.msoBringToFront);

问题是我在 HeaderFooter 部分中添加了我的 Shape 对象，但是显示在其上方的形状是在 Document< 中定义的。 Z 顺序仅相对于您的对象所在的同一部分内的其他形状(无论您的对象是否在实际文档、页眉、页脚等中)。

因此代替此代码将形状添加到特定部分:

var shape = section.Headers[WdHeaderFooterIndex.wdHeaderFooterFirstPage].Shapes.AddTextEffect(MsoPresetTextEffect.msoTextEffect1, "Example text...", "Calibri", 72, MsoTriState.msoFalse, MsoTriState.msoFalse, 0, 0, section.Headers[WdHeaderFooterIndex.wdHeaderFooterFirstPage].Range) as Shape;
shape.ZOrder(MsoZOrderCmd.msoBringInFrontOfText);
shape.ZOrder(MsoZOrderCmd.msoBringToFront);

我使用这段代码将其直接添加到我的文档中，然后对其应用 Z 排序，它确实有效。它出现在所有其他对象之上，这些对象是我模板的一部分:

var shape = document.Shapes.AddTextEffect(MsoPresetTextEffect.msoTextEffect1, "Example text...", "Calibri", 72, MsoTriState.msoFalse, MsoTriState.msoFalse, 0, 0) as Shape;
shape.ZOrder(MsoZOrderCmd.msoBringToFront);

Writing Word Macros, Second Edition非常清楚地说明了这一点:

The ZOrder method sets the z-order of a Shape object relative to other objects. Note that the method does not set the absolute z-order.

因此绝对 Z 顺序取决于其他因素，例如在这种情况下 Shape 实际位于何处。