---
title: "Тексты"
type: interface
api: [api7]
domain: [3d]
tags: [interface, api7, 3d, bc3335025]
sources:
  - bc3335025.html
  - imodeltext.html
  - imodeltexts.html
  - imodeltables.html
  - imodeltable.html
---

*API интерфейсов. Версия 7 > Документ 3D *




## Интерфейс IModelText

Интерфейс текста в модели.
Иерархия:
IDispatch
IKompasAPIObject
IModelObjects
IModelText
Примечание:
Интерфейс можно получить, используя свойство IModelTexts::ModelText или метод IModelTexts::Add.
Версия Компас v21


## Allocation - Размещение точки привязки текста

Тип данных: из перечисления ksAllocationEnum
Синтаксис Automation:
```
Allocation = Object.Allocation    Получить свойство (* )
Object.Allocation = Allocation    Установить свойство (* )
Allocation = Object.GetAllocation()    Получить свойство (**)
Object.SetAllocation( Allocation )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Allocation( &Allocation )    Получить свойство
Object.put_Allocation( Allocation )    Установить свойство
```


## Angle - Угол наклона текста

Тип данных: double
Синтаксис Automation:
```
Angle = Object.Angle    Получить свойство (* )
Object.Angle = Angle    Установить свойство (* )
Angle = Object.GetAngle()    Получить свойство (**)
Object.SetAngle( Angle )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Angle( &Angle )    Получить свойство
Object.put_Angle( Angle )    Установить свойство
```


## AssociationObject - Установить опорный объект для точки привязки

Тип данных: Указатель на интерфейс IModelObject
Синтаксис Automation:
```
AssociationObject = Object.AssociationObject    Получить свойство (* )
Object.AssociationObject = AssociationObject    Установить свойство (* )
AssociationObject = Object.GetAssociationObject()    Получить свойство (**)
Object.SetAssociationObject( AssociationObject )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_AssociationObject( &AssociationObject )    Получить свойство
Object.put_AssociationObject( AssociationObject )    Установить свойство
```


## GetPoint - Получить координату точки привязки

Синтаксис Automation:
```
BOOL GetPoint( double * X, double * Y, double * Z );
```
Синтаксис COM:
```
HRESULT GetPoint( double * X, double * Y, double * Z, BOOL * Result );
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
Входные параметры:
X, Y, Z    - координаты точки.
```


## Height - Высота блока форматирования

Тип данных: double
Синтаксис Automation:
```
Height = Object.Height    Получить свойство (* )
Object.Height = Height    Установить свойство (* )
Height = Object.GetHeight()    Получить свойство (**)
Object.SetHeight( Height )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Height( &Height )    Получить свойство
Object.put_Height( Height )    Установить свойство
```


## HFormat - Признак горизонтального форматирования

Тип данных: из перечисления ksTextHorizontalFormatEnum
Синтаксис Automation:
```
HFormat = Object.HFormat    Получить свойство (* )
Object.HFormat = HFormat    Установить свойство (* )
HFormat = Object.GetHFormat()    Получить свойство (**)
Object.SetHFormat( HFormat )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_HFormat( &HFormat )    Получить свойство
Object.put_HFormat( HFormat )    Установить свойство
```


## Plane - Базовая плоскость

Тип данных: Указатель на интерфейс IModelObject
Синтаксис Automation:
```
Plane = Object.Plane    Получить свойство (* )
Object.Plane = Plane    Установить свойство (* )
Plane = Object.GetPlane()    Получить свойство (**)
Object.SetPlane( Plane )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Plane( &Plane )    Получить свойство
Object.put_Plane( Plane )    Установить свойство
```


## PointParameters - Получить интерфейс параметров точки

