ksGetSpcSectionName - Получить название раздела спецификации, которому принадлежит указанный объект спецификации
guide
api7
guide
api7
ksgetspcsectionname
ksgetspcsectionname.html
*API экспортных функций > Функции работы с документом-спецификацией *
ksGetSpcSectionName - Получить название раздела спецификации, которому принадлежит указанный объект спецификации
Пример...
Аналог данной функции при использовании Automation - метод ksSpecification::ksGetSpcSectionName.
Синтаксис:
int ksGetSpcSectionName (reference spcObj, char* name, int size);
Входной параметр:
spcObj - указатель на объект спецификации.
Выходные параметры:
name - буфер для имени раздела,
size - размер буфера.
Возвращаемое значение:
1 - в случае удачного завершения,
0 - в случае неудачи.
Примечание.
При использовании Unicode следует использовать функцию ksGetSpcSectionNameW.
ksGetSpcSectionName - пример использования
// создадим итератор по вспомогательным объектам спецификации в текущем документе
reference iter = ::CreateSpcIterator (0, 0, 1/вспомогательные объекты спецификации/);
if (iter) {
// встаем на первый объект спецификации
reference spcObj = ::MoveIterator (iter, 'F');
// проверяем, что объект действительно существует
if (spcObj && ::ExistObj (spcObj)) {
do {
char spcSectionName[128]; // имя раздела спецификации
// запрашиваем имя раздела
if (::ksGetSpcSectionName (spcObj, spcSectionName, sizeof (spcSectionName)))
::Message (spcSectionName);
// встаем на следующий объект спецификации
spcObj = ::MoveIterator (iter, 'N');
} while (spcObj && ::ExistObj (spcObj));
}
::DeleteIterator(iter); // удаляем итератор
}
mikhail
e1337e4016