勇芳软件工作室.汉化:  Printing > GDI Print API > GDI Print API Functions >

EndPage

Previous pageReturn to chapter overviewNext page

描述

 

EndPage功能通知设备应用程序已完成写入页面。此函数通常用于指示设备驱动程序前进到新页面。

 

C++ 语法

 

int EndPage(

__in HDC hdc

);

 

PowerBASIC 语法

 

FUNCTION EndPage ( _

BYVAL hdc AS DWORD _

) AS LONG

 

参数

 

hdc

 

[in]处理打印作业的设备上下文。

 

返回值

 

如果函数成功,返回值大于零。

 

如果函数失败,返回值小于或等于零。

 

备注

 

调用EndPage功能后,必要时,使用ResetDC功能更改设备模式。请注意,调用ResetDC将所有设备上下文属性重置为默认值:

 

·Windows 95/98 / MeEndPage不会重置设备上下文属性。但是,下一个StartPage调用将会将设备上下文属性重置为默认值。那么在打印下一页之前,您必须重新选择对象并再次设置映射模式。

 

·Windows NT / 2000 / XP / Vista / Windows 7EndPageStartPage都不会重设设备上下文属性。设备上下文属性在后续页面中保持不变。在打印下一页之前,不需要重新选择对象并再次设置映射模式;然而,这样做会产生相同的结果,并减少Windows版本之间的代码差异。

 

Windows 2000 / XP / Vista / Windows 7:假脱机文件中的页面超过大约350 MB时,可能无法打印而不发送错误消息。例如,打印大型EMF文件时可能会发生这种情况。页面大小限制取决于许多因素,包括可用的虚拟内存量,调用进程分配的内存量以及进程堆中的碎片数量。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)