将 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参数设置为CompatibleModeClientAreaOnly或CompatibleModeFullWindow,则引发异常。 如果PrintOption设置为ClientAreaOnly, FullWindow,或Scrollable,可以指定您的应用程序中的任何窗体,即使不具有焦点。
备注
当PrintOption参数设置为CompatibleModeClientAreaOnly或CompatibleModeFullWindow,通过指定的窗体Form属性必须具有焦点。如果不存在,则引发异常。若要避免此问题,调用Focus窗体在调用之前的方法Print。
默认情况下,打印窗体的客户端区域。 如果您想要在打印的图像中包括标题栏、 滚动条和边框,设置PrintOption参数为CompatibleModeFullWindow或FullWindow。
默认情况下,打印仅客户端区域或窗体的当前可见部分。 如果用户已在运行时调整窗体,它将作为当前显示在屏幕上进行打印。 如果,但是,在窗体部分已被移动屏幕边缘之外,将仍将像它是完全可见打印窗体。
如果您想要在其设计的大小将窗体打印,设置PrintOption参数Scrollable。
Print方法使用两个基础实现之一进行打印。 实现由PrintOption参数。 当此参数设置为CompatibleModeClientAreaOnly或CompatibleModeFullWindow,与 Visual Basic 6.0 的向后兼容的实现PrintForm使用方法。 当此参数设置为ClientAreaOnly,FullWindow或Scrollable,使用不需要具有焦点的窗体的不同实现。
备注
在某些操作系统、 文本或图形绘制与Graphics方法可能无法正确显示。此外,如果您设置PrintOption参数ClientAreaOnly,FullWindow或Scrollable,你可能需要调用Refresh窗体之后立即调用的方法Print。如果未调用此方法,项目可能会显示在窗体上。
示例
下面的示例打印当前窗体到系统的默认打印机,打印的客户端区域将在其当前显示的大小和使用非兼容的打印的方法。 此示例要求您有PrintForm名 PrintForm1 为窗体上的组件。
PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。
请参阅
参考
Microsoft.VisualBasic.PowerPacks.Printing 命名空间
其他资源
如何:使用 PrintForm 组件打印窗体 (Visual Basic)