Class ThermalLabelEditor

ThermalLabelEditor lets end-users to graphically design barcode thermal labels inside your Windows Forms applications.

Inheritance

System.Object

ThermalLabelEditor

Namespace: Neodynamic.Windows.Forms.ThermalLabelEditor

Assembly: cs.temp.dll.dll

Syntax

public class ThermalLabelEditor : Control

Constructors

ThermalLabelEditor()

Declaration

public ThermalLabelEditor()

Properties

ActiveTool

Gets or sets the current active tool of the editor. Default is the Pointer tool used for selection action mainly.

Declaration

public EditorTool ActiveTool { get; set; }

Property Value

Type	Description
EditorTool

ActiveToolItem

Gets or sets the Item object which is added to the editor's surface by the end-user.

Declaration

public Item ActiveToolItem { get; set; }

Property Value

Type	Description
Item

Remarks

The Item object specified by this property must match the type which is currently set up to the ActiveTool property. For example, if the ActiveTool is set up to Text, then a new TextItem object needs to be specified to the ActiveToolItem property.

AdornerFrameBorderColor

Gets or sets the border color for the adorner's frame. Default is Black.

Declaration

public Drawing.Color AdornerFrameBorderColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AdornerHandlerBackColor

Gets or sets the background color for the adorner's handlers. Default is Green.

Declaration

public Drawing.Color AdornerHandlerBackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AdornerHandlerBorderColor

Gets or sets the border color for the adorner's handlers. Default is Black.

Declaration

public Drawing.Color AdornerHandlerBorderColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AdornerHandlerHoverBackColor

Gets or sets the background color for the adorner's handlers when the mouse pointer is over them. Default is Red.

Declaration

public Drawing.Color AdornerHandlerHoverBackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AdornerLegendsVisible

Gets or sets whether the text legends of adorners are visible or not. Default is true.

Declaration

public bool AdornerLegendsVisible { get; set; }

Property Value

Type	Description
System.Boolean

AdornerOutOfLabelColor

Gets or sets the color for the out of label adorner's frame. Default is Red.

Declaration

public Drawing.Color AdornerOutOfLabelColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AdornerOutOfLabelVisible

Gets or sets whether the out of label adorner are visible or not. Default is true.

Declaration

public bool AdornerOutOfLabelVisible { get; set; }

Property Value

Type	Description
System.Boolean

AdornerSelectionBackColor

Gets or sets the background color for the selection adorner's frame.

Declaration

public Drawing.Color AdornerSelectionBackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AdornerSelectionBorderColor

Gets or sets the border color for the selection adorner's frame.

Declaration

public Drawing.Color AdornerSelectionBorderColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

AllowPartialHitTestSelection

Gets or sets whether to allow partial hit test selection. Default is false.

Declaration

public bool AllowPartialHitTestSelection { get; set; }

Property Value

Type	Description
System.Boolean

AngleSnap

Gets or sets the angle snap used for items' rotation. Default is 5 degrees.

Declaration

public int AngleSnap { get; set; }

Property Value

Type	Description
System.Int32

ArrowKeysLargeStep

Gets or sets the large step size in current unit when any of the arrow keys and the control key are pressed. Default is 0.1 inch.

Declaration

public double ArrowKeysLargeStep { get; set; }

Property Value

Type	Description
System.Double

ArrowKeysShortStep

Gets or sets the short step size in current unit when any of the arrow keys are pressed. Default is 0.01 inch.

Declaration

public double ArrowKeysShortStep { get; set; }

Property Value

Type	Description
System.Double

CanCopy

Gets whether a Clipboard Copy action can be performed.

Declaration

public bool CanCopy { get; }

Property Value

Type	Description
System.Boolean

CanCut

Gets whether a Clipboard Cut action can be performed.

Declaration

public bool CanCut { get; }

Property Value

Type	Description
System.Boolean

CanPaste

Gets whether a Clipboard Paste action can be performed.

Declaration

public bool CanPaste { get; }

Property Value

Type	Description
System.Boolean

CanRedo

Gets whether the Redo action is available.

Declaration

public bool CanRedo { get; }

Property Value

Type	Description
System.Boolean

CanUndo

Gets whether the Undo action is available.

Declaration

public bool CanUndo { get; }

Property Value

Type	Description
System.Boolean

CurrentSelection

Gets the current selected item on the editor.

Declaration

public Item CurrentSelection { get; }

Property Value

Type	Description
Item

Remarks

