SelectionEventHandler Delegate

  • Reference

Definition

Namespace:
Microsoft.Office.Tools.Word
Assemblies:
Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Represents the method that handles the SelectionChange, Selected, and Deselected events of a Bookmark control.

public delegate void SelectionEventHandler(System::Object ^ sender, SelectionEventArgs ^ e);
public delegate void SelectionEventHandler(object sender, SelectionEventArgs e);
type SelectionEventHandler = delegate of obj * SelectionEventArgs -> unit
Public Delegate Sub SelectionEventHandler(sender As Object, e As SelectionEventArgs)

Parameters

sender
Object

The source of the event.

e
SelectionEventArgs

A SelectionEventArgs that contains the event data.

Examples

The following code example adds a Bookmark control with text to the document and then creates an event handler for the Selected event. A message box is displayed when you move the cursor into the bookmark.

This example is for a document-level customization.

Microsoft.Office.Tools.Word.Bookmark bookmark4;
        
private void BookmarkSelected()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    bookmark4 = this.Controls.AddBookmark(this.Paragraphs[1]
        .Range, "bookmark4");
    bookmark4.Text = "This is a sample bookmark.";
    bookmark4.Selected += new Microsoft.Office.Tools
        .Word.SelectionEventHandler(bookmark4_Selected);
}

void bookmark4_Selected(object sender, Microsoft.Office.Tools
    .Word.SelectionEventArgs e)
{
    MessageBox.Show("The selection has moved to bookmark1.");
}

WithEvents Bookmark4 As Microsoft.Office.Tools.Word.Bookmark

Private Sub BookmarkSelected()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Bookmark4 = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, _
        "Bookmark4")
    Bookmark4.Text = "This is a sample bookmark."
End Sub

Private Sub Bookmark4_Selected(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.SelectionEventArgs) _
    Handles Bookmark4.Selected
    MessageBox.Show("The selection has moved to Bookmark1.")
End Sub

Remarks

When you create a SelectionEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, until you remove the delegate.

Applies to