Программирование для IBM OS/2

4.2. Функция 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!");