This property returns an Item-derived class representing the current selection on the editor.

If the selection is just one item only, then the returned object will be the Item-derived class of such object. For exmaple, if a Rectangle item is selected, then the returned object will be a RectangleShapeItem instance.

If the selection contains more than one item, then the returned object will be an instance of the MultipleSelectionItem class. The MultipleSelectionItem class contains some properties that are common to most Item-derived classes. That means that some properties of such class are common to all Item-derived classes, for example, the X and Y properties. Notice that the MultipleSelectionItem class also contains some properties that are common for a group of Item-derived classes and not to all. For example, the Font property is valid for TextItem and BarcodeItem object only.

CurrentSelectionArea

Gets the location and size of the current selected items on the editor.

Declaration

public RectangleF CurrentSelectionArea { get; }

Property Value

Type	Description
RectangleF

DisableClipboard

Gets or sets whether the internal clipboard actions are recorded. Default is false.

Declaration

public bool DisableClipboard { get; set; }

Property Value

Type	Description
System.Boolean

DisableShortcuts

Gets or sets the keyboard shortcuts to be disabled. Default is None.

Declaration

public KeyboardShortcuts DisableShortcuts { get; set; }

Property Value

Type	Description
KeyboardShortcuts

GridColor

Gets or sets the grid color.

Declaration

public Drawing.Color GridColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

GridSize

Gets or sets the size of the grid in current unit. Default is zero.

Declaration

public double GridSize { get; set; }

Property Value

Type	Description
System.Double

IconComment

Gets or sets the base64 icon image (12x12) for Comments in items.

Declaration

public static string IconComment { get; set; }

Property Value

Type	Description
System.String

IconDataBound

Gets or sets the base64 icon image (12x12) for Data Bound items.

Declaration

public static string IconDataBound { get; set; }

Property Value

Type	Description
System.String

IconExpression

Gets or sets the base64 icon image (12x12) for Expressions in items.

Declaration

public static string IconExpression { get; set; }

Property Value

Type	Description
System.String

IconLocked

Gets or sets the base64 icon image (12x12) for Locked items.

Declaration

public static string IconLocked { get; set; }

Property Value

Type	Description
System.String

IconNonEditable

Gets or sets the base64 icon image (12x12) for Non Editable items.

Declaration

public static string IconNonEditable { get; set; }

Property Value

Type	Description
System.String

IconNotVisible

Gets or sets the base64 icon image (12x12) for Not Visible items.

Declaration

public static string IconNotVisible { get; set; }

Property Value

Type	Description
System.String

IconReadOnly

Gets or sets the base64 icon image (12x12) for Read Only items.

Declaration

public static string IconReadOnly { get; set; }

Property Value

Type	Description
System.String

ImageProcessingDpi

Gets or sets the DPI value which will be used for processing the ImageItem objects on the editor's surface. Default is 96 dpi.

Declaration

public double ImageProcessingDpi { get; set; }

Property Value

Type	Description
System.Double

ItemToolTipBackColor

Gets or sets the background color of the Item tooltip. Default is #F5F5F5.

Declaration

public Drawing.Color ItemToolTipBackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

ItemToolTipBorderColor

Gets or sets the border color of the Item tooltip. Default is #808080.

Declaration

public Drawing.Color ItemToolTipBorderColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

ItemToolTipForeColor

Gets or sets the foreground color of the Item tooltip. Default is Black.

Declaration

public Drawing.Color ItemToolTipForeColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

LabelDocument

Gets the LabelDocument object that represents a ThermalLabel object on the editor's surface.

Declaration

public LabelDocument LabelDocument { get; }

Property Value

Type	Description
LabelDocument

Remarks

The LabelDocument object is a lightweight version of the ThermalLabel class and is automatically created when you load a ThermalLabel object through the LoadThermalLabel() method.

LabelDocumentFrameBackColor

Gets or sets the background color for the label document frame on the editor's surface. Default is White.

Declaration

public Drawing.Color LabelDocumentFrameBackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

LabelDocumentFrameBackgroundImage

Gets or sets the background image for the label document frame on the editor's surface. Default is empty.

Declaration

public string LabelDocumentFrameBackgroundImage { get; set; }

Property Value

Type	Description
System.String

LabelDocumentFrameBorderColor

Gets or sets the border color for the label document frame on the editor's surface. Default is White.

Declaration

public Drawing.Color LabelDocumentFrameBorderColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

LabelDocumentFrameBorderThickness