Тип данных: Указатель на интерфейс IKompasAPIObject
Синтаксис Automation:
```
PointParameters = Object.PointParameters    Получить свойство (* )
PointParameters = Object.GetPointParameters()    Получить свойство (**)
```
Синтаксис COM:
```
Object.get_PointParameters( &PointParameters )    Получить свойство
```
Примечание:
1. Свойство доступно только для чтения.
2. В зависимости от типа PointType интерфейс параметров должен приводится к одному из следующих вариантов:
•ksPDisplace - IPoint3DParamDisplace - интерфейс параметров пространственной точки, заданной по смещению от опорного объекта.
•ksPIntersect - IPoint3DParamIntersect - интерфейс параметров пространственной точки, заданной на пересечении опорных объектов.
•ksPCenter - IPoint3DParamCenter - интерфейс параметров пространственной точки, заданной в центре опорного объекта.
•ksPCurve - IPoint3DParamCurve - интерфейс параметров пространственной точки, заданной на кривой со смещением.
•ksPSurface - IPoint3DparamSurface - интерфейс параметров пространственной точки, заданной на поверхности.
•ksPProjection - IPoint3DParamProjection - интерфейс параметров пространственной точки, заданной проецированием.


## PointParameterType - Тип параметров построения точки привязки

Тип данных: из перечисления ksPoint3DTypeEnum
Синтаксис Automation:
```
PointParameterType = Object.PointParameterType    Получить свойство (* )
Object.PointParameterType = PointParameterType    Установить свойство (* )
PointParameterType = Object.GetPointParameterType()    Получить свойство (**)
Object.SetPointParameterType( PointParameterType )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_PointParameterType( &PointParameterType )    Получить свойство
Object.put_PointParameterType( PointParameterType )    Установить свойство
```


## SetPoint - Установить координату точки привязки

Синтаксис Automation:
```
BOOL SetPoint( double X, double Y, double Z );
```
Синтаксис COM:
```
HRESULT SetPoint( double X, double Y, double Z, BOOL * Result );
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
Входные параметры:
X, Y, Z    - координаты точки.
```


## Text - Текст

Тип данных: Указатель на интерфейс IText
Синтаксис Automation:
```
Text = Object.Text    Получить свойство (* )
Text = Object.GetText()    Получить свойство (**)
```
Синтаксис COM:
```
Object.get_Text( &Text )    Получить свойство
```
Примечание:
Свойство доступно только для чтения.


## TextObjects - Объекты применения в виде SAFEARRAY'я DISPATCH - VT_ARRAY | VT_DISPATCH

Тип данных: VARIANT
Синтаксис Automation:
```
TextObjects = Object.TextObjects    Получить свойство (* )
Object.TextObjects = TextObjects    Установить свойство (* )
TextObjects = Object.GetTextObjects()    Получить свойство (**)
Object.SetTextObjects( TextObjects )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_TextObjects( &TextObjects )    Получить свойство
Object.put_TextObjects( TextObjects )    Установить свойство
```


## VFormat - Признак вертикального форматирования (FALSE - нет форматирования, TRUE - изменение шага строк)

Тип данных: BOOL
Синтаксис Automation:
```
VFormat = Object.VFormat    Получить свойство (* )
Object.VFormat = VFormat    Установить свойство (* )
VFormat = Object.GetVFormat()    Получить свойство (**)
Object.SetVFormat( VFormat )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_VFormat( &VFormat )    Получить свойство
Object.put_VFormat( VFormat )    Установить свойство
```


## Width - Ширина блока форматирования

Тип данных: double
Синтаксис Automation:
```
Width = Object.Width    Получить свойство (* )
Object.Width = Width    Установить свойство (* )
Width = Object.GetWidth()    Получить свойство (**)
Object.SetWidth( Width )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Width( &Width )    Получить свойство
Object.put_Width( Width )    Установить свойство
```


## Интерфейс IModelTexts

Интерфейс коллекции текстов в модели.
Иерархия:
IDispatch
IKompasAPIObject
IKompasCollection
IModelObjects
IModelTexts
Примечание:
Интерфейс можно получить, используя свойство ISymbols3DContainer::ModelTexts.
Версия Компас v21


## Add - Добавить текст в коллекцию

Синтаксис Automation:
```
LPDISPATCH Add();
```
Синтаксис COM:
```
HRESULT Add( IModelText * * Result );
Возвращаемое значение:
Указатель на интерфейс IModelText
```


## ModelText - Получить элемент, заданный по индексу

Тип данных: Указатель на интерфейс IModelText
Синтаксис Automation:
```
ModelText = Object.ModelText( Index )    Получить свойство (* )
ModelText = Object.GetModelText( Index )    Получить свойство (**)
```
Синтаксис COM:
```
Object.get_ModelText( Index, &ModelText )    Получить свойство
```
Примечание:
Свойство доступно только для чтения.


