PrintForm.Print 方法 (Form, PrintForm.PrintOption)

将 Windows 窗体的映像发送到指定的目标PrintAction属性,指定窗体和打印选项

命名空间:  Microsoft.VisualBasic.PowerPacks.Printing
程序集:  Microsoft.VisualBasic.PowerPacks.Vs(在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

语法

声明
Public Sub Print ( _
    form As Form, _
    printOption As PrintForm.PrintOption _
)
public void Print(
    Form form,
    PrintForm.PrintOption printOption
)
public:
void Print(
    Form^ form, 
    PrintForm::PrintOption printOption
)
member Print : 
        form:Form * 
        printOption:PrintForm.PrintOption -> unit
public function Print(
    form : Form, 
    printOption : PrintForm.PrintOption
)

参数

  • form
    类型:Form

备注

Print方法打印窗体上的所有可见的对象。 这包括任何文本或图形绘制与Graphics方法。

如果窗体中指定printForm参数没有焦点时,与PrintOption参数设置为CompatibleModeClientAreaOnlyCompatibleModeFullWindow,则引发异常。 如果PrintOption设置为ClientAreaOnlyFullWindow,或Scrollable,可以指定您的应用程序中的任何窗体,即使不具有焦点。

备注

当PrintOption参数设置为CompatibleModeClientAreaOnlyCompatibleModeFullWindow,通过指定的窗体Form属性必须具有焦点。如果不存在,则引发异常。若要避免此问题,调用Focus窗体在调用之前的方法Print。

默认情况下,打印窗体的客户端区域。 如果您想要在打印的图像中包括标题栏、 滚动条和边框,设置PrintOption参数为CompatibleModeFullWindowFullWindow

默认情况下,打印仅客户端区域或窗体的当前可见部分。 如果用户已在运行时调整窗体,它将作为当前显示在屏幕上进行打印。 如果,但是,在窗体部分已被移动屏幕边缘之外,将仍将像它是完全可见打印窗体。

如果您想要在其设计的大小将窗体打印,设置PrintOption参数Scrollable

Print方法使用两个基础实现之一进行打印。 实现由PrintOption参数。 当此参数设置为CompatibleModeClientAreaOnlyCompatibleModeFullWindow,与 Visual Basic 6.0 的向后兼容的实现PrintForm使用方法。 当此参数设置为ClientAreaOnlyFullWindowScrollable,使用不需要具有焦点的窗体的不同实现。

备注

在某些操作系统、 文本或图形绘制与Graphics方法可能无法正确显示。此外,如果您设置PrintOption参数ClientAreaOnlyFullWindowScrollable,你可能需要调用Refresh窗体之后立即调用的方法Print。如果未调用此方法,项目可能会显示在窗体上。

示例

下面的示例打印当前窗体到系统的默认打印机,打印的客户端区域将在其当前显示的大小和使用非兼容的打印的方法。 此示例要求您有PrintForm名 PrintForm1 为窗体上的组件。

PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh

.NET Framework 安全性

请参阅

参考

PrintForm 类

Print 重载

Microsoft.VisualBasic.PowerPacks.Printing 命名空间

其他资源

PrintForm 组件 (Visual Basic)

如何:使用 PrintForm 组件打印窗体 (Visual Basic)

如何:打印窗体的工作区 (Visual Basic)

如何:打印窗体的工作区和非工作区 (Visual Basic)

如何:打印可滚动的窗体 (Visual Basic)

部署引用 PrintForm 组件的应用程序 (Visual Basic)