EditingTextAnnotation Event

This event occurs immediately after the Image Edit control enters or exits Text Edit mode.

When the Image Edit control is in Text Edit mode, it displays the Text Edit dialog box to let end users create or modify a Text, Attach-a-Note, or Hyperlink annotation.

Available With

Applies To

Image Edit control

Syntax

Sub object_EditingTextAnnotation(Editing)

Argument

Editing

Boolean

True The Image Edit control is entering Text Edit mode. False The Image Edit control is exiting Text Edit mode.

Remarks

For this event to fire, an image must be displayed and the Image Edit control must be entering or exiting Text Edit mode.

The Image Edit control enters Text Edit mode when:

• An end user double-clicks on a selected Text, Attach-a-Note, or Hyperlink annotation
  
  
• The EditSelectedAnnotationText method is invoked with a Text, Attach-a-Note, or Hyperlink annotation selected
  
  
• A new Text, Attach-a-Note, or Hyperlink annotation is created

The Image Edit control exits Text Edit mode when:

• An end user presses the Escape key (cancel)
  
  
• An end user clicks outside the Text Edit dialog box, but inside the client area
  
  
• The ExecuteTextEditCommand method is invoked using the Finish command (value: 8 constant: wiFinishEditText) or the Cancel command (value: 9 constant: wiCancelEditText)
  
  
• Any other method is invoked

Notes: When the Image Edit control is in Text Edit mode, the accelerator keys for Cut (Ctrl+X), Copy (Ctrl+C), Paste (Ctrl+V), Undo (Ctrl+Z) and Backspace (Ctrl+H) are processed by the Text Edit box and are therefore not passed back to the application.  In other words, an application that uses these keys as menu accelerators will not receive them when the Image Edit control is in Text Edit mode.

Hyperlink annotations are available with Imaging for Windows Professional Edition only.