Gets or sets the thickness of the label document frame's border on the editor's surface. Default is 0.5.

Declaration

public double LabelDocumentFrameBorderThickness { get; set; }

Property Value

Type	Description
System.Double

LabelDocumentFrameCornerRadius

Gets or sets the radii of the corners of the label document frame. Default value is 10.

Declaration

public double LabelDocumentFrameCornerRadius { get; set; }

Property Value

Type	Description
System.Double

LicenseKey

Gets or sets the license key info.

Declaration

public static string LicenseKey { get; set; }

Property Value

Type	Description
System.String

LicenseOwner

Gets or sets the license owner info.

Declaration

public static string LicenseOwner { get; set; }

Property Value

Type	Description
System.String

NoImageFileName

Gets or sets the image file name to display on the editor's surface when the source of an ImageItem cannot be found.

Declaration

public string NoImageFileName { get; set; }

Property Value

Type	Description
System.String

RefIconsOpacity

Gets or sets the opacity factor applied to all the reference icons used by the editor. A value of 0.0 makes the icons completely transparent, while a value of 1.0 makes the icons completely opaque. Default is 1.0.

Declaration

public double RefIconsOpacity { get; set; }

Property Value

Type	Description
System.Double

RFIDTagImageFileName

Gets or sets the image file name to display on the editor's surface for a RFIDTagItem.

Declaration

public string RFIDTagImageFileName { get; set; }

Property Value

Type	Description
System.String

RulerBackColor

Gets or sets the background color for the editor's rulers. Default is SystemColors.Control

Declaration

public Drawing.Color RulerBackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

RulerForeColor

Gets or sets the foreground color for the number tags of the editor's rulers.

Declaration

public Drawing.Color RulerForeColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

RulerLinesColor

Gets or sets the color for the lines which compose the editor's rulers.

Declaration

public Drawing.Color RulerLinesColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

RulerSelectionColor

Gets or sets the background color for the selection zone of the editor's rulers.

Declaration

public Drawing.Color RulerSelectionColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

ShowFocusCues

Declaration

protected override bool ShowFocusCues { get; }

Property Value

Type	Description
System.Boolean

ShowGrid

Gets or sets whether grid is displayed. Default is false.

Declaration

public bool ShowGrid { get; set; }

Property Value

Type	Description
System.Boolean

SnapToGrid

Gets or sets whether items will be placed and sized according to the divisions of the grid. Default is false.

Declaration

public bool SnapToGrid { get; set; }

Property Value

Type	Description
System.Boolean

TextItemEditModeEnabled

Gets or sets whether TextItem objects can enter in Edit Mode. Default is true.

Declaration

public bool TextItemEditModeEnabled { get; set; }

Property Value

Type	Description
System.Boolean

ViewRotation

Gets the current editor view's rotation.

Declaration

public Rotate ViewRotation { get; }

Property Value

Type	Description
Rotate

Zoom

Gets or sets the zoom percentage level of the editor's content. The valid range for zoom is 10% - 1000%. Default is 100 which means normal size.

Declaration

public double Zoom { get; set; }

Property Value

Type	Description
System.Double

Methods

AddItem(Item)

Adds an Item to the end of the items collection of the current label.

Declaration

public void AddItem(Item item)

Parameters

Type	Name	Description
Item	item	The item to add.

BringForward()

Brings the selected items one step closer to the front of the label surface.

Declaration

public void BringForward()

BringToFront()

Brings the selected items to the front of the label surface.

Declaration

public void BringToFront()

ClipboardClear()

Removes all data from the internal Clipboard.

Declaration

public void ClipboardClear()

Close()

Closes the current label document.

Declaration

public void Close()

Copy()

Copies the current selection in the editor to the internal Clipboard.

Declaration

public void Copy()

CreateThermalLabel()

Creates a ThermalLabel object based on the current LabelDocument data and visual items.

Declaration

public ThermalLabel CreateThermalLabel()

Returns

Type	Description
ThermalLabel	A ThermalLabel object.

Cut()

Cuts the current selection in the editor and moves it to the internal Clipboard.

Declaration

public void Cut()

DeleteAll()

Deletes all the items on the editor's surface.

Declaration

public void DeleteAll()

DeleteSelectedItems()

Deletes the selected items on the editor's surface.

Declaration

public void DeleteSelectedItems()

Dispose(Boolean)

Declaration

protected override void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing

EnableEditor()

Enables the ThermalLabelEditor. Invoke it in the Form_Load event of the parent form hosting the editor.

