<cNvPr> (Non-Visual Drawing Properties)

This element specifies non-visual canvas properties. This allows for additional information that does not affect the appearance of the picture to be stored.

[Example: Consider the following <ChartDrawingML>.

<cdr:pic>
  ..
  <cdr:nvPicPr>
    <cdr:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
  </cdr:nvPicPr>
  ..
</cdr:pic>

End example]

Parent Elements

<nvCxnSpPr> (§5.8.2.15); <nvGraphicFramePr> (§5.8.2.16); <nvGrpSpPr> (§5.8.2.17); <nvPicPr> (§5.8.2.18); <nvSpPr> (§5.8.2.19)

Child Elements

Subclause

<extLst> (Extension List)

§5.1.2.1.15

<hlinkClick> (Click Hyperlink)

§5.1.5.3.5

<hlinkHover> (Hyperlink for Hover)

§5.1.2.1.23

Attributes

Description

<descr> (Alternative Text for Object)

Namespace: .../drawingml/2006/main

Specifies alternative text for the current DrawingML object, for use by assistive technologies or applications which will not display the current object.

If this element is omitted, then no alternative text is present for the parent object.

example: 
<… descr="A picture of a bowl of fruit">

The @descr attribute contains alternative text which may be used in place of the actual DrawingML object. ]

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

<hidden> (Hidden)

Namespace: .../drawingml/2006/main
Specifies whether this DrawingML object shall be displayed. When a DrawingML object is displayed within a document, that object may be hidden (i.e., present, but not visible). This attribute shall determine whether the object shall be rendered or made hidden.
Note: : An application may have settings which allow this object to be viewed.

If this attribute is omitted, then the parent DrawingML object shall be displayed (i.e., not hidden).

example: 
<… hidden="true" />

The @hidden attribute has a value of true, which specifies that the DrawingML object is hidden and not displayed when the document is displayed. ]

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

<id> (Unique Identifier)

Namespace: .../drawingml/2006/main

Specifies a unique identifier for the current DrawingML object within the current document. This ID may be used to assist in uniquely identifying this object so that it can be referred to by other parts of the document.

If multiple objects within the same document share the same @id attribute value, then the document shall be considered non-conformant.

example: 
<… id="10" … >

The @id attribute has a value of 10, which is the unique identifier for this DrawingML object. ]

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

<name> (Name)

Namespace: .../drawingml/2006/main
Specifies the name of the object.
Note: : Typically, this will be used to store the original file name of a picture object.

example: 
< … name="foo.jpg" >

The @name attribute has a value of foo.jpg, which is the name of this DrawingML object. ]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_NonVisualDrawingProps">
	<sequence>
	<element name="hlinkClick" type="CT_Hyperlink" minOccurs="0" maxOccurs="1"/>
	<element name="hlinkHover" type="CT_Hyperlink" minOccurs="0" maxOccurs="1"/>
	<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
	</sequence>
	<attribute name="id" type="ST_DrawingElementId" use="required"/>
	<attribute name="name" type="xsd:string" use="required"/>
	<attribute name="descr" type="xsd:string" use="optional" default=""/>
	<attribute name="hidden" type="xsd:boolean" use="optional" default="false"/>
</complexType>