клас GdipImages
Клас призначений для роботи з зображеннями і малювання різних графічних примітивів і текстових рядків засобами GDI +.
Створення об'єкта - екземпляра класу:
Необов'язковий параметр логічного типу lGdipInit визначає необхідність ініціалізації середовища GDIPlus. Якщо його значення «істина», то GDIPlus инициализируется.
InterpolationMode
Визначає режим інтерполяції. Може приймати значення в інтервалі від 0 до 7.
JpegQuality
Визначає значення якості при збереженні зображення у форматі JPEG. Може приймати значення в інтервалі від 20 до 90.
ARGB
Перетворює значення кольору, що повертається функцій RGB (), в формат, який використовується в GDIPlus.
Red. Green. Blue # 8213; значення колірних компонент
Alpha # 8213; значення прозорості (від 0 до 255; 0 - повністю прозорий; 255 - повністю непрозорий); якщо параметр опущений, то мається на увазі значення 255
ClipImage
Вирізає з зображення задану прямокутну область і або копіює її в файл, або заміщає нею вихідне зображення.
Left. Top # 8213; кординат лівої верхньої точки фрагмента зображення
Width. Height # 8213; ширина і висота фрагменту зображення
cOutputFileName # 8213; (Необов'язковий) ім'я та тип файлу для збереження зображення
Якщо параметр cOutputFileName опущений, то фрагмент заміщає вихідний образ зображення
CreateBitmap
Створює растр зазначеного розміру і заливає його заданим кольором.
width. height # 8213; розміри створюваного растра
color # 8213; колір растра (в форматі, повернутому методом ARGB)
CreateFont
Створює шрифт заданої висоти і стилю по його імені.
FontName # 8213; найменування шрифту (наприклад, Arial)
width # 8213; висота шрифту (дійсне значення, в залежності від встановленої одиниці виміру)
style # 8213; стиль шрифту (0 - нормальний, 1 - курсив і т.д.)
CreateGradientBrush
Створює лінійну градієнтну кисть.
PointArray # 8213; масив точок, що визначають вид градиентной кисті; якщо параметр Mode вказано, то масив містить чотири точки, що визначає кисть у вигляді прямокутної області; інакше PointArray містить дві точки, що визначають напрямок зміни кольору кисті.
WrapMode # 8213; (Необов'язковий) може приймати значення від 0 до 3; встановлює ефект перетікання кольору кисті
Mode # 8213; (Необов'язковий) може приймати значення від 0 до 3; визначення напрямок зміни кольору для кисті, заданої прямокутником
CreateHatchBrush
Створює штриховую кисть.
Style # 8213; (Необов'язковий) визначає стиль штриховий кисті; приймає значення від 0 до 52. Якщо параметр опущений, то застосовується стиль 2 (коса штрихування)
ForeColor # 8213; (Необов'язковий) визначає колір фону в форматі, повернутому методом ARGB; якщо параметр опущений, то застосовується білий колір
BackColor # 8213; (Необов'язковий) визначає колір штриха кисті в форматі, повернутому методом ARGB; якщо параметр опущений, то створюється кисть чорного кольору
CreatePen
Створює перо.
width # 8213; товщина пера (дійсне значення, в залежності від встановленої одиниці виміру)
color # 8213; колір пера в форматі, повернутому методом ARGB; якщо параметр опущений, то створюється перо чорного кольору
CreateSolidBrush
Створює одноколірну кисть.
color # 8213; колір кисті в форматі, повернутому методом ARGB
CreateStringFormat
Створює об'єкт StringFormat, керуючий форматуванням тексту.
lDirect # 8213; (Необов'язковий) визначає напрямок виведення тексту (якщо "істина", то текст виводиться вертикально); якщо параметр опущений, то текст виводиться горизонтально
CreateTextureBrush
Створює текстуруванні кисть.
TextureFileName # 8213; ім'я та тип файлу, використовуваного в якості текстури
WrapMode # 8213; (Необов'язковий) приймає значення від 0 до 3; визначає взаємне розташування текстур в разі, якщо розмір текстури менше розміру області малювання
DeleteBrush
Видаляє кисть.
DeleteFont
Видаляє шрифт.
DeletePen
Видаляє перо.
DeleteStringFormat
Видаляє об'єкт StringFormat. Після видалення цього об'єкта текст не форматується.
DrawClosedCurve, FillClosedCurve
Малює (зафарбовує) замкнутий сплайн.
PointArray # 8213; масив координат точок сплайна
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawCurve
Малює сплайн.
PointArray # 8213; масив координат точок сплайна
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawEllipse, FillEllipse
Малює (зафарбовує) еліпс (коло).
x, y # 8213; координати центру еліпса (кола)
Diameter # 8213; горизонтальний діаметр
Diameter1 # 8213; вертикальний діаметр
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawImage
Малює зображення на зовнішньому пристрої графічного виведення або растре.
ObjGraphics # 8213; дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення
Left, Top # 8213; координати верхньої лівої точки для малювання зображення
Width, Height # 8213; (Необов'язкові) визначають ширину і висоту зображення; якщо параметри опущені, то використовуються розміри вихідного зображення
DrawImageFromFile
Малює на растрі зображення, лічений з файлу.
FileName # 8213; ім'я та тип файлу, зображення якого буде намальовано на існуючому образі зображення
Left, Top # 8213; координати верхньої лівої точки, від якої буде малюватися зображення
DrawLine
Малює лінію за заданими координатами точок її початку і кінця.
x1, y1 # 8213; координати початкової точки
x2, y2 # 8213; координати кінцевої точки
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawLines
Малює ламану лінію за координатами, заданими в масиві точок координат.
PointArray # 8213; масив координат точок лінії
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawPie
Малює сектор або дугу.
x, y # 8213; координати точки центру сектора (дуги)
Diameter # 8213; горизонтальний діаметр
Diameter1 # 8213; вертикальний діаметр
StartAngle # 8213; дійсне значення, визначає початковий кут (в градусах)
SweepAngle # 8213; дійсне значення, визначає кут сектора (дуги) (в градусах)
ArcFlag # 8213; (Необов'язковий) логічне значення; "Брехня" визначає, що буде намальований сектор
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
FillPie
Зафарбовує сектор.
x, y # 8213; координати точки центру сектора (дуги)
Diameter # 8213; горизонтальний діаметр
Diameter1 # 8213; вертикальний діаметр
StartAngle # 8213; дійсне значення, визначає початковий кут (в градусах)
SweepAngle # 8213; дійсне значення, визначає кут сектора (дуги) (в градусах)
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawPolygon, FillPolygon
Малює (зафарбовує) багатокутник.
PointArray # 8213; масив координат точок багатокутника
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawRectangle, FillRectangle
Малює (зафарбовує) прямокутник.
Left. Top # 8213; координати лівої верхньої точки прямокутника
Width. Height # 8213; ширина і висота прямокутника
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawRectangles, FillRectangles
Малює (зафарбовує) безліч прямокутників.
PointArray # 8213; масив координат точок прямокутників
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
DrawString
Малює текстовий рядок в заданій прямокутній області.
Left. Top # 8213; координати лівої верхньої точки прямокутної області
Width. Height # 8213; ширина і висота прямокутної області; якщо параметри дорівнюють нулю, текст малюється в один рядок
TextString # 8213; мальованої текст
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
Перед викликом методу задайте необхідний шрифт, викликавши метод CreateFont, і, при необхідності, викличте метод CreateStringFormat для завдання напряму виведення тексту
FillImage
Заливає растр вказаним кольором.
Необов'язковий параметр Color задає колір в форматі, повернутому методом ARGB /.
GetImageResolution
Повертає дозвіл растра (dpi).
Параметри (передаються по посиланню):
HorDPI # 8213; дійсне значення; повертає dpi по горизонталі
VertDPI # 8213; дійсне значення; повертає dpi по вертикалі
GetImageSize
Повертає розміри зображення.
У параметри Width і Height (передаються по посиланню) заносяться розміри зображення (в пікселях)
GetMeasureString
Обчислює розміри рядка.
String # 8213; рядок, розмір якої необхідно визначити
Width. Height # 8213; ширина і висота прямокутної області, в якій передбачається виводити рядок; передаються по посиланню і замінюються на фактичні значення
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
GetRawFormat
Визначає графічний формат файлу (BMP, JPEG, GIF і т.д.).
GetStatus
Повертає код стану після виконання методу класу. Позитивні значення ідентифікують помилки, що виникли при виконанні функцій GDIPlus, негативні - додані нами в клас коди помилок. Перелік помилок наведено в таблицях 1 і 2. Якщо метод повертає нуль, то помилок не було.
GraphicsFromImage
Створює об'єкт Graphics, пов'язаний з завантаженим в пам'ять зображенням.
LoadFromFile
Завантажує зображення з файлу в пам'ять.
Параметр FileName визначає ім'я і шлях завантаження
LoadFromField
Завантажує зображення з поля таблиці або змінної Visual FoxPro.
ResizeImage
Змінює розміри зображення, або зберігаючи нове зображення в файлі, або заміщаючи їм вихідне зображення.
NewWidth. NewHeight # 8213; нові розміри зображення
OutputFileName # 8213; (Необов'язковий) ім'я файлу для збереження зображення; якщо параметр опущений, то нове зображення заміщає існуюче
RotateFlip
Виконує відображення і повороти зображення на кут, кратний 90 °.
Параметр RotateFlipCode приймає значення від 0 до 7.
SaveToFileld
Зберігає зображення в поле таблиці або змінної Visual FoxPro.
Параметр GraphicsFormatName містить три символи і задає тип графічного формату (BMP, JPG, GIF, TIF, PNG)
SaveToFile
Зберігає зображення у файлі.
Параметр OutputFileName визначає ім'я і тип файлу для збереження зображення
SetColorGradient
Змінює початковий і кінцевий кольори для існуючої лінійної градієнтної кисті.
Параметри StartColor і EndColor задають початковий і кінцевий кольори градієнтної кисті в форматі, повернутому методом ARGB
SetColorSolidBrush
Змінює колір існуючої одноколірної кисті.
Параметр NewColor задає новий колір одноколірної кисті
SetPenColor
Змінює колір існуючого пера.
Параметр NewColor задає новий колір пера
SetPenStyle
Змінює стиль існуючого пера.
Параметр StyleCode визначає новий стиль пера
SetPenWidth
Змінює товщину існуючого пера.
Параметр Width визначає нову товщину пера
SetSmoothing
Встановлює або скасовує антіаласінг при малюванні графічних примітивів.
Flag # 8213; значення логічного типу; "Істина" встановлює застосування аліасинга
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
SetStringFormatParameter
Встановлює режим вирівнювання тексту і направлення висновку в заданій прямокутній області.
Align # 8213; приймає значення 0, 1 і 2; визначає вирівнювання по лівому краю (0), центрування (1) або вирівнювання по правому краю
Direct # 8213; (Необов'язковий) визначає напрямок виведення тексту; значення "істина" передбачає вертикальний висновок
Перед використанням методу повинен бути створений об'єкт StringFormat (в методі CreateStringFormat)
SetTextRendering
Визначає якість малювання символів (наприклад, можна встановити режим Clear Type).
mode # 8213; приймає значення від 0 до 5
ObjGraphics # 8213; (Необов'язковий) дескриптор об'єкта Graphics, пов'язаного з пристроєм виведення; якщо параметр опущений, то малювання виконується на поточному образі зображення
коди помилок
Код помилки, що виникла при виконанні методу класу, можна отримати за допомогою методу GetStatus.
Якщо GetStatus повертає позитивне число, то це означає, що помилка виникла при виконанні функції GDI +. Коди цих помилок перераховані в таблиці 1.
Якщо GetStatus повертає негативне число, то ця помилка виявлена методом. Коди цих помилок наведено в таблиці 2.
Таблиця 1. Коди помилок GDI +
клас GdipPrinter
Клас призначений для друку зображень, графічних примітивів і текстів на принтері
Створення об'єкта - екземпляра класу:
Якщо ім'я принтера опущено, то об'єкт пов'язується з принтером, встановленим за замовчуванням.
Об'єкт не має відкритих властивостей.
CloseDocument
Закриває документ принтера і відправляє його в чергу друку.
GetGraphics
Повертає дескриптор об'єкта Graphics, пов'язаного з принтером.
GetStatus
Повертає код стану після виконання методу класу. Позитивні значення ідентифікують помилки, що виникли при виконанні функцій GDI +, негативні - додані нами в клас коди помилок. Перелік доданих помилок наведено в таблиці 3. Якщо метод повертає нуль, то помилок не було.
NewPage
Створює нову сторінку в документі принтера.
OpenDocument
Відкриває документ принтера.
SetPageUnit
Встановлює одиницю виміру для друку на принтері і повертає розміри листа принтера в обраних одиницях.
FlagUnit # 8213; логічне значення; "Істина" визначає, що одиницями виміру є міліметри, "брехня" # 8213; пікселі
WidthPage, HeightPage # 8213; в ці передаються по посиланню параметри заносяться значення розмірів листа принтера для обраної одиниці виміру
коди помилок
Код помилки, що виникла при виконанні методу класу, можна отримати за допомогою методу GetStatus.
Якщо GetStatus повертає позитивне число, то це означає, що помилка виникла при виконанні функції GDI +. Коди цих помилок перераховані в таблиці 1.
Якщо GetStatus повертає негативне число, то ця помилка виявлена методом. Коди цих помилок наведено в таблиці 3.
Таблиця 3. Коди помилок класу GdipPrinter