Declaration

public void EnableEditor()

Group()

Groups all the selected items on the editor's surface.

Declaration

public void Group()

InsertItem(Int32, Item)

Inserts an Item into the current label at the specified index.

Declaration

public void InsertItem(int index, Item item)

Parameters

Type	Name	Description
System.Int32	index	The zero-based index at which the item should be inserted.
Item	item	The item to insert.

LayoutSelectedItems(LayoutAlignment)

Performs the specified layout alignment option on the selectd items.

Declaration

public void LayoutSelectedItems(LayoutAlignment layoutAlignment)

Parameters

Type	Name	Description
LayoutAlignment	layoutAlignment	The layout alignment option.

LoadThermalLabel(ThermalLabel)

Loads the specified ThermalLabel object on the editor's surface.

Declaration

public void LoadThermalLabel(ThermalLabel thermalLabel)

Parameters

Type	Name	Description
ThermalLabel	thermalLabel	A ThermalLabel object.

LockSelectedItems()

Locks all the items in the current selection.

Declaration

public void LockSelectedItems()

MoveSelectedItems(Double, Double)

Moves the selected items by the specified horizontal and vertical offsets.

Declaration

public void MoveSelectedItems(double deltaX, double deltaY)

Parameters

Type	Name	Description
System.Double	deltaX	The horizontal (X-axis) offset.
System.Double	deltaY	The vertical (Y-axis) offset.

OnPaint(PaintEventArgs)

Declaration

protected override void OnPaint(PaintEventArgs e)

Parameters

Type	Name	Description
PaintEventArgs	e

Paste()

Pastes the content of the internal Clipborad on the editor surface.

Declaration

public void Paste()

Redo()

Performs a Redo action.

Declaration

public void Redo()

RotateLabel(ThermalLabel, Rotate, Rotate)

Rotates a ThermalLabel object.

Declaration

public ThermalLabel RotateLabel(ThermalLabel thermalLabel, Rotate currentRotateView, Rotate newRotateView)

Parameters

Type	Name	Description
ThermalLabel	thermalLabel	The ThermalLabel object.
Rotate	currentRotateView	The current RotateView.
Rotate	newRotateView	The new RotateView.

Returns

Type	Description
ThermalLabel	Returns a rotated version of the specified ThermalLabel object.

RotateView(Rotate)

Rotates the editor view to the specified rotation value.

Declaration

public void RotateView(Rotate viewRotation)

Parameters

Type	Name	Description
Rotate	viewRotation	The view's rotation

Save(Stream, Boolean)

Saves the ThermalLabel object in XML format based on the current LabelDocument data and visual items to the specified stream.

Declaration

public void Save(Stream stream, bool keepViewRotation = false)

Parameters

Type	Name	Description
System.IO.Stream	stream	The stream where the ThermalLabel object will be saved.
System.Boolean	keepViewRotation	If true, the ThermalLabel object will be saved with the current view rotation applied.

Save(String, Boolean)

Saves the ThermalLabel object in XML format based on the current LabelDocument data and visual items to the specified file name.

Declaration

public void Save(string fileName, bool keepViewRotation = false)

Parameters

Type	Name	Description
System.String	fileName	A string that contains the name of the file (full path) to which to save the ThermalLabel object.
System.Boolean	keepViewRotation	If true, the ThermalLabel object will be saved with the current view rotation applied.

SaveAsJson(Stream, Boolean)

Saves the ThermalLabel object in JSON format based on the current LabelDocument data and visual items to the specified stream.

Declaration

public void SaveAsJson(Stream stream, bool keepViewRotation = false)

Parameters

Type	Name	Description
System.IO.Stream	stream	The stream where the ThermalLabel object will be saved.
System.Boolean	keepViewRotation	If true, the ThermalLabel object will be saved with the current view rotation applied.

SaveAsJson(String, Boolean)

Saves the ThermalLabel object in JSON format based on the current LabelDocument data and visual items to the specified file name.

Declaration

public void SaveAsJson(string fileName, bool keepViewRotation = false)

Parameters

Type	Name	Description
System.String	fileName	A string that contains the name of the file (full path) to which to save the ThermalLabel object.
System.Boolean	keepViewRotation	If true, the ThermalLabel object will be saved with the current view rotation applied.

SelectAll()

Selects all the items on the editor's surface.

Declaration

public void SelectAll()

SelectItemByIndex(Int32)

