DocumentBase.BeforePrint Event

Reference

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Occurs before the document is printed.

public:
 event System::ComponentModel::CancelEventHandler ^ BeforePrint;

public event System.ComponentModel.CancelEventHandler BeforePrint;

member this.BeforePrint : System.ComponentModel.CancelEventHandler

Public Custom Event BeforePrint As CancelEventHandler

Event Type

CancelEventHandler

Examples

The following code example displays a message before the document is printed that asks whether you want to print the document. To use this example, run it from the ThisDocument class in a document-level project.

private void DocumentBeforePrint()
{
    this.BeforePrint += new System.ComponentModel.CancelEventHandler(ThisDocument_BeforePrint);
}

void ThisDocument_BeforePrint(object sender, System.ComponentModel.CancelEventArgs e)
{
    if (MessageBox.Show("Do you want to print the document?", "BeforePrint",
        MessageBoxButtons.YesNo) == DialogResult.No)
    {
        e.Cancel = true;
    }
}

Private Sub DocumentBeforePrint()
    AddHandler Me.BeforePrint, AddressOf ThisDocument_BeforePrint
End Sub

Private Sub ThisDocument_BeforePrint(ByVal sender As Object, ByVal e As System. _
    ComponentModel.CancelEventArgs)
    If MessageBox.Show("Do you want to print the document?", "BeforePrint", _
        MessageBoxButtons.YesNo) = DialogResult.No Then
        e.Cancel = True
    End If
End Sub

Remarks

To prevent the document from printing, set the Cancel argument of the provided CancelEventArgs object to true.

Applies to

Compartilhar via