Cdc::CreateCompatibleDc

virtual BOOL CreateCompatibleDC( CDC* pDC );

Возвращаемое значение

Ненулевое, если функция завершилась успешно, и нулевое в противном случае.

Аргументы

0. pDC — указатель на объект класса контекста устройства. Если аргумент pDC имеет значение NULL, функция создаёт контекст устройства памяти, совместимый с системным дисплеем.

Примечание

Создаёт контекст устройства памяти, совместимый с устройством, определяемым аргументом pDC. Контекст устройства памяти представляет собой блок памяти, соответствующий поверхности экрана. Он может использоваться для создания в памяти изображений перед копированием их на совместимое устройство.

При создании контекста устройства памяти GDI автоматически выбирает в него монохромный битовый образ размером 1х1 элемент изображения. Функции вывода информации интерфейса графических устройств могут работать с контекстом устройства памяти только в том случае, если в него был выбран объект класса битового образа.

Эта функция позволяет создавать совместимые контексты устройств только для устройств, обеспечивающих возможность вывода растровых изображений. Способ передачи информации битовыми блоками описан при рассмотрении функции CDC::BitBlt. Для определения того, способно ли конкретное устройство выводить растровые изображения, необходимо вызвать функцию CDC::GetDeviceCaps с аргументом RC_BITBLT.

Cdc::Detach

HDC Detach( );

Возвращаемое значение

Контекст устройства Windows.

Примечание

Данная функция вызывается для освобождения m_hDC (контекста устройств вывода) из объекта класса CDC и присвоения его переменным m_hDC и m_hAttribDC значения NULL.

Cdc::EndDoc

int EndDoc( );

Возвращаемое значение

Больше или равное нулю, если функция завершилась успешно, в противном случае возвращается значение ошибки, которое может принимать одно из следующих значений.

• SP_ERROR — неизвестная ошибка.

• SP_OUTOFDISK — недостаточно дискового пространства выделенного для спулинга и оно не может быть увеличено.

• SP_OUTOFMEMORY — недостаточно оперативной памяти для спулинга.

• SP_USERABORT — пользователь прервал печать через Диспетчер печати.

Примечание

Завершает текущий сеанс печати, инициированный вызовом функции StartDoc. Эта функция служит для замены управляющей последовательности ENDDOC, посылаемой принтеру, и должна вызываться непосредственно после успешного завершения процесса печати.

Если в процессе сеанса печати возникла ошибка или процесс печати был прерван пользователем, для завершения процесса печати не следует вызывать функции EndDoc или AbortDoc. GDI автоматически завершит процесс прежде, чем он выдаст сообщение об ошибке.

Эта функция не должна использоваться в метафайлах.

Cdc::EndPage

int EndPage( );

Возвращаемое значение

Больше или равное нулю, если функция завершилась успешно, в противном случае возвращается значение ошибки, которое может принимать одно из следующих значений.

• SP_ERROR — неизвестная ошибка.

• SP_APPABORT — печать прекращена потому, что приложение завершило свою работу.

• SP_USERABORT — пользователь прервал печать через Диспетчер печати.

• SP_OUTOFDISK — недостаточно дискового пространства выделенного для спулинга и оно не может быть увеличено.

• SP_OUTOFMEMORY — недостаточно оперативной памяти для спулинга.

Примечание

Данная функция информирует устройство о том, что приложение закончило передачу текущей страницы. Эта функция обычно используется для указания драйверу устройства о необходимости перейти к печати следующей страницы. Эта функция служит для замены управляющей последовательности NEWFRAME, посылаемой принтеру. В отличие от управляющей последовательности NEWFRAME данная функция всегда вызывается после печати страницы.