e1337e4016
docs/Kompas3D_SDK/ становится каноническим источником справки КОМПАС SDK и включается в репозиторий (2491 файл, ~14 МБ). HTML-зеркало docs/KOMPAS_SDK_ru-RU/ (~1.4 ГБ, © АСКОН) и генератор tools/build_kompas3d_sdk.py больше не нужны — регенерация не предполагается. - .gitignore: MD-база разблокирована; зеркало остаётся проигнорированным (safety-net на случай повторной локальной выгрузки). - CLAUDE.md / SKILL.md: убраны упоминания регенерации и зеркала. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
105 lines
4.8 KiB
Markdown
105 lines
4.8 KiB
Markdown
---
|
|
title: "Интерфейс IKompasError"
|
|
type: interface
|
|
api: [api7]
|
|
tags: [interface, api7, ikompaserror]
|
|
sources:
|
|
- ikompaserror.html
|
|
---
|
|
|
|
*API интерфейсов. Версия 7 > Приложение > Информация об ошибках *
|
|
|
|
|
|
## Интерфейс IKompasError
|
|
|
|
Интерфейс информации об ошибке системы КОМПАС.
|
|
Иерархия:
|
|
IKompasAPIObject
|
|
IKompasError
|
|
Описание:
|
|
1. Позволяет получить информацию об ошибке, возникшей при работе API системы КОМПАС.
|
|
2. Системные ошибки описаны двумя перечислениями: Ошибки API ErrorType и Ошибки 3D API ErrorType3d
|
|
В случае возникновения фатальных ошибок большинство методов интерфейсов и экспортных функций API КОМПАС выполняться не будут.
|
|
Если в результате работы библиотеки возникает ошибка, то ее можно снять вызовом одного из следующих свойств и методов: Description, Report или Clear. Если указанные свойства и методы не вызывались, сообщение об ошибке будет автоматически выведено после завершения выполнения команды библиотеки.
|
|
Примечание:
|
|
Данный интерфейс может быть получен от интерфейса приложения IApplication с помощью свойства IApplication::KompasError.
|
|
|
|
|
|
## Clear - Сбросить ошибку
|
|
|
|
Синтаксис Automation:
|
|
```
|
|
void Clear();
|
|
```
|
|
Синтаксис COM:
|
|
```
|
|
HRESULT Clear();
|
|
```
|
|
Примечание:
|
|
В результате выполнения метода код ошибки устанавливается в etSuccess (Успешное завершение).
|
|
|
|
|
|
## Code - Код ошибки
|
|
|
|
Тип данных: из перечисления ErrorType и ErrorType3d.
|
|
Синтаксис Automation:
|
|
```
|
|
Code = iObject.Code Получить свойство (* )
|
|
Code = iObject.GetCode() Получить свойство (**)
|
|
```
|
|
Синтаксис COM:
|
|
```
|
|
iObject->get_Code (&Code) Получить свойство
|
|
```
|
|
Примечание:
|
|
Свойство доступно только для чтения. Так как коды ошибок из ErrorType и ErrorType3d пересекаются, то для определения из какого перечисления взведена ошибка, нужно воспользоваться свойством Error3D.
|
|
|
|
|
|
## Description - Описание ошибки
|
|
|
|
Тип данных:BSTR (строка).
|
|
Синтаксис Automation:
|
|
```
|
|
Description = iObject.Description Получить свойство (* )
|
|
Description = iObject.GetDescription() Получить свойство(**)
|
|
```
|
|
Синтаксис COM:
|
|
```
|
|
iObject->get_Description (&Description) Получить свойство
|
|
```
|
|
Примечание:
|
|
Свойство доступно только для чтения. Позволяет получить символьное описание возникшей ошибки в системе КОМПАС. После выдачи описания ошибки она сбрасывается, т.е. устанавливается в etSuccess (Успешное завершение).
|
|
|
|
|
|
## Error3D - Ошибка для 3D
|
|
|
|
Тип данных:BOOL.
|
|
Синтаксис Automation:
|
|
```
|
|
Error3D = iObject.Error3D Получить свойство (* )
|
|
Error3D = iObject.GetError3D() Получить свойство(**)
|
|
```
|
|
Синтаксис COM:
|
|
```
|
|
iObject->get_Error3D (&Error3D) Получить свойство
|
|
Значения свойства:
|
|
TRUE - ошибка возникла в 3D API (перечисление ErrorType3d),
|
|
FALSE - ошибка из перечисления ErrorType.
|
|
```
|
|
Примечание:
|
|
Свойство доступно только для чтения. Позволяет определить, какому из двух перечислений соответствует код ошибки, полученный через свойство Code
|
|
|
|
|
|
## Report - Вывести сообщение о ошибке
|
|
|
|
Синтаксис Automation:
|
|
```
|
|
void Report();
|
|
```
|
|
Синтаксис COM:
|
|
```
|
|
HRESULT Report();
|
|
```
|
|
Примечание:
|
|
В результате выполнения этого метода на экран выводится диалог с описанием возникшей ошибки. После выдачи сообщения о ошибке она сбрасывается, то есть устанавливается в etSuccess (Успешное завершение).
|