Selects an item by its index number (zero-based) on the editor's surface.

Declaration

public void SelectItemByIndex(int itemIndex)

Parameters

Type	Name	Description
System.Int32	itemIndex	The index of the item to be selected.

SelectItemByName(String)

Selects an item by its name on the editor's surface.

Declaration

public void SelectItemByName(string itemName)

Parameters

Type	Name	Description
System.String	itemName	The name of the item to be selected.

SelectItemsByNames(String[])

Selects a set of items by their names on the editor's surface.

Declaration

public void SelectItemsByNames(string[] itemNames)

Parameters

Type	Name	Description
System.String[]	itemNames	The names of the items to be selected.

SelectItemsByTag(String)

Selects all the items matching the specified tag on the editor's surface.

Declaration

public void SelectItemsByTag(string tag)

Parameters

Type	Name	Description
System.String	tag	The tag of the items to be selected.

SelectItemsByType(String)

Selects all the items matching the specified Item Type on the editor's surface.

Declaration

public void SelectItemsByType(string itemType)

Parameters

Type	Name	Description
System.String	itemType	The Item Type of the items to be selected. Valid values are TextItem, BarcodeItem, ImageItem i.e. any class name derived from Item class.

SendBackward()

Sends the selected items one step toward the background of the label surface.

Declaration

public void SendBackward()

SendToBack()

Sends the selected items to the background of the label surface.

Declaration

public void SendToBack()

SetSelectedItemsToSameSize(Boolean, Boolean)

Sets the selected items to the same size of the first item.

Declaration

public void SetSelectedItemsToSameSize(bool sameWidth, bool sameHeight)

Parameters

Type	Name	Description
System.Boolean	sameWidth	Set items size to the same width.
System.Boolean	sameHeight	Set items size to the same height.

SnapToGridAll()

It places and sizes all the Items according to the divisions of the grid.

Declaration

public void SnapToGridAll()

SnapToGridByCurrentSelection()

It places and sizes the current selected Items according to the divisions of the grid.

Declaration

public void SnapToGridByCurrentSelection()

SnapToGridByItemIndex(Int32)

It places and sizes the specified Item (by its index) according to the divisions of the grid.

Declaration

public void SnapToGridByItemIndex(int itemIndex)

Parameters

Type	Name	Description
System.Int32	itemIndex	The item index.

SnapToGridByItemName(String)

It places and sizes the specified Item (by its name) according to the divisions of the grid.

Declaration

public void SnapToGridByItemName(string itemName)

Parameters

Type	Name	Description
System.String	itemName	The item name.

Undo()

Performs an Undo action.

Declaration

public void Undo()

Ungroup()

Ungroups all the selected items on the editor's surface.

Declaration

public void Ungroup()

UnlockSelectedItems()

Unlocks all the items in the current selection.

Declaration

public void UnlockSelectedItems()

UnselectAll()

Unselects all the selected items on the editor's surface.

Declaration

public void UnselectAll()

UpdateLabelDocument(LabelDocument)

Updates the LabelDocument object on the editor's surface.

Declaration

public void UpdateLabelDocument(LabelDocument fromLabelDocument)

Parameters

Type	Name	Description
LabelDocument	fromLabelDocument	The LabelDocument that the current LabelDocument on the editor's surface will be updated from.

UpdateLabelDocument(SDK.Printing.UnitType, Double, Double, Int32)

Updates the LabelDocument object on the editor's surface.

Declaration

public void UpdateLabelDocument(SDK.Printing.UnitType unit, double width, double height, int numOfFractionalDigits)

Parameters

Type	Name	Description
SDK.Printing.UnitType	unit	The Unit of Measurement for the label document.
System.Double	width	The width of the label document.
System.Double	height	The height of the label document.
System.Int32	numOfFractionalDigits	The number of fractional digits to use with all floating-point values related to the label document.

UpdateLabelDocument(SDK.Printing.UnitType, Double, Double, Int32, Double, Double, Double, Int32, Double, Boolean, Double, Double, Int32, FrameThickness, String, Collection<ThermalLabelPage>)

Updates the LabelDocument object on the editor's surface.

Declaration

public void UpdateLabelDocument(SDK.Printing.UnitType unit, double width, double height, int numOfFractionalDigits, double gapLength, double markLength, double offsetLength, int labelsPerRow, double labelsHorizontalGapLength, bool isContinuous, double sheetLabelsWidth, double sheetLabelsHeight, int sheetLabelsCount, FrameThickness sheetLabelsMargin, string designBackgroundImage = "", Collection<ThermalLabelPage> pages = null)

