Partager via


Picture Class

VML Object.When the object is serialized out as xml, its qualified name is w:pict.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Wordprocessing.Picture

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(PolyLine))> _
<ChildElementInfoAttribute(GetType(Control))> _
<ChildElementInfoAttribute(GetType(MovieReference))> _
<ChildElementInfoAttribute(GetType(OleObject))> _
<ChildElementInfoAttribute(GetType(Curve))> _
<ChildElementInfoAttribute(GetType(Arc))> _
<ChildElementInfoAttribute(GetType(Oval))> _
<ChildElementInfoAttribute(GetType(Shapetype))> _
<ChildElementInfoAttribute(GetType(ImageFile))> _
<ChildElementInfoAttribute(GetType(Line))> _
<ChildElementInfoAttribute(GetType(Group))> _
<ChildElementInfoAttribute(GetType(Rectangle))> _
<ChildElementInfoAttribute(GetType(RoundRectangle))> _
<ChildElementInfoAttribute(GetType(Shape))> _
Public Class Picture _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As Picture
[ChildElementInfoAttribute(typeof(PolyLine))]
[ChildElementInfoAttribute(typeof(Control))]
[ChildElementInfoAttribute(typeof(MovieReference))]
[ChildElementInfoAttribute(typeof(OleObject))]
[ChildElementInfoAttribute(typeof(Curve))]
[ChildElementInfoAttribute(typeof(Arc))]
[ChildElementInfoAttribute(typeof(Oval))]
[ChildElementInfoAttribute(typeof(Shapetype))]
[ChildElementInfoAttribute(typeof(ImageFile))]
[ChildElementInfoAttribute(typeof(Line))]
[ChildElementInfoAttribute(typeof(Group))]
[ChildElementInfoAttribute(typeof(Rectangle))]
[ChildElementInfoAttribute(typeof(RoundRectangle))]
[ChildElementInfoAttribute(typeof(Shape))]
public class Picture : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • DocumentFormat.OpenXml.Vml.Group <v:group>

  • DocumentFormat.OpenXml.Vml.ImageFile <v:image>

  • DocumentFormat.OpenXml.Vml.Line <v:line>

  • DocumentFormat.OpenXml.Vml.Oval <v:oval>

  • DocumentFormat.OpenXml.Vml.PolyLine <v:polyline>

  • DocumentFormat.OpenXml.Vml.Rectangle <v:rect>

  • DocumentFormat.OpenXml.Vml.RoundRectangle <v:roundrect>

  • DocumentFormat.OpenXml.Vml.Shape <v:shape>

  • DocumentFormat.OpenXml.Vml.Shapetype <v:shapetype>

  • DocumentFormat.OpenXml.Vml.Arc <v:arc>

  • DocumentFormat.OpenXml.Vml.Curve <v:curve>

  • DocumentFormat.OpenXml.Vml.Office.OleObject <o:OLEObject>

  • MovieReference <w:movie>

  • Control <w:control>

[ISO/IEC 29500-1 1st Edition]

9.2.2.2 pict (VML Object)

This element specifies that an object is located at this position in the run’s contents. The layout properties of this object are specified using the VML syntax (§14.1).

[Example: Consider a run which consists of an object specified using VML. That run would be specified using the following WordprocessingML:

<w:r>
<w:pict>
…
</w:pict>
</w:r>

The pict element indicates that an object specified in VML is located at the current position in the run (e.g. a floating embedded control). end example]

Parent Elements

r (Part 1, §22.1.2.87); r (Part 1, §17.3.2.25)

Child Elements

Subclause

control (Floating Embedded Control)

§9.2.2.1

movie (Embedded Video)

Part 1, §17.3.3.17

Any element in the urn:schemas-microsoft-com:vml namespace

§14.1

Any element in the urn:schemas-microsoft-com:office:office namespace

§14.2

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

[ISO/IEC 29500-1 1st Edition]

9.5.1 pict (Picture Numbering Symbol Properties)

This element specifies the properties for a picture which shall be used as a picture numbering symbol in a given document, using the VML syntax.

[Example: Consider the WordprocessingML below illustrating the usage of the pict element in a document containing a single picture numbering symbol:

<w:numPicBullet w:numPicBulletId="0">
  <w:pict>
    <v:shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f">
      <v:stroke joinstyle="miter" />
      <v:formulas>
        <v:f eqn="if lineDrawn pixelLineWidth 0" />
        <v:f eqn="sum @0 1 0" />
        <v:f eqn="sum 0 0 @1" />
        <v:f eqn="prod @2 1 2" />
        <v:f eqn="prod @3 21600 pixelWidth" />
        <v:f eqn="prod @3 21600 pixelHeight" />
        <v:f eqn="sum @0 0 1" />
        <v:f eqn="prod @6 1 2" />
        <v:f eqn="prod @7 21600 pixelWidth" />
        <v:f eqn="sum @8 21600 0" />
        <v:f eqn="prod @7 21600 pixelHeight" />
        <v:f eqn="sum @10 21600 0" />
      </v:formulas>
      <v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect" />
      <o:lock v:ext="edit" aspectratio="t" />
    </v:shapetype>
    <v:shape id="_x0000_i1029" type="#_x0000_t75" style="width:11.25pt;height:11.25pt" o:bullet="t">
      <v:imagedata r:id="rId1" o:title="sample picture" />
    </v:shape>
  </w:pict>
</w:numPicBullet>

end example]

Parent Elements

numPicBullet (Part 1, §17.9.21)

Child Elements

Subclause

control (Floating Embedded Control)

§9.2.2.1

movie (Embedded Video)

Part 1, §17.3.3.17

Any element in the urn:schemas-microsoft-com:vml namespace

§14.1

Any element in the urn:schemas-microsoft-com:office:office namespace

§14.2

[Note: The W3C XML Schema definition of this element’s content model (CT_Picture) is located in §A.1. 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

Picture Members

DocumentFormat.OpenXml.Wordprocessing Namespace