Share via


SelectionEventHandler Delegate

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

Namespace:  Microsoft.Office.Tools.Word
Assemblies:   Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
  Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
Public Delegate Sub SelectionEventHandler ( _
    sender As Object, _
    e As SelectionEventArgs _
)
public delegate void SelectionEventHandler(
    Object sender,
    SelectionEventArgs e
)

Parameters

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. For more information about delegates, see Events and Delegates.

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.

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
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.");
}

See Also

Reference

Microsoft.Office.Tools.Word Namespace