Parameters

Type	Name	Description
SDK.Printing.UnitType	unit	The Unit of Measurement for the label document.
System.Double	width	The width of the label document.
System.Double	height	The height of the label document.
System.Int32	numOfFractionalDigits	The number of fractional digits to use with all floating-point values related to the label document.
System.Double	gapLength	The vertical gap length between labels.
System.Double	markLength	The mark length or thickness between labels.
System.Double	offsetLength	The offset length or thickness between labels.
System.Int32	labelsPerRow	The number of labels per row in the media roll.
System.Double	labelsHorizontalGapLength	The horizontal gap length between labels when the media roll contains more than one label per row.
System.Boolean	isContinuous	Whether this document is on a continuous media roll i.e. labels are not separated by gaps, spaces, notches, slots, or holes.
System.Double	sheetLabelsWidth	The width of the Sheet Labels where this thermal label is part of.
System.Double	sheetLabelsHeight	The height of the Sheet Labels where this thermal label is part of.
System.Int32	sheetLabelsCount	The total number individual labels of the Sheet Labels where this thermal label is part of.
FrameThickness	sheetLabelsMargin	The margin of the Sheet Labels where this thermal label is part of.
System.String	designBackgroundImage	A non-printing background image that assists you in the design of your labels through the visual editors. Image must be specified in Base64 format.
Collection<ThermalLabelPage>	pages	A collection of ThermalLabelPage objects representing the pages within this thermal label object.

UpdateSelectionItemsProperties()

Updates the properties of the selected items on the editor's surface.

Declaration

public void UpdateSelectionItemsProperties()

Remarks

When you present the selected items' properties to the end-user through some UI like a PropertyGrid control, a dialog box, etc. and the user modifies them, you must call this method so the changes are reflected on the selected items on the editor's surface.

ValidateOutOfLabelItems()

Validates whether Items are inside label boundary or not.

Declaration

public bool ValidateOutOfLabelItems()

Returns

Type	Description
System.Boolean	Returns true if any Item is out of the label boundary; otherwise false.

Events

ClipboardStateChanged

Occurs when the state of the internal Clipboard changes.

Declaration

public event EventHandler ClipboardStateChanged

Event Type

Type	Description
System.EventHandler

Remarks

Handle this event to update the state of the classic Copy, Cut and Paste buttons of the UI by using the CanCopy, CanCut and CanPaste properties.

CurrentSelectionAfterDelete

Occurs just after the current item selection was deleted from the editor's surface.

Declaration

public event EventHandler CurrentSelectionAfterDelete

Event Type

Type	Description
System.EventHandler

CurrentSelectionBeforeDelete

Occurs just before the current item selection is being deleted from the editor's surface.

Declaration

public event CancelEventHandler CurrentSelectionBeforeDelete

Event Type

Type	Description
CancelEventHandler

CurrentSelectionTextChanged

Occurs when text content changes in the current selected TextItem.

Declaration

public event TextChangedEventHandler CurrentSelectionTextChanged

Event Type

Type	Description
TextChangedEventHandler

NewItemCreated

Occurs when a new item is created on the editor's surface.

Declaration

public event EventHandler NewItemCreated

Event Type

Type	Description
System.EventHandler

SelectionAreaChanged

Occurs when the editor's selection area changes.

Declaration

public event EventHandler SelectionAreaChanged

Event Type

Type	Description
System.EventHandler

Remarks

Handle this event to present the selection's location and size to the end-user by using the CurrentSelectionArea property.

SelectionChanged

Occurs when the editor's selection changes.

Declaration

public event EventHandler SelectionChanged

Event Type

Type	Description
System.EventHandler

Remarks

Handle this event to present the selection data to the end-user by using the CurrentSelection property.

SelectionItemPropertyChanged

Occurs when any property of the selected item changes.

Declaration

public event EventHandler SelectionItemPropertyChanged

Event Type

Type	Description
System.EventHandler

UndoStateChanged

Occurs when the undo state of the editor changes.

Declaration

public event EventHandler UndoStateChanged

Event Type

Type	Description
System.EventHandler

Remarks

Handle this event to update the Undo and Redo buttons of the UI by using the CanUndo and CanRedo properties.

ViewRotationChanged

Occurs when the editor view's rotation changes.

Declaration

public event EventHandler ViewRotationChanged

Event Type

Type	Description
System.EventHandler