Files
kompas3d-mcp/docs/Kompas3D_SDK/interfaces/iassociationview.md
T
mikhail e1337e4016 feat(sdk-docs): MD-база знаний SDK — в репозиторий; генератор и зеркало убраны
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>
2026-05-26 20:00:05 +03:00

660 lines
28 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Интерфейс IAssociationView"
type: interface
api: [api7]
tags: [interface, api7, iassociationview]
sources:
- iassociationview.html
---
*API интерфейсов. Версия 7 > Документ 2D  > Виды и слои  > Интерфейс IDrawingObject  > IDrawingObject - методы  > Интерфейс IView  > IView - свойства *
## Интерфейс IAssociationView
Интерфейс ассоциативного вида графического документа.
Иерархия:
IKompasAPIObject
IDrawingObject
IView
IAssociationView
IHatchParam
IAssociationViewElements
Описание:
Типы видов описаны в перечислении LtViewType.
Примечание:
1. Данный интерфейс можно получить следующими способами:
•через коллекцию видов IViews,
•с помощью метода IUnknown QueryInterface от интерфейса IView.
2. Посредством вызова метода IUnknown::QueryInterface (const GUID far& iid, void** pif) интерфейс позволяет получить дополнительные интерфейсы:
•IHatchParam
•IAssociationViewElements.
## AssociationObjects - Получить массив SAFEARRAY ассоциативных объектов по 3D объекту
Тип данных: VARIANT
Синтаксис Automation:
```
AssociationObjects = Object.AssociationObjects( ModelObject ) Получить свойство (* )
AssociationObjects = Object.GetAssociationObjects( ModelObject ) Получить свойство (**)
```
Синтаксис COM:
```
Object.get_AssociationObjects(ModelObject, &AssociationObjects ) Получить свойство
```
Примечание:
Свойство доступно только для чтения.
Версия: Компас v20
## BaseObject - Опорный объект
Тип данных: указатель на интерфейс IDrawingObject
Синтаксис Automation:
```
BaseObject = Object.BaseObject Получить свойство (* )
Object.BaseObject = BaseObject Установить свойство (* )
BaseObject = Object.GetBaseObject() Получить свойство (**)
Object.SetBaseObject( BaseObject ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_BaseObject( &BaseObject ) Получить свойство,
Object.put_BaseObject( BaseObject ) Установить свойство.
```
Примечание:
В зависимости от типа ассоциативного вида нужно указать вспомогательный опорный объект.
Опорный объект требуется при создании следующих видов:
•Вид по стрелке - требуется объект Стрелка взгляда,
•Выносной вид - требуется объект Обозначение выносного элемента,
•Вид разрез/сечение - требуется объект Линия разреза.
## BaseView - Опорный вид
Тип данных: указатель на интерфейс вида IView
Синтаксис Automation:
```
BaseView = Object.BaseView Получить свойство (* )
Object.BaseView = BaseView Установить свойство (* )
BaseView = Object.GetBaseView() Получить свойство (**)
Object.SetBaseView( BaseView ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_BaseView( &BaseView ) Получить свойство,
Object.put_BaseView( BaseView ) Установить свойство.
```
Примечание:
Свойство используется при создании проекционного вида.
Позволяет установить вид, относительно которого выполняется производная проекция.
Базовый вид должен быть ассоциативным.
## BendLinesStyle - Cтиль линий сгиба
Тип данных: BOOL
Синтаксис Automation:
```
BendLinesStyle = Object.BendLinesStyle Получить свойство (* )
Object.BendLinesStyle = BendLinesStyle Установить свойство (* )
BendLinesStyle = Object.GetBendLinesStyle() Получить свойство (**)
Object.SetBendLinesStyle( BendLinesStyle ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_BendLinesStyle( &BendLinesStyle ) Получить свойство,
Object.put_BendLinesStyle( BendLinesStyle ) Установить свойство.
```
Примечание:
Позволяет установить системный (ksCurveStyleEnum) или пользовательский стиль линий для отображения линий сгиба.
## BendLinesVisible - Показывать линии сгиба
Тип данных: BOOL
Синтаксис Automation:
```
BendLinesVisible = Object.BendLinesVisible Получить свойство (* )
Object.BendLinesVisible = BendLinesVisible Установить свойство (* )
BendLinesVisible = Object.GetBendLinesVisible() Получить свойство (**)
Object.SetBendLinesVisible( BendLinesVisible ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_BendLinesVisible( &BendLinesVisible ) Получить свойство,
Object.put_BendLinesVisible( BendLinesVisible ) Установить свойство.
Свойство позволяет получить и установить признак отображения линий сгиба.
```
## BreakLinesStyle - Cтиль линий перехода
Тип данных: long
Синтаксис Automation:
```
BreakLinesStyle = Object.BreakLinesStyle Получить свойство (* )
Object.BreakLinesStyle = BreakLinesStyle Установить свойство (* )
BreakLinesStyle = Object.GetBreakLinesStyle() Получить свойство (**)
Object.SetBreakLinesStyle( BreakLinesStyle ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_BreakLinesStyle( &BreakLinesStyle ) Получить свойство,
Object.put_BreakLinesStyle( BreakLinesStyle ) Установить свойство.
```
Примечание:
Позволяет установить системный (ksCurveStyleEnum) или пользовательский стиль линий для отображения линий перехода.
## BreakLinesVisible - Показывать линии перехода
Тип данных: long
Синтаксис Automation:
```
BreakLinesVisible = Object.BreakLinesVisible Получить свойство (* )
Object.BreakLinesVisible = BreakLinesVisible Установить свойство (* )
BreakLinesVisible = Object.GetHiddenLinesVisible() Получить свойство (**)
Object.SetBreakLinesVisible( BreakLinesVisible ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_BreakLinesVisible( &BreakLinesVisible ) Получить свойство,
Object.put_BreakLinesVisible( BreakLinesVisible ) Установить свойство.
```
## CenterLinesVisible - Показывать осевые линии
Тип данных: BOOL
Синтаксис Automation:
```
CenterLinesVisible = Object.CenterLinesVisible Получить свойство (* )
Object.CenterLinesVisible = CenterLinesVisible Установить свойство (* )
CenterLinesVisible = Object.GetCenterLinesVisible() Получить свойство (**)
Object.SetCenterLinesVisible( CenterLinesVisible ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_CenterLinesVisible( &CenterLinesVisible ) Получить свойство,
Object.put_CenterLinesVisible( CenterLinesVisible ) Установить свойство.
```
## CreateLocalView - Местный вид
Синтаксис Automation:
```
BOOL CreateLocalView( LPDISPATCH Contour );
```
Синтаксис COM:
```
HRESULT CreateLocalView( IDrawingObject * Contour, BOOL * Result );
Входные параметры:
Contour - указатель на замкнутую кривую.
Возвращаемое значение:
TRUE - в случае успешного завершения,
FALSE - в случае неудачи.
```
Примечание:
Границей местного вида может являться любой замкнутый контур (окружность, эллипс, замкнутая кривая Безье и т.п.).
Если в опорном виде нет замкнутого контура, создайте его
Необходимым условием корректного построения местного вида является расположение ограничивающего его контура именно в опорном виде.
Переключение между полным и усеченным отображением вида осуществляется с помощью свойства IAssociationView::Local.
## DimensionLayoutScaling - Масштабировать аннотационные объекты вида
Тип данных: BOOL
Синтаксис Automation:
```
Object.DimensionLayoutScaling = DimensionLayoutScaling Установить свойство (* )
Object.SetDimensionLayoutScaling( DimensionLayoutScaling ) Установить свойство (**)
```
Синтаксис COM:
```
Object.put_DimensionLayoutScaling( DimensionLayoutScaling ) Установить свойство.
```
Примечание:
1. Свойство доступно только для изменения.
2. Значение свойства не сохраняется и используется при создании и изменении параметров вида.
## ExplodedView - Сборка в разнесенном виде
Тип данных: BOOL
Синтаксис Automation:
```
ExplodedView = Object.ExplodedView Получить свойство (* )
Object.ExplodedView = ExplodedView Установить свойство (* )
ExplodedView = Object.GetExplodedView() Получить свойство (**)
Object.SetExplodedView( ExplodedView ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_ExplodedView( &ExplodedView ) Получить свойство,
Object.put_ExplodedView( ExplodedView ) Установить свойство.
```
## FindFace - Найти грань по точке в чертеже
Синтаксис Automation:
```
LPDISPATCH FindFace( double X, double Y, IKompasDocument3D * Document3D );
```
Синтаксис COM:
```
HRESULT FindFace( double X, double Y, IKompasDocument3D * Document3D, IModelObject * * Result );
Возвращаемое значение:
- интерфейс объекта модели IModelObject.
Входные параметры:
X, Y - координаты точки,
Document3D - указатель на интерфейс документа IKompasDocument3D.
Версия: Компас v20
```
## FindFaceEdges - Получить массив SAFEARRAY ассоциативных объектов ребер грани по точке в чертеже
Синтаксис Automation:
```
VARIANT FindFaceEdges( double X, double Y );
Синтаксис COM :
HRESULT FindFaceEdges( double X, double Y, VARIANT * Result );
Возвращаемое значение:
- объект (VT_DISPATCH) или Список объектов VT_ARRAY VT_DISPATCH, VT_EMPTY - если объекты не найдены.
Входные параметры:
X, Y - координаты точки.
Версия: Компас v20
```
## GetProjectionObjects - Получить массив SAFEARRAY проецируемых объектов. Вставка или тела
Синтаксис Automation:
```
VARIANT GetProjectionObjects( IKompasDocument3D * Document3D );
```
Синтаксис COM:
```
HRESULT GetProjectionObjects( IKompasDocument3D * Document3D, VARIANT * Result );
Входные параметры:
Document3D - документ IKompasDocument3D.
Возвращаемое значение:
- Список объектов в виде SAFEARRAY'я DISPATCH - VT_ARRAY VT_DISPATCH.
Версия КОМПАС v22
```
## GetProjectionPoint - Получить координаты точки на виде по 3D координатам модели
Синтаксис Automation:
```
BOOL GetProjectionPoint( double X, double Y, double Z, double * Xv, double * Yv );
```
Синтаксис COM:
```
HRESULT GetProjectionPoint( double X, double Y, double Z, double * Xv, double * Yv, BOOL * Result );
Возвращаемое значение:
TRUE - в случае успешного завершения,
FALSE - в случае неудачи.
Входные параметры:
X, Y, Z - координаты точки в 3D документе.
Выходные параметры:
Xv, Yv - координаты проекции точки.
Версия КОМПАС v22
```
## HatchParametersFromModel - Использовать параметры ассоциативной штриховки из модели
Тип данных: BOOL
Синтаксис Automation:
```
HatchParametersFromModel = Object.HatchParametersFromModel Получить свойство (* )
Object.HatchParametersFromModel = HatchParametersFromModel Установить свойство (* )
HatchParametersFromModel = Object.GetHatchParametersFromModel() Получить свойство (**)
Object.SetHatchParametersFromModel( HatchParametersFromModel ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_HatchParametersFromModel( &HatchParametersFromModel ) Получить свойство,
Object.put_HatchParametersFromModel( HatchParametersFromModel ) Установить свойство.
КOMPAS v24
```
## HiddenLines - Передавать невидимые линии в вид
Тип данных: long
Синтаксис Automation:
```
HiddenLines = Object.HiddenLines Получить свойство (* )
Object.HiddenLines = HiddenLines Установить свойство (* )
HiddenLines = Object.GetHiddenLines() Получить свойство (**)
Object.SetHiddenLines( HiddenLines ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_HiddenLines( &HiddenLines ) Получить свойство,
Object.put_HiddenLines( HiddenLines ) Установить свойство.
Позволяет получить и установить признак отображения невидимых линий при проецировании.
```
Примечание:
Невидимые линии хранятся в виде вне зависимости от того, включена их отрисовка или нет (IAssociationView::HiddenLinesVisible).
Если отрисовка этих линий не требуется, отключите опцию Невидимые линии — это уменьшит размер файла чертежа.
Рекомендуется отключать опцию Невидимые линии при построении ассоциативных видов сборок, содержащих более 1000 компонентов.
## HiddenLinesStyle - Cтиль невидимых линий
Тип данных: long
Синтаксис Automation:
```
HiddenLinesStyle = Object.HiddenLinesStyle Получить свойство (* )
Object.HiddenLinesStyle = HiddenLinesStyle Установить свойство (* )
HiddenLinesStyle = Object.GetHiddenLinesStyle() Получить свойство (**)
Object.SetHiddenLinesStyle( HiddenLinesStyle ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_HiddenLinesStyle( &HiddenLinesStyle ) Получить свойство,
Object.put_HiddenLinesStyle( HiddenLinesStyle ) Установить свойство.
```
Примечание:
Позволяет установить системный (ksCurveStyleEnum) или пользовательский стиль линий для отображения невидимых линий
Для использования данного свойства требуется включение передачи невидимых линий (IAssociationView::HiddenLines) и включение отображения невидимых линий (IAssociationView::HiddenLinesVisible).
## HiddenLinesVisible - Показывать невидимые линии
Тип данных: long
Синтаксис Automation:
```
HiddenLinesVisible = Object.HiddenLinesVisible Получить свойство (* )
Object.HiddenLinesVisible = HiddenLinesVisible Установить свойство (* )
HiddenLinesVisible = Object.GetHiddenLinesVisible() Получить свойство (**)
Object.SetHiddenLinesVisible( HiddenLinesVisible ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_HiddenLinesVisible( &HiddenLinesVisible ) Получить свойство,
Object.put_HiddenLinesVisible( HiddenLinesVisible ) Установить свойство.
Свойство позволяет получить и установить признак отображения невидимых линий.
```
Примечание:
Для использования данного свойства требуется включение передачи невидимых линий (IAssociationView::HiddenLines).
## IsAssociationObjectsVisible - Получить признак видимости ассоциативных объектов по 3D объекту
Тип данных: BOOL
Синтаксис Automation:
```
IsAssociationObjectsVisible = Object.IsAssociationObjectsVisible( ModelObject ) Получить свойство (* )
IsAssociationObjectsVisible = Object.GetIsAssociationObjectsVisible( ModelObject ) Получить свойство (**)
```
Синтаксис COM:
```
Object.get_IsAssociationObjectsVisible( ModelObject, &IsAssociationObjectsVisible ) Получить свойство
```
Примечание:
Свойство доступно только для чтения.
Версия: Компас v20
## IsViewProjectionPointInBreakView - Видна ли проекция точки на виде с разрывами
Синтаксис Automation:
```
BOOL IsViewProjectionPointInBreakView( double X, double Y, double Z );
```
Синтаксис COM:
```
HRESULT IsViewProjectionPointInBreakView( double X, double Y, double Z, BOOL * Result );
Входные параметры:
Contour - указатель на замкнутую кривую.
Возвращаемое значение:
TRUE - в случае успешного завершения,
FALSE - в случае неудачи.
Входные параметры:
X, Y, Z - координаты точки в 3D документе.
Версия КОМПАС v22
```
## Local - Местный вид
Тип данных: BOOL
Синтаксис Automation:
```
Local = Object.Local Получить свойство (* )
Object.Local = Local Установить свойство (* )
Local = Object.GetLocal() Получить свойство (**)
Object.SetLocal( Local ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Local( &Local ) Получить свойство,
Object.put_Local( Local ) Установить свойство.
```
Примечание:
Включает полное изображение вида или усеченное (местный вид).
Требует предварительного создания местного вида с помощью команды IAssociationView::CreateLocalView
## ProjectionLink - Проекционная связь
Тип данных: BOOL
Синтаксис Automation:
```
ProjectionLink = Object.ProjectionLink Получить свойство (* )
Object.ProjectionLink = ProjectionLink Установить свойство (* )
ProjectionLink = Object.GetProjectionLink() Получить свойство (**)
Object.SetProjectionLink( ProjectionLink ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_ProjectionLink( &ProjectionLink ) Получить свойство,
Object.put_ProjectionLink( ProjectionLink ) Установить свойство.
Свойство позволяет получить и установить состояние проекционной связи между ассоциативными видами.
```
## ProjectionMatrix - Матрица ассоциативного вида
Тип данных: VARIANT
Синтаксис Automation:
```
ProjectionMatrix = Object.ProjectionMatrix Получить свойство (* )
Object.ProjectionMatrix = ProjectionMatrix Установить свойство (* )
ProjectionMatrix = Object.GetProjectionMatrix() Получить свойство (**)
Object.SetProjectionMatrix( ProjectionMatrix ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_ProjectionMatrix( &ProjectionMatrix ) Получить свойство,
Object.put_ProjectionMatrix( ProjectionMatrix ) Установить свойство.
```
Примечание
Матрица представляет собой массив SAFEARRAY double (VT_ARRAY | VT_R8)
В массиве будут лежать 16 элементов, которые представляют собой матрицу размера 4х4.
## ProjectionName - Имя проекции
Тип данных: BSTR
Синтаксис Automation:
```
ProjectionName = Object.ProjectionName Получить свойство (* )
Object.ProjectionName = ProjectionName Установить свойство (* )
ProjectionName = Object.GetProjectionName() Получить свойство (**)
Object.SetProjectionName (ProjectionName) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_ProjectionName (&ProjectionName) Получить свойство,
Object.put_ProjectionName (ProjectionName) Установить свойство.
Свойство позволяет получить и установить имя проекции (из списка проекций в документе-источнике).
```
## Rebuild - Перестроить вид
Синтаксис Automation:
```
BOOL Rebuild();
```
Синтаксис COM:
```
HRESULT Rebuild( BOOL * Result );
Возвращаемое значение:
TRUE - в случае успешного завершения,
FALSE - в случае неудачи.
КOMPAS v24
```
## RestoreStyles - Восстановить стили объектов ассоциативного вида
Синтаксис Automation:
```
BOOL RestoreStyles();
```
Синтаксис COM:
```
HRESULT RestoreStyles( BOOL * Result );
Возвращаемое значение:
TRUE - в случае успешного завершения,
FALSE - в случае неудачи.
Версия КОМПАС v22
```
## SameHatch - Признак одинаковой штриховки всех деталей сборки
Тип данных: BOOL
Синтаксис Automation:
```
SameHatch = Object.SameHatch Получить свойство (* )
Object.SameHatch = SameHatch Установить свойство (* )
SameHatch = Object.GetSameHatch() Получить свойство (**)
Object.SetSameHatch( SameHatch ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_SameHatch( &SameHatch ) Получить свойство,
Object.put_SameHatch( SameHatch ) Установить свойство.
```
Примечание:
Свойство используется только в виде разрез/сечение.
## Section - Признак «разрез/сечение»
Тип данных: BOOL
Синтаксис Automation:
```
Section = Object.Section Получить свойство (* )
Object.Section = Section Установить свойство (* )
Section = Object.GetSection() Получить свойство (**)
Object.SetSection( Section ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Section( &Section ) Получить свойство,
Object.put_Section( Section ) Установить свойство.
Свойство позволяет получить и установить признак «разрез/сечение».
```
## SetProjectionObjects - Установить массив SAFEARRAY проецируемых объектов. Вставка или тела
Синтаксис Automation:
```
BOOL SetProjectionObjects( VARIANT Objects );
```
Синтаксис COM:
```
HRESULT SetProjectionObjects( VARIANT Objects, BOOL * Result );
Возвращаемое значение:
TRUE - в случае успешного завершения,
FALSE - в случае неудачи.
Входные параметры:
Objects - cписок объектов VT_ARRAY VT_DISPATCH.
Версия КОМПАС v22
```
## SourceFileName - Полное имя файла-источника
Тип данных: BSTR
Синтаксис Automation:
```
SourceFileName = Object.SourceFileName Получить свойство (* )
Object.SourceFileName = SourceFileName Установить свойство (* )
SourceFileName = Object.GetSourceFileName() Получить свойство (**)
Object.SetSourceFileName (SourceFileName) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_SourceFileName (&SourceFileName) Получить свойство,
Object.put_SourceFileName (SourceFileName) Установить свойство.
Свойство позволяет получить и установить полное имя файла модели или сборки, для которой создан ассоциативный вид.
```
## Unfold - Листовая деталь в разогнутом виде
Тип данных:BOOL
Синтаксис Automation:
```
Unfold = Object.Unfold Получить свойство (* )
Object.Unfold = Unfold Установить свойство (* )
Unfold = Object.GetUnfold() Получить свойство (**)
Object.SetUnfold( Unfold ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Unfold( &Unfold ) Получить свойство,
Object.put_Unfold( Unfold ) Установить свойство.
```
## UseOcclusion - Черновое проецирование
Тип данных: BOOL
Синтаксис Automation:
```
UseOcclusion = Object.UseOcclusion Получить свойство (* )
Object.UseOcclusion = UseOcclusion Установить свойство (* )
UseOcclusion = Object.GetUseOcclusion() Получить свойство (**)
Object.SetUseOcclusion( UseOcclusion ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_UseOcclusion( &UseOcclusion ) Получить свойство,
Object.put_UseOcclusion( UseOcclusion ) Установить свойство.
Версия Компас v18.1
```
## VisibleLinesStyle - Cтиль видимых линий
Тип данных: long
Синтаксис Automation:
```
VisibleLinesStyle = Object.VisibleLinesStyle Получить свойство (* )
Object.VisibleLinesStyle = VisibleLinesStyle Установить свойство (* )
VisibleLinesStyle = Object.GetVisibleLinesStyle() Получить свойство (**)
Object.SetVisibleLinesStyle( VisibleLinesStyle ) Установить свойство (**)
```
Синтаксис COM:
```
Object.get_VisibleLinesStyle( &VisibleLinesStyle ) Получить свойство,
Object.put_VisibleLinesStyle( VisibleLinesStyle ) Установить свойство.
Позволяет установить системный (ksCurveStyleEnum) или пользовательский стиль линий для отображения видимых линий.
```