Files
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

28 KiB

title, type, api, tags, sources
title type api tags sources
Интерфейс IAssociationView interface
api7
interface
api7
iassociationview
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

Тип данных: 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) или пользовательский стиль линий для отображения видимых линий.