PlaceholderShape Class

Placeholder Shape.When the object is serialized out as xml, its qualified name is p:ph.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Presentation.PlaceholderShape

Namespace:  DocumentFormat.OpenXml.Presentation
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(ExtensionListWithModification))> _
Public Class PlaceholderShape _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As PlaceholderShape
[ChildElementInfoAttribute(typeof(ExtensionListWithModification))]
public class PlaceholderShape : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • ExtensionListWithModification <p:extLst>

[ISO/IEC 29500-1 1st Edition]

19.3.1.36 ph (Placeholder Shape)

This element specifies that the corresponding shape should be represented by the generating application as a placeholder. When a shape is considered a placeholder by the generating application it can have special properties to alert the user that they can enter content into the shape. Different placeholder types are allowed and can be specified by using the placeholder type attribute for this element.

Parent Elements

nvPr (§19.3.1.33)

Child Elements

Subclause

extLst (Extension List with Modification Flag)

§19.3.1.20

Attributes

Description

hasCustomPrompt (Placeholder has custom prompt)

Specifies whether the corresponding placeholder should have a custom prompt or not.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

idx (Placeholder Index)

Specifies the placeholder index.  This is used when applying templates or changing layouts to match a placeholder on one template/master to another.

The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype.

orient (Placeholder Orientation)

Specifies the orientation of a placeholder.

The possible values for this attribute are defined by the ST_Direction simple type (§19.7.2).

sz (Placeholder Size)

Specifies the size of a placeholder.

The possible values for this attribute are defined by the ST_PlaceholderSize simple type (§19.7.9).

type (Placeholder Type)

Specifies what content type a placeholder is intended to contain.

The possible values for this attribute are defined by the ST_PlaceholderType simple type (§19.7.10).

[Note: The W3C XML Schema definition of this element’s content model (CT_Placeholder) is located in §A.3. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

PlaceholderShape Members

DocumentFormat.OpenXml.Presentation Namespace