Version

Visual Elements Overview (xamDiagram)

Topic Overview

Introduction

Visual elements summary

The xamDiagram control exposes the following basic visual elements:

  • A diagram surface

  • Diagram nodes

  • Diagram nodes’ connections

The nodes and the connections, collectively known as “diagram items” are rendered within the diagram surface.

Additional visual elements are the:

  • Navigation pane – a reduced-size overview of its full content in a separate pane positioned inside the diagram space, by default at its bottom-right corner. The Navigation pane is implemented through an internal control ( xamOverviewPlusDetailPane™)

  • Toolbox – a control that allows adding items to the diagram via drag-and-drop. The Toolbox is implemented through the xamDiagramToolbox™ control.

Visual Elements of the Diagram and Related Properties

Diagram’s visual elements summary

The following screenshot shows the visual elements of the diagram. The configurable elements are listed after the image.

xamDiagram Visual Elements Overview 1.png

Diagram’s visual elements and related properties

The following table maps the visual elements of the XamDiagram control and the properties that configure them.

# Visual Element Property

1

Node

2

Connection

3

Navigation pane ( XamOverviewPlusDetailPane control)

4

Options pane button

Visual Elements of the Diagram Nodes and Related Properties

Nodes’ visual elements summary

The following screenshot depicts the visual elements of diagram nodes. The configurable elements are listed after the image.

xamDiagram Visual Elements Overview 2.png

Nodes’ visual elements and related properties

The following table maps the visual elements of DiagramNodes and the properties that configure them.

# Visual Element API Members

1

Content

2

Resize handle

3

Connection point

Nodes’ default sizes

The following table summarizes the default node sizes in pixels. The default sizes vary depending on the node’s shape. (The default sizes are in effect if no explicit overriding has been applied to a node.)

Node shape Width Height

Chevron

80

80

Circle

80

80

Cross, thick

80

80

Cross, thin

80

80

Ellipse

120

80

Heptagon

80

80

Hexagon

92

80

None

NaN

NaN

Octagon

80

80

Pentagon

84

80

Rectangle

120

80

Rectangle, rounded

120

80

Rhombus

80

80

Square

80

80

Triangle

80

80

Triangle, right-angled, with the right angle pointing at 45 degrees downward-left

120

80

Triangle, right-angled, with the right angle pointing at 45 degrees downward-right

120

80

Note
Note:

Content overflows if the value of the node’s Content property does not fit within the borders of the node.

Visual Elements of the Diagram Connections and Related Properties

Connections’ visual elements summary

The following screenshot depicts the visual elements of the diagram connections. The configurable elements are listed after the image.

xamDiagram Visual Elements Overview 3.png

Connections’ visual elements and related properties

The following table maps the visual elements of the DiagramConnections and the properties that configure them.

# Visual Element API Members

1

Start cap

2

End cap

3

Content

4

Connection handle

Visual Elements of the Toolbox and Related Properties

Toolbox visual elements summary

The xamDiagramToolbox provides functionality for adding items to the xamDiagram via drag-drop. This control consists of a header and several categories (2 by default). Each of the categories has its own header is capable of containing any number of items representing a diagram item and a caption. The following screenshot shows the visual elements of the XamDiagramToolbox control. The configurable elements are listed after the image.

xamDiagram Visual Elements Overview 5.png

Toolbox visual elements and related properties

The following table maps the visual elements of the XamDiagramToolbox control and the properties that configure them.

# Visual Element Property

1

Header

2

Toolbox item

3

Toolbox item diagram item

4

Toolbox item title

5

Category

6

Category name

Related Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic explains how to add the xamDiagram control to a WPF application.

This topic provides an overview of the data binding scenarios supported by the xamDiagram control.

The topics in this group explain how to configure the nodes of the xamDiagram control.

The topics in this group explain how to configure the connections of the xamDiagram control.

This topic explains how to configure the Navigation pane of the xamDiagram control.

This topic explains how to configure and use the xamDiagram diagram toolbox.