Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.10. Загрузка и сохранение данных блока

А.5.10.9. rdsWriteLineStyleText – запись стиля линии в текстовом формате

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

  void RDSCALL rdsWriteLineStyleText(
    int Style,        // Стиль линии (PS_*)
    BOOL WriteNull    // Писать ли PS_NULL
  );

Тип указателя на эту функцию

RDS_VIB

Параметры

Style (int)

Одна из стандартных констант Windows API, обозначающая стиль линии:

PS_DASH	Пунктирная линия (ключевое слово «dash»).
PS_DASHDOT	Линия из чередующихся отрезков и точек (ключевое слово «dashdot»).
PS_DASHDOTDOT	Линия из повторяющихся групп «отрезок-точка-точка» (ключевое слово «dashdotdot»).
PS_DOT	Линия, состоящая из точек (ключевое слово «dot»).
PS_NULL	Невидимая линия (ключевое слово «empty»).
PS_SOLID	Сплошная линия (ключевое слово «solid»).
PS_INSIDEFRAME	Специальный стиль сплошной линии, разрешающий Windows скорректировать размеры геометрической фигуры, ограниченной этой линией, так, чтобы она уместилась в заданный прямоугольник (ключевое слово «inside»). В RDS используется редко.

Все эти флаги совпадают с флагами, используемыми графической функцией rdsXGSetPenStyle.

WriteNull (BOOL)

TRUE – если параметр Style равен PS_NULL (отсутствие линии), записывать ключевое слово «empty». FALSE – для PS_NULL не записывать ничего.

Примечания

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

Ключевые слова, используемые в функции rdsWriteLineStyleText, совместимы с функцией rdsReadLineStyleText и текстовым форматом схем RDS.

Пример

Вызов функции

  rdsWriteLineStyleText(PS_DASHDOT,FALSE);

добавит к текстовым данным блока пробел и слово «dashdot».

См. также

RDS_BFM_SAVETXT, RDS_BFM_LOADTXT, rdsReadLineStyleText, rdsXGSetPenStyle.