Share via


NonVisualInkProperties Class

Defines the NonVisualInkProperties Class.This class is only available in Office2010.When the object is serialized out as xml, its qualified name is a14:cNvInkPr.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Office2010.Drawing.NonVisualInkContentPartPropertiesType
        DocumentFormat.OpenXml.Office2010.Drawing.NonVisualInkProperties

Namespace:  DocumentFormat.OpenXml.Office2010.Drawing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<OfficeAvailabilityAttribute(FileFormatVersions.Office2010)> _
Public Class NonVisualInkProperties _
    Inherits NonVisualInkContentPartPropertiesType
'Usage
Dim instance As NonVisualInkProperties
[OfficeAvailabilityAttribute(FileFormatVersions.Office2010)]
public class NonVisualInkProperties : NonVisualInkContentPartPropertiesType

Remarks

The following table lists the possible child types:

  • ContentPartLocks <a14:cpLocks>

  • OfficeArtExtensionList <a14:extLst>

2.5.42 CT_NonVisualInkContentPartProperties

Target namespace: https://schemas.microsoft.com/office/drawing/2007/7/7/main

Referenced by: CT_WordContentPartNonVisual, CT_GvmlContentPartNonVisual, CT_ContentPartNonVisual

A complex type that specifies non-visual ink properties for a content part. This allows for additional information that does not affect the appearance of ink in the content part to be stored.

Child Elements:

cpLocks : A CT_ContentPartLocking element that specifies various "locking" properties that prevent or restrict certain changes to the content part properties or restrict how a content part can be manipulated by the user.

extLst : A CT OfficeArtExtensionList ([ISO/IEC-29500-1] section A.4.1) element that specifies the extension list within which all future extensions of element type ext is defined. The extension list along with corresponding future extensions is used to extend the storage capabilities of the DrawingML framework. This allows for various new types of data to be stored natively within the framework.

Attributes:

spid : An xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the shape ID of a legacy drawing object.

This string has the following characteristics:

It begins with “_x0000_” followed by 1 character and a number that specifies the ID: _x0000_[c]<shape id>

The character [c] MUST be ‘s’.

Shape IDs MUST be between 1025 and 268435456.

Shape IDs are clustered together, and each cluster has 1024 values.  The first cluster ranges from 1025 to 2048.

Shape IDs within the same cluster SHOULD only exist in one worksheet.

It MUST NOT contain NCR (Numeric Character Reference) characters.

chksum : An ST_CHECKSUM attribute that gives a checksum value that can be used if to tell if the corresponding ink data has changed since the checksum was computed. <10>

isComment : A boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies if the ink shape a comment or annotation. If the value is true, then the ink is a comment, otherwise it is an annotation.

The following W3C XML Schema ([XMLSCHEMA1] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_NonVisualInkContentPartProperties">

<xsd:sequence>

<xsd:element name="cpLocks" type="CT_ContentPartLocking" minOccurs="0" maxOccurs="1"/>

<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>

</xsd:sequence>

<xsd:attribute name="spid" type="xsd:string" use="optional"/>

<xsd:attribute name="chksum" type="ST_CHECKSUM" use="optional"/>

<xsd:attribute name="isComment" type="xsd:boolean" use="optional" default="true"/>

</xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1] section 2.1).

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

NonVisualInkProperties Members

DocumentFormat.OpenXml.Office2010.Drawing Namespace