Функция GpiCharString At
В нашем первом приложении, рисующем текст, мы будем использовать функцию GpiCharString At . Префикс имени Gpi означает, что эта функция относится к функциям графического интерфейса GPI.
Прототип функции GpiCharString At , выполняющей рисование текстовой строки, начиная с заданной позиции, приведен ниже:
LONG GpiCharString At ( HPS hps, // иднетификатор пространства отображения PPOINTL pptlPoint, // начальная позиция LONG lCount, // количество символов в строке PCH pchString); // адрес текстовой строки
Параметр hps определяет пространство отображения, в котором будет нарисована текстовая строка. Размер этой строки в байтах задается параметром lCount, а адрес - параметром pchString.
Начальная позиция, в которой будет отображена строка, должна быть записана перед вызовом функции в структуру типа POINTL , содержащей поля x и y типа LONG. Адрес этой структуры передается через параметр pptlPoint.
Ниже приведен фрагмент кода, отображающий текстовую строку Hello, PM!. Нижний левый угол воображаемого прямоугольника, в пределах которого будет нарисована строка, расположен в точке с координатами (10, 10):
POINTL ptl; ptl.x = 10L; ptl.y = 10L; GpiCharString At (hps, &ptl, 10, "Hello, PM!");