SelectionEventHandler Delegate (2007 System)

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

This API is not CLS-compliant. 

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Syntax

'Declaration
<CLSCompliantAttribute(False)> _
Public Delegate Sub SelectionEventHandler ( _
    sender As Object, _
    e As SelectionEventArgs _
)

'Usage
Dim instance As New SelectionEventHandler(AddressOf HandlerMethod)

[CLSCompliantAttribute(false)]
public delegate void SelectionEventHandler(
    Object sender,
    SelectionEventArgs e
)

[CLSCompliantAttribute(false)]
public delegate void SelectionEventHandler(
    Object^ sender, 
    SelectionEventArgs^ e
)

JScript does not support delegates.

Parameters

• sender
  Type: System.Object

  The source of the event.

• e
  Type: Microsoft.Office.Tools.Word.SelectionEventArgs

  A SelectionEventArgs that contains the event data.

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