Share via


DocumentBase.BeforePrint Event

Definition

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

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