• Overview
• Pictures
  • Overview
  • Image Properties
    • Image Data
    • Tile or Stretch Image to Fill
    • Effects
  • Non-Visual Properties
  • Shape Properties
• Shapes
  • Overview
  • Non-Visual Properties
  • Visual Properties
    • Size of Bounding Box
    • Location of Bounding Box
    • Geometry
      • Preset
      • Custom
    • Shape Fill
      • Solid Fill
      • Picture Fill
      • Gradient Fill
      • Pattern Fill
      • Group Fill
    • Effects
    • Outline Style
    • 2D Transforms
    • 3-D
      • Shape Properties
      • Scene Properties
  • Styles
  • Text
    • Text Body Properties
      • Positioning and Insets
      • Fit, Wrap, Warp and 3D
      • Columns, Vertical Text and Rotation
    • Paragraphs
      • Paragraph Properties
        • Bullets and Numbering
        • Spacing, Indent and Margins
        • Alignment, Tabs, Other
      • Run Properties
    • List Properties
• Connectors
  • Non-Visual Properties
• Text
• Charts
• Diagrams
• Tables
  • Defining Structure
  • Rows, Cells, Cell Content
  • Cell Properties
    • Alignment, Margins, Direction
    • Borders and Fill
  • Table Styles and Properties
• Placement within Docs
  • Overview
  • Inline Objects
  • Floating Objects
    • Positioning
    • Text Wrapping
• Placement within Spreadsheets
  • Overview
  • Absolute Anchoring
  • One Cell Anchoring
  • Two Cell Anchoring
• Placement within Presentations

DrawingML Pictures

The <pic:nvPicPr> element within the <pic:pic> element specifies the non-visual propeties of a picture. The actual properties are within two child elements - <pic:cNvPr> and <pic:cNvPicPr>.

Note that the non-visual properties are in different namespaces, depending on the document type. The examples show the picture namespace of drawingML, with prefix 'pic'. For presentations the non-visual properties are in the main presentationML namespace with prefix 'p'. And for spreadsheets the namespace is the spreadsheet drawingML namespace with prefix 'xdr'.

Id, Name, Title and Description

An id, name, title and description for a picture can be specified with attributes on the <pic:cNvPr> element: <pic:cNvPr id="222" name="Blue hills.jpg" title="This is the title" descr="This is the description"/>. The id is an integer and specifies a unique identifier. The name is a string and typically stores the original file name. The title is a string that specifies teh caption. The descr is alternative text used for assistive technologies which do not display the picture.

Picture Resizing, Cropping, Rotating, Changing Aspect Ratio, Moving, Selecting

The locking properties of a picture are specified with the <a:picLocks> element within the <pic:cNvPicPr> element. Various aspects of a picture or shape's size can be specified with attributes on <a:picLocks>. If the attributes are not specified, then it is assumed that the properties can be changed. For example, to disallow changing the aspect ratio, specify the noChangeAspect attribute as true.

The following are the most useful attributes:

• noChangeAspect
• noCrop
• noMove
• noResize
• noRot (no rotation)
• noSelect

Note also that the preferRelativeResize attribute on the <pic:cNvPicPr> element specifies whether the user interface should show the resizing of the picture based upon picture's current size (false) or its original size (true).

Hidden

A picture can be hidden by specifying the hidden attribute on the <pic:cNvPr> element: <pic:cNvPr hidden="true">.