ContextChangeEventHandler-Delegat

Artikel
08/10/2011

Stellt die Methode zum Behandeln der Ereignisse Select, Deselect, ContextEnter und ContextLeave eines XMLNode-Objekts und der Ereignisse ContextEnter, ContextLeave, Select und Deselect eines XMLNodes-Objekts dar.

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

Syntax

'Declaration
Public Delegate Sub ContextChangeEventHandler ( _
    sender As Object, _
    e As ContextChangeEventArgs _
)

public delegate void ContextChangeEventHandler(
    Object sender,
    ContextChangeEventArgs e
)

Parameter

sender
Typ: System.Object
Die Quelle des Ereignisses.

e
Typ: Microsoft.Office.Tools.Word.ContextChangeEventArgs
Eine ContextChangeEventArgs-Klasse, die die Ereignisdaten enthält.

Hinweise

Beim Erstellen eines ContextChangeEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um das Ereignis dem Ereignishandler zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Auftreten des Ereignisses aufgerufen, bis Sie den Delegaten entfernen. Weitere Informationen über Delegaten finden Sie unter Ereignisse und Delegaten.

Beispiele

Im folgenden Codebeispiel werden Ereignishandler für die Ereignisse XMLNode.Select, XMLNode.Deselect, XMLNode.ContextEnter und XMLNode.ContextLeave veranschaulicht. Wenn das XMLNode.Select-Ereignis bzw. das XMLNode.Deselect-Ereignis ausgelöst wird, fügen die Ereignishandler dem Rahmen der Markierung doppelte Linien hinzu oder entfernen diese (je nach Ereignis). Wenn das XMLNode.ContextEnter-Ereignis bzw. das XMLNode.ContextLeave-Ereignis ausgelöst wird, zeigen die Ereignishandler Meldungen an, die den Namen des zuletzt ausgewählten Knotens und des zuvor ausgewählten Knotens angeben. In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument einen XMLNode mit dem Namen CustomerNode enthält.

Private Sub CustomerNode_Select(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles CustomerNode.Select

    e.Selection.Borders.OutsideLineStyle = _
        Word.WdLineStyle.wdLineStyleDouble
End Sub

Private Sub CustomerNode_Deselect(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles CustomerNode.Deselect

    e.Selection.Borders.OutsideLineStyle = _
        Word.WdLineStyle.wdLineStyleNone
End Sub

Private Sub CustomerNode_ContextEnter(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles CustomerNode.ContextEnter

    MsgBox("You entered the node '" & e.NewXMLNode.BaseName & "'.")
End Sub

Private Sub CustomerNode_ContextLeave(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles CustomerNode.ContextLeave

    MsgBox("You left the node '" & e.OldXMLNode.BaseName & "'.")
End Sub

private void XMLNodeSelections()
{
    this.CustomerNode.ContextEnter +=
        new Microsoft.Office.Tools.Word.ContextChangeEventHandler(
        CustomerNode_ContextEnter);

    this.CustomerNode.ContextLeave +=
        new Microsoft.Office.Tools.Word.ContextChangeEventHandler(
        CustomerNode_ContextLeave);

    this.CustomerNode.Select += 
        new Microsoft.Office.Tools.Word.ContextChangeEventHandler(
        CustomerNode_Select); 

    this.CustomerNode.Deselect +=
        new Microsoft.Office.Tools.Word.ContextChangeEventHandler(
        CustomerNode_Deselect);
}

void CustomerNode_Select(object sender, 
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    e.Selection.Borders.OutsideLineStyle =
        Word.WdLineStyle.wdLineStyleDouble;
}

void CustomerNode_Deselect(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    e.Selection.Borders.OutsideLineStyle =
        Word.WdLineStyle.wdLineStyleNone;
}

void CustomerNode_ContextEnter(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    MessageBox.Show("You entered the node '" +
        e.NewXMLNode.BaseName + "'.");
}

void CustomerNode_ContextLeave(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    MessageBox.Show("You left the node '" +
        e.OldXMLNode.BaseName + "'.");
}

Siehe auch

Referenz

Microsoft.Office.Tools.Word-Namespace

Freigeben über