## Интерфейс IModelTables

Интерфейс коллекции таблиц в модели.
Иерархия:
IDispatch
IKompasAPIObject
IKompasCollection
IModelObjects
IModelTables
Примечание:
Интерфейс можно получить, используя свойство ISymbols3DContainer::ModelTables
Версия Компас v21


## Add - Добавить таблицу в коллекцию

Синтаксис Automation:
```
LPDISPATCH Add( long RowsCount, long ColumnsCount, double RowHeigh, double ColumnsWidth, ksTableTileLayoutEnum TitlePos );
```
Синтаксис COM:
```
HRESULT Add( long RowsCount, long ColumnsCount, double RowHeigh, double ColumnsWidth, ksTableTileLayoutEnum TitlePos, IModelTable * * Result );
Возвращаемое значение:
Указатель на интерфейс IModelTable.
Входные параметры:
RowsCount    - количество строк,
ColumnsCount    - количество колонок,
RowHeigh    - высота ячеек,
ColumnsWidth    - ширина ячеек,
TitlePos    - положение заголовка таблицы из перечисления ksTableTileLayoutEnum.
```


## Load - Загрузить таблицу из файла

Синтаксис Automation:
```
LPDISPATCH Load( BSTR FileName );
```
Синтаксис COM:
```
HRESULT Load( BSTR FileName, IModelTable * * Result );
Возвращаемое значение:
- Указатель на интерфейс IModelTable.
Входные параметры:
FileName    - имя файла таблицы.
```


## ModelTable - Получить таблицу по индексу

Тип данных: Указатель на интерфейс IModelTable
Синтаксис Automation:
```
ModelTable = Object.ModelTable( Index )    Получить свойство (* )
ModelTable = Object.GetModelTable( Index )    Получить свойство (**)
```
Синтаксис COM:
```
Object.get_ModelTable( Index, &ModelTable )    Получить свойство
Входные параметры:
VARIANT Index    - индекс или имя объекта.
```
Примечание:
Свойство доступно только для чтения.


## Интерфейс IModelTable

Интерфейс таблицы в модели.
Иерархия:
IDispatch
IKompasAPIObject
IModelObjects
IModelTable
Примечание:
Интерфейс можно получить, используя свойство IModelTables::ModelTable или метод IModelTables::Add.
Версия Компас v21


## Angle - Угол наклона текста

Тип данных: double
Синтаксис Automation:
```
Angle = Object.Angle    Получить свойство (* )
Object.Angle = Angle    Установить свойство (* )
Angle = Object.GetAngle()    Получить свойство (**)
Object.SetAngle( Angle )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Angle( &Angle )    Получить свойство
Object.put_Angle( Angle )    Установить свойство
```


## AssociationObject - Установить опорный объект для точки привязки

Тип данных: Указатель на интерфейс IModelObject
Синтаксис Automation:
```
AssociationObject = Object.AssociationObject    Получить свойство (* )
Object.AssociationObject = AssociationObject    Установить свойство (* )
AssociationObject = Object.GetAssociationObject()    Получить свойство (**)
Object.SetAssociationObject( AssociationObject )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_AssociationObject( &AssociationObject )    Получить свойство
Object.put_AssociationObject( AssociationObject )    Установить свойство
```


## FixedCellsSize - Зафиксировать габариты ячеек

Тип данных: BOOL
Синтаксис Automation:
```
FixedCellsSize = Object.FixedCellsSize    Получить свойство (* )
Object.FixedCellsSize = FixedCellsSize    Установить свойство (* )
FixedCellsSize = Object.GetFixedCellsSize()    Получить свойство (**)
Object.SetFixedCellsSize( FixedCellsSize )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_FixedCellsSize( &FixedCellsSize )    Получить свойство
Object.put_FixedCellsSize( FixedCellsSize )    Установить свойство
```


## FixedColumnCount - Запретить изменять число столбцов

Тип данных: BOOL
Синтаксис Automation:
```
FixedColumnCount = Object.FixedColumnCount    Получить свойство (* )
Object.FixedColumnCount = FixedColumnCount    Установить свойство (* )
FixedColumnCount = Object.GetFixedColumnCount()    Получить свойство (**)
Object.SetFixedColumnCount( FixedColumnCount )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_FixedColumnCount( &FixedColumnCount )    Получить свойство
Object.put_FixedColumnCount( FixedColumnCount )    Установить свойство
```


## FixedRowCount - Запретить изменять число строк

Тип данных: BOOL
Синтаксис Automation:
```
FixedRowCount = Object.FixedRowCount    Получить свойство (* )
Object.FixedRowCount = FixedRowCount    Установить свойство (* )
FixedRowCount = Object.GetFixedRowCount()    Получить свойство (**)
Object.SetFixedRowCount( FixedRowCount )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_FixedRowCount( &FixedRowCount )    Получить свойство
Object.put_FixedRowCount( FixedRowCount )    Установить свойство
```


## GetPoint - Получить координату точки привязки

Синтаксис Automation:
```
BOOL GetPoint( double * X, double * Y, double * Z );
```
Синтаксис COM:
```
HRESULT GetPoint( double * X, double * Y, double * Z, BOOL * Result );
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
Выходные параметры:
X, Y, Z    - координаты точки.
```


## Plane - Базовая плоскость

Тип данных: Указатель на интерфейс IModelObject
Синтаксис Automation:
```
Plane = Object.Plane    Получить свойство (* )
Object.Plane = Plane    Установить свойство (* )
Plane = Object.GetPlane()    Получить свойство (**)
Object.SetPlane( Plane )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Plane( &Plane )    Получить свойство
Object.put_Plane( Plane )    Установить свойство
```


## PointParameters - Получить интерфейс параметров точки

Тип данных: Указатель на интерфейс IKompasAPIObject
Синтаксис Automation:
```
PointParameters = Object.PointParameters    Получить свойство (* )
PointParameters = Object.GetPointParameters()    Получить свойство (**)
```
Синтаксис COM:
```
Object.get_PointParameters( &PointParameters )    Получить свойство
```
Примечание:
Свойство доступно только для чтения.


## PointParameterType - Тип параметров построения точки привязки

Тип данных: из перечисления ksPoint3DTypeEnum
Синтаксис Automation:
```
PointParameterType = Object.PointParameterType    Получить свойство (* )
Object.PointParameterType = PointParameterType    Установить свойство (* )
PointParameterType = Object.GetPointParameterType()    Получить свойство (**)
Object.SetPointParameterType( PointParameterType )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_PointParameterType( &PointParameterType )    Получить свойство
Object.put_PointParameterType( PointParameterType )    Установить свойство
```


## Save - Сохранить в файл

Синтаксис Automation:
```
BOOL Save( BSTR FileName );
```
Синтаксис COM:
```
HRESULT Save( BSTR FileName, BOOL * Result );
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
Входные параметры:
FileName    - имя файла таблицы.
```


## SetPoint - Установить координату точки привязки

Синтаксис Automation:
```
BOOL SetPoint( double X, double Y, double Z );
```
Синтаксис COM:
```
HRESULT SetPoint( double X, double Y, double Z, BOOL * Result );
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
Входные параметры:
X, Y, Z    - координаты точки.
```


## Table - Получить интерфейс таблицы

Тип данных: Указатель на интерфейс ITable
Синтаксис Automation:
```
Table = Object.Table    Получить свойство (* )
Table = Object.GetTable()    Получить свойство (**)
```
Синтаксис COM:
```
Object.get_Table( &Table )    Получить свойство
```
Примечание:
Свойство доступно только для чтения.


## TableObjects - Объекты применения в виде SAFEARRAY'я DISPATCH - VT_ARRAY | VT_DISPATCH

Тип данных: VARIANT
Синтаксис Automation:
```
TableObjects = Object.TableObjects    Получить свойство (* )
Object.TableObjects = TableObjects    Установить свойство (* )
TableObjects = Object.GetTableObjects()    Получить свойство (**)
Object.SetTableObjects( TableObjects )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_TableObjects( &TableObjects )    Получить свойство
Object.put_TableObjects( TableObjects )    Установить свойство
Версия Компас v23
```
