Описание классов и функций Visual C++.NET (стр. 5 )

Описание данного класса содержится в файле заголовка afxwin. h.

Пример использования данного класса приведен в главе 9.

ContinueRouting

void ContinueRouting();

Описание

Данная функция сообщает процедуре обработки сообщений, что обработка данного сообщения не завершена в данной функции и требуется найти обработчик данного сообщения, который завершит процедуру его обработки.

Функцию ContinueRouting необходимо вызывать в функциях обработки сообщения ON_COMMAND_EX в том случае, когда они возвращают значение FALSE.

Enable

virtual void Enable(BOOL bOn = TRUE);

Аргументы

q  bOn — если данный аргумент имеет значение TRUE, то соответствующий элемент управления становится доступным. В противном случае он становится недоступным.

Описание

Данная функция позволяет делать доступным или недоступным элемент управления.

SetCheck

virtual void SetCheck(int nCheck = 1);

Аргументы

q  nCheck — определяет состояние флажка. Если данный аргумент равен 0, то флажок сбрасывается, если — 1, то флажок устанавливается, а если значение данного аргумента равно 2, то флажок устанавливается в неопределенное состояние.

Описание

Данная функция позволяет установить состояние команды меню или кнопки панели инструментов. В неопределенное состояние может быть установлена только кнопка панели инструментов.

SetText

virtual void SetText(LPCTSTR lpszText);

Аргументы

q  lpszText — указатель на текстовую строку, заканчивающуюся нулем.

Описание

Данная функция вызывается приложением для вывода текста в пользовательском элементе управления.

CControlBar

Класс CControlBar является базовым для таких классов, как CStatusBar, CToolBar, CDialogBar, CReBar и COleResizeBar. Панель управления представляет собой окно, обычно выровненное по левой или правой стороне основного окна приложения. Оно может содержать дочерние окна, которые могут быть как элементами управления, имеющими свой дескриптор окна HWND, то есть обычными окнами Windows способными посылать и принимать сообщения, или другими элементами управления не являющимися окнами и управляемыми функциями класса приложения или класса главного окна приложения. Примером элементов управления, имеющих свой дескриптор окна, могут служить просмотровые окна списка и окна редактора. Примером элементов управления не имеющих своего дескриптора окна являются панели строки состояния или кнопки панели инструментов.

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

Описание данного класса содержится в файле заголовка afxext. h.

Пример использования данного класса приведен в главе 9.

EnableDocking

void EnableDocking(DWORD dwStyle);

Аргументы

q  dwStyle — определяет возможность фиксации панели управления на одной из сторон окна и определяет стороны, на которых панель управления может фиксироваться. Может быть комбинацией следующих флагов:

·  CBRS_ALIGN_TOP — разрешает фиксацию на верхней стороне рабочей области окна;

·  CBRS_ALIGN_BOTTOM — разрешает фиксацию на нижней стороне рабочей области окна;

·  CBRS_ALIGN_LEFT — разрешает фиксацию на левой стороне рабочей области окна;

·  CBRS_ALIGN_RIGHT — разрешает фиксацию на правой стороне рабочей области окна;

·  CBRS_ALIGN_ANY — разрешает фиксацию на любой стороне рабочей области окна;

·  CBRS_FLOAT_MULTI — разрешает использование нескольких плавающих панелей управления в одном окне.

q  Если данный аргумент равен 0 (то есть не указан ни один флаг) панель управления не фиксируется.

Описание

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

CDateTimeCtrl

Класс CDateTimeCtrl является классом обработки сообщений элемента управления Date Time Picker (Выбор даты и времени), используемого для ввода и вывода информации о дате и времени. Этот элемент управления имеет вид раскрывающегося списка, в текстовое поле которого, в зависимости от установленного стиля, выводится информация о дате или о времени. Эта информация структурирована и при редактировании отдельного ее компонента (дней, минут, секунд и т. д.) он выделяется синим прямоугольником. Для перемещения между отдельными компонентами может использоваться мышь или клавиатура.

При нажатии на кнопку раскрывающегося списка появляется элемент управления Month Calender Control (Календарь на месяц), позволяющий выбирать новую дату для отображения в рассматриваемом элементе управления.

При создании элемента управления для работы с датой и временем могут быть заданы следующие стили:

r  DTS_APPCANPARSE — позволяет пользователю нажать клавишу <F2> и произвести редактирование в рабочей области окна;

r  DTS_LONGDATEFORMAT — использует длинный формат представления даты;

r  DTS_RIGHTALIGN — приводит к выравниванию информации по правому краю в пределах элемента управления. По умолчанию используется выравнивание по левому краю;

r  DTS_SHORTDATEFORMAT — использует короткий формат представления даты;

r  DTS_TIMEFORMAT — выводит информацию о времени;

r  DTS_UPDOWN — помещает справа от данного элемента управления счетчик, который может использоваться для корректировки информации о дате и времени.

В процессе своей работы данный элемент управления может посылать следующие извещения:

r  DTN_CLOSEUP — пользователь закрывает раскрывающийся месячный календарь;

r  DTN_DATETIMECHANGE — изменение информации в элементе управления;

r  DTN_DROPDOWN — пользователь открывает раскрывающийся месячный календарь;

r  DTN_USERSTRING — пользователь завершил редактирование строки в элементе управления;

r  DTN_KILLFOCUS — элемент управления потерял фокус ввода;

r  DTN_SETFOCUS — элемент управления получил фокус ввода.

Описание данного класса содержится в файле заголовка afxdtctl. h.

Пример использования данного класса приведен в главе 4.

GetTime

BOOL GetTime(COleDateTime& timeDest) const;

DWORD GetTime(CTime& timeDest) const;

DWORD GetTime(LPSYSTEMTIME pTimeDest) const;

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

В первой версии данной функции ненулевое значение возвращается в том случае, если информация о времени успешно записана в объект класса COleDateTime. В противном случае возвращается нулевое значение. Во второй и третьей версиях возвращается двойное слово, значение которого совпадает со значением переменной dwFlag структуры NMDATETIMECHANGE.

Аргументы

q  timeDest — в первой версии данной функции содержит ссылку на объект класса COleDateTime, в который будет записана информация о системной дате и времени. Во второй версии данной функции этот аргумент содержит ссылку на объект класса CTime, в который будет записана информация о системной дате и времени.

q  PTimeDest — указатель на объект структуры SYSTEMTIME, в который будет записана информация о системной дате и времени. Не может принимать нулевого значения.

Описание

Используется для сохранения информации о дате и времени, содержащейся в соответствующем элементе управления, в объекте структуры SYSTEMTIME.

Эта функция выполняет те же действия, что и сообщение Win32 DTM_GETSYSTEMTIME. При реализации в библиотеке MFC функция GetTime может сохранять информацию не только в объекте структуры SYSTEMTIME, но и в объектах классов COleDateTime и CTime.

Вторая и третья версии данной функции возвращают двойное слово, информирующее о том, содержалась ли в соответствующем элементе управления информация о дате и времени. Возвращаемое значение соответствует значению переменной dwFlags структуры NMDATETIMECHANGE. Если возвращается значение GDT_NONE, то элемент управления не содержит информации о дате и использует стиль DTS_SHOWNONE. Если возвращается значение GDT_VALID, то системное время благополучно сохранено в соответствующем объекте.

SetFormat

BOOL SetFormat(LPCTSTR pstrFormat);

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

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

Аргументы

q  pstrFormat — указатель на заканчивающуюся нулем строку, определяющую формат выводимой информации. Передача в данном аргументе нулевого значения установит формат, используемый по умолчанию.

Описание

Устанавливает формат вывода информации в элементе управления.

Эта функция выполняет те же действия, что и сообщение Win32 DTM_SETFORMAT.

SetTime

BOOL SetTime(const COleDateTime& timeNew);

BOOL SetTime(const CTime* pTimeNew);

BOOL SetTime(LPSYSTEMTIME pTimeNew = NULL);

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

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

Аргументы

q  timeNew — ссылка на объект класса COleDateTime, содержащий время, которое необходимо установить в элементе управления.

q  pTimeNew — во второй версии данной функции содержит указатель на объект класса CTime, содержащий время, которое необходимо установить в элементе управления. В третьей версии данной функции этот аргумент содержит указатель на объект структуры SYSTEMTIME, содержащий время, которое необходимо установить в элементе управления.

Описание

Устанавливает дату и время в соответствующем элементе управления.

Эта функция выполняет те же действия, что и сообщение Win32 DTM_SETSYSTEMTIME. При реализации в библиотеке MFC функция GetTime может получать информацию не только из объекта структуры SYSTEMTIME, но и из объектов классов COleDateTime и CTime.

CDC

Класс CDC представляет собой класс контекста устройств. Объект класса CDC содержит методы для работы с контекстом таких устройств, как дисплей или принтер, а также позволяет работать с контекстом дисплея, связанным с рабочей областью окна.

Все операции вывода информации на дисплей и принтер должны производиться только с использованием методов, предоставляемых объектом класса CDC. Данный класс содержит методы для работы с контекстом устройств, осуществляющих вывод графической информации, методы выбора объектов интерфейса графических устройств (GDI), учитывающие тип выбираемых объектов, и методы для работы с цветами и палитрами. Он также обеспечивает методы для получения и установки атрибутов отображения графической информации, масштабирования, работы с областями просмотра, работы с расширениями окон, преобразования координат, работы с областями, отсечения неотображаемых фрагментов, рисования линий, простых форм, эллипсов и многоугольников. Данный класс содержит, также методы позволяющие выводить текст, работать со шрифтами, использовать управляющие последовательности принтера, прокрутку окон и проигрывание метафайлов.

Чтобы использовать объект класса CDC, необходимо его создать, а затем использовать его функции, соответствующие функциям Windows, предназначенным для работы с контекстами устройств. В Windows 95 экранные координаты хранятся в 16-разрядных целых числах со знаком. Поэтому все величины типа int, используемые в качестве аргументов функций класса CDC должны находиться в диапазоне от -32768 до 32767.

Для определенных целей в библиотеке MFC предусмотрены классы, производные от класса CDC. Класс CPaintDC включает в себя вызовы функций BeginPaint и EndPaint. Класс CClientDC позволяет работать с контекстом дисплея, связанным с рабочей областью окна. Класс CWindowDC позволяет работать с контекстом дисплея, связанным со всем окном, включая его рамку и элементы управления. Класс CMetaFileDC связывает контекст устройства с метафайлом.

Класс CDC содержит две переменные для хранения контекста устройства: m_hDC и m_hAttribDC, которые, при создании объекта класса CDC относятся к одному и тому же устройству. Класс CDC направляет все запросы на вывод информации с использованием GDI к переменной m_hDC, а большинство обращений к атрибутам GDI использует переменную m_hAttribDC. (Примером обращения к атрибутам может служить функция GetTextColor, а функция SetTextColor может служить примером запроса на вывод информации).

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

Может возникнуть случай, когда пользователю потребуется использовать одну и ту же информацию, полученную из обоих контекстов устройств. Для этого используются пары функций, приведенные в таблице П2.4:

Таблица П2.4. Функции, выполняющие аналогичные действия с различными контекстами устройств

Использует m_hAttribDC	Использует m_hDC
GetTextExtent	GetOutputTextExtent
GetTabbedTextExtent	GetOutputTabbedTextExtent
GetTextMetrics	GetOutputTextMetrics
GetCharWidth	GetOutputCharWidth

Описание данного класса содержится в файле заголовка afxwin. h.

BitBlt

BOOL BitBlt(int x, int y, int nWidth, int nHeight, CDC* pSrcDC, int xSrc, int ySrc, DWORD dwRop);

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

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

Аргументы

q  x — определяет горизонтальную координату верхнего левого угла прямоугольника в который будет копироваться битовый образ (области вывода).

q  y — определяет вертикальную координату верхнего левого угла прямоугольника в который будет копироваться битовый образ.

q  nWidth — определяет ширину (в логических единицах) прямоугольника в который будет копироваться битовый образ.

q  nHeight — определяет высоту (в логических единицах) прямоугольника в который будет копироваться битовый образ.

q  pSrcDC — указатель на объект класса CDC, определяющий контекст устройства из которого производится копирование битового образа. Если значение аргумента dwRop определяет растровую операцию для которой не требуется источника, этот аргумент должен иметь значение NULL.

q  xSrc — определяет горизонтальную координату верхнего левого угла прямоугольника из которого будет копироваться битовый образ.

q  ySrc — определяет вертикальную координату верхнего левого угла прямоугольника из которого будет копироваться битовый образ.

q  dwRop — определяет растровую операцию, которую необходимо выполнить. Коды растровых операций определяют каким образом GDI должен комбинировать цвета при выполнении операции, включающей в себя текущую кисть, возможно, исходный битовый образ и результирующий битовый образ. Данный аргумент может принимать следующие значения:

·  BLACKNESS — закрашивает всю область вывода в черный цвет;

·  DSTINVERT — инвертирует битовый образ, расположенный в области вывода;

·  MERGECOPY — комбинирует образец и исходный битовый образ с использованием логического оператора И;

·  MERGEPAINT — комбинирует инвертированный битовый образ, расположенный в области вывода, и исходный битовый образ с использованием логического оператора ИЛИ;

·  NOTSRCCOPY — копирует инвертированный исходный битовый образ в область вывода;

·  NOTSRCERASE — инвертирует результат логического оператора ИЛИ между инвертированным битовым образом, расположенным в области вывода, и исходным битовым образом;

·  PATCOPY — заполняет область вывода с использованием образца;

·  PATINVERT — комбинирует битовый образ, расположенный в области вывода, и исходный битовый образ с использованием логического оператора ИСКЛЮЧАЮЩЕГО ИЛИ;

·  PATPAINT — комбинирует образец и инвертированный исходный битовый образ с использованием логического оператора ИЛИ. Результат этой операции комбинируется с битовым образом, расположенным в области вывода, с использованием логического оператора ИЛИ;

·  SRCAND — комбинирует элементы изображения битового образа, расположенного в области вывода, и исходного битового образа с использованием логического оператора И;

·  SRCCOPY — копирует исходный битовый образ в область вывода;

·  SRCERASE — инвертирует битовый образ, расположенный в области вывода, и комбинирует результат с исходным битовым образом с использованием логического оператора И;

·  SRCINVERT — комбинирует битовый образ, расположенный в области вывода, и исходный битовый образ с использованием логического оператора ИСКЛЮЧАЮЩЕГО ИЛИ;

·  SRCPAINT — комбинирует элементы изображения битового образа, расположенного в области вывода, и исходного битового образа с использованием логического оператора ИЛИ;

·  WHITENESS — закрашивает всю область вывода в белый цвет.

Описание

Копирует битовый образ из исходного контекста устройства в текущий контекст устройства.

Приложение может выравнивать окна или их рабочие области по границе байтов для гарантии того, что функция BitBlt будет работать с прямоугольниками, выровненными по границам байт. (Для этого необходимо установить флаги CS_BYTEALIGNWINDOW или CS_BYTEALIGNCLIENT при регистрации класса окна.)

Работа функции BitBlt с прямоугольниками, выровненными по границам байт, происходит намного быстрее, чем с прямоугольниками, не выровненными по границам байт. При необходимости задания стилей класса, обеспечивающих работу с прямоугольниками, выровненными по границам байт, в пользовательском контексте устройства, следует самостоятельно зарегистрировать класс окна, не полагаясь в этом на библиотеку MFC. Для этого используется глобальная функция AfxRegisterClass.

Интерфейс графических устройств Windows преобразует аргументы nWidth и nHeight, используя контекст устройства в который производится копирование битового образа. Если метрики устройств не совпадают, GDI вызывает функцию Windows StretchBlt для сжатия или растяжения исходного битового образа.

Если битовый образ в области вывода, исходный битовый образ и образец имеют различный формат цвета, функция BitBlt преобразует форматы исходного битового образа и образца к формату устройства вывода. При преобразовании используются как фоновый, так и основной битовые образы.

При преобразовании монохромного битового образа в цветной функция BitBlt присваивает белому биту (1) цвет фона, а черному биту (0) основной цвет. При этом используются основной цвет (Foreground) и цвет фона (Background). При преобразовании цветного битового образа в монохромный функция BitBlt преобразует элементы изображения, имеющие цвет фона, в белые, а все остальные — в черные элементы изображения.

Не все устройства могут работать с функцией BitBlt. Чтобы проверить возможность работы конкретного устройства с функцией BitBlt вызовите функцию GetDeviceCaps с аргументом RASTERCAPS.

CreateCompatibleDC

virtual BOOL CreateCompatibleDC(CDC* pDC);

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

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

Аргументы

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

Описание

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

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

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

EndDoc

int EndDoc();

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

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

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

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

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

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

Описание

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

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

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

EndPage

int EndPage();

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

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

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

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

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

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

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

Описание

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

FillRect

void FillRect(LPCRECT lpRect, CBrush* pBrush);

Аргументы

q  lpRect — указатель на объект структуры RECT, содержащий логические координаты заполняемого прямоугольника. В качестве данного аргумента может использоваться объект класса CRect.

q  pBrush — определяет кисть, используемую для заполнения прямоугольника.

Описание

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

Используемая кисть должна быть создана с использованием функций CBrush::CreateHatchBrush, CBrush::CreatePatternBrush или CBrush::CreateSolidBrush или должна быть получена с использованием функции Windows ::GetStockObject.

В процессе своей работы функция FillRect проверяет значения величин, передаваемых в переменных top, bottom, left и right передаваемого ей в качестве аргумента объекта структуры RECT. Если величина bottom оказывается меньше либо равной величине top или величина right оказывается меньше либо равной величине left, то прямоугольник не рисуется.

Функция FillRect аналогична функции CDC::FillSolidRect за тем исключением, что в функции FillRect указывается кисть, что в свою очередь означает, что данный прямоугольник может быть заполнен одним цветом, определенным трафаретом или заданным образцом. Функция FillSolidRect может заполнить данный прямоугольник только одним цветом (указанным в аргументе COLORREF). Функция FillRect, обычно, работает медленнее, чем функция FillSolidRect.

GetDeviceCaps

int GetDeviceCaps(int nIndex) const;

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

В случае успешного завершения функции возвращается значение запрашиваемого параметра.

Аргументы

q  nIndex — определяет тип возвращаемой информации. Может иметь одно из следующих значений:

·  DRIVERVERSION — номер версии. Например, для версии 1.0 возвращается величина 0x100;

·  TECHNOLOGY — технология устройства. Может принимать одно из следующих значений:

q  DT_PLOTTER — векторный плоттер.

q  DT_RASDISPLAY — растровый дисплей.

q  DT_RASPRINTER — растровый принтер.

q  DT_RASCAMERA — растровая камера.

q  DT_CHARSTREAM — текстовый поток.

q  DT_METAFILE — метафайл.

q  DT_DISPFILE — файл дисплея.

·  HORZSIZE — физическая ширина дисплея (в миллиметрах);

·  VERTSIZE — физическая высота дисплея (в миллиметрах);

·  HORZRES — размер дисплея по горизонтали (в элементах изображения);

·  VERTRES — размер дисплея по вертикали (в строках растра);

·  LOGPIXELSX — число элементов изображения в логическом дюйме по горизонтали дисплея;

·  LOGPIXELSY — число элементов изображения в логическом дюйме по вертикали дисплея;

·  BITSPIXEL — количество битов, используемых для кодирования цвета каждого элемента изображения;

·  PLANES — количество битовых плоскостей;

·  NUMBRUSHES — количество кистей в устройстве;

·  NUMPENS — количество перьев в устройстве;

·  NUMFONTS — количество шрифтов в устройстве;

·  NUMCOLORS — количество цветов в таблице цветов устройства;

·  ASPECTX — относительная ширина элемента изображения устройства, используемая при рисовании линий;

·  ASPECTY — относительная высота элемента изображения устройства, используемая при рисовании линий;

·  ASPECTXY — размер по диагонали элемента изображения устройства, используемая при рисовании линий;

·  PDEVICESIZE — размер внутренней структуры PDEVICE;

·  CLIPCAPS — возможность задания областей отсечки. Может принимать одно из следующих значений:

q  CP_NONE — выводимое изображение не ограничивается.

q  CP_RECTANGLE — прямоугольная область отсечки.

q  CP_REGION — произвольная область отсечки.

·  SIZEPALETTE — количество цветов в системной палитре. Аргумент nIndex может принимать данное значение только в том случае, когда драйвер устройства установил бит RC_PALETTE в индексе RASTERCAPS;

·  NUMRESERVED — количество зарезервированных цветов в системной палитре. Аргумент nIndex может принимать данное значение только в том случае, когда драйвер устройства установил бит RC_PALETTE в индексе RASTERCAPS;

·  COLORRES — текущее цветовое разрешение устройства, измеряемое в битах на элемент изображения. Аргумент nIndex может принимать данное значение только в том случае, когда драйвер устройства установил бит RC_PALETTE в индексе RASTERCAPS;

·  RASTERCAPS — величина, указывающая на возможности растеризации устройства. Может быть комбинацией следующих значений:

q  RC_BANDING — требует поддержки возможностей объединения.

q  RC_BIGFONT — устройство способно работать со шрифтами размером более 64 КБ.

q  RC_BITBLT — обладает возможностью передачи битовых образов.

q  RC_BITMAP64 — устройство способно работать с битовыми образами шрифтами размером более 64 КБ.

q  RC_DEVBITS — устройство способно работать с аппаратно зависимыми битовыми образами.

q  RC_DI_BITMAP — устройство способно работать с функциями Windows SetDIBits и GetDIBits.

q  RC_DIBTODEV — устройство способно работать с функцией Windows SetDIBitsToDevice.

q  RC_FLOODFILL — устройство способно осуществлять потоковое заполнение.

q  RC_GDI20_OUTPUT — устройство способно работать с функциями Windows версии 2.0.

q  RC_GDI20_STATE — включает блок состояния в контекст устройства.

q  RC_NONE — устройство не способно выполнять растровые операции.

q  RC_OP_DX_OUTPUT — устройство способно работать с массивом DX и выводить прозрачные изображения.

q  RC_PALETTE — устройство способно работать с палитрами.

q  RC_SAVEBITMAP — устройство способно локально хранить битовые образы.

q  RC_SCALING — устройство способно масштабировать изображение.

q  RC_STRETCHBLT — устройство способно работать с функцией StretchBlt.

q  RC_STRETCHDIB — устройство способно работать с функцией Windows StretchDIBits

·  CURVECAPS — определяет способность устройства вычерчивать кривые. Может быть комбинацией следующих значений:

q  CC_NONE — устройство не способно вычерчивать кривые.

q  CC_CIRCLES — устройство способно вычерчивать окружности.

q  CC_PIE — устройство способно вычерчивать секторные диаграммы.

q  CC_CHORD — устройство способно вычерчивать хорды.

q  CC_ELLIPSES — устройство способно вычерчивать эллипсы.

q  CC_WIDE — устройство способно вычерчивать широкие рамки.

q  CC_STYLED — устройство способно вычерчивать рамки с использованием стилей.

q  CC_WIDESTYLED — устройство способно вычерчивать широкие рамки с использованием стилей.

q  CC_INTERIORS — устройство способно заполнять внутреннее пространство.

q  CC_ROUNDRECT — устройство способно вычерчивать прямоугольники с закругленными углами.

·  LINECAPS — определяет способность устройства вычерчивать линии. Может быть комбинацией следующих значений:

q  LC_NONE — устройство не способно вычерчивать линии.

q  LC_POLYLINE — устройство способно одновременно вычерчивать несколько связанных линий.

q  LC_MARKER — устройство способно выводить маркеры.

q  LC_POLYMARKER — устройство способно выводить множественные маркеры.

q  LC_WIDE — устройство способно вычерчивать широкие линии.

q  LC_STYLED — устройство способно вычерчивать линии с использованием стилей.

q  LC_WIDESTYLED — устройство способно вычерчивать широкие линии с использованием стилей.

q  LC_INTERIORS — устройство способно заполнять внутреннее пространство.

·  POLYGONALCAPS — определяет способность устройства вычерчивать многоугольники. Может быть комбинацией следующих значений:

q  PC_NONE — устройство не способно вычерчивать многоугольники.

q  PC_POLYGON — устройство способно вычерчивать многоугольники с различным заполнением.

q  PC_RECTANGLE — устройство способно вычерчивать прямоугольники.

q  PC_WINDPOLYGON — устройство способно вычерчивать многоугольники с заполнением спиральным числом.

q  PC_SCANLINE — устройство может использовать построчную развертку.

q  PC_WIDE — устройство способно вычерчивать широкие рамки.

q  PC_STYLED — устройство способно вычерчивать границы с использованием стилей.

q  PC_WIDESTYLED — устройство способно вычерчивать широкие рамки с использованием стилей.

q  PC_INTERIORS — устройство способно заполнять внутреннее пространство.

·  TEXTCAPS — определяет возможности устройства при работе с текстами. Может быть комбинацией следующих значений:

q  TC_OP_CHARACTER — определяет такое разрешение при выводе текстов, которое позволяет устройству поместить свой шрифт в любой элемент изображения. Это является необходимым условием для работы устройствами, имеющими собственные шрифты.

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

q  TC_CP_STROKE — определяет точность отсечки штриха, указывая, что устройство может обрезать свои шрифты по границам элементов изображения.

q  TC_CR_90 — устройство способно поворачивать символы на 90 градусов, и шаг поворота составляет 90 градусов.

q  TC_CR_ANY — устройство способно поворачивать символы на любой угол.

q  TC_SF_X_YINDEP — устройство может производить независимое масштабирование шрифта по вертикальной и горизонтальной осям.

q  TC_SA_DOUBLE — устройство может удваивать размеры своих шрифтов.

q  TC_SA_INTEGER — устройство может увеличивать размеры своих шрифтов в любое целое число раз.

q  TC_SA_CONTIN — устройство может произвольно изменять размеры своих шрифтов, но при этом сохраняет соотношение его вертикального и горизонтального размеров.

q  TC_EA_DOUBLE — устройство позволяет использовать жирные шрифты. Если этот параметр установлен для принтера, GDI старается создать жирный шрифт в устройстве за счет его двойной печати.

q  TC_IA_ABLE — устройство позволяет использовать курсивные шрифты. Если этот бит не установлен, GDI полагает, что данное устройство не может работать с курсивными шрифтами.