kompas3d-mcp/docs/Kompas3D_SDK/interfaces/ksplanetangenttosurfacedefinition.md

---
title: "Касательная плоскость (Интерфейсы ksPlaneTangentToSurfaceDefinition, IPlaneTangentToSurfaceDefinition)"
type: interface
api: [api7]
domain: [2d]
tags: [interface, api7, 2d, ksplanetangenttosurfacedefinition]
sources:
  - ksplanetangenttosurfacedefinition.html
---

*API интерфейсов. Версия 5 > Документ-модель (Интерфейсы - ksDocument3D, IDocument3D )  > Компонент сборки (деталь или подсборка). Интерфейсы ksPart и IPart  > Объект модели (Интерфейсы ksEntity и IEntity)  > Интерфейсы ksEntity и iEntity - Интерфейс элемента модели (оси, плоскости, формообразующего элемента)  > Интерфейсы вспомогательной геометрии *


## Касательная плоскость (Интерфейсы ksPlaneTangentToSurfaceDefinition, IPlaneTangentToSurfaceDefinition)

Интерфейс параметров касательной плоскости.
| ksPlaneTangentToSurfaceDefinition | - интерфейс Automation |
| --- | --- |
| IPlaneTangentToSurfaceDefinition | - интерфейс COM |
Примечание:
Данный интерфейс можно получить, используя метод интерфейса элемента модели ksEntity::GetDefinition или IEntity::GetDefinition.


## angle - Угол между плоскостью и плоскостью, перпендикулярной опорному объекту

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


## choosePlane - Изменение положения касательной плоскости относительно выбранной цилиндрической или конической грани

Тип данных: long
Значения свойства:
| 1 | - положение, предложенное по умолчанию, |
| --- | --- |
| 0 | - положение, противоположное предложенному по умолчанию. |
Синтаксис Automation:
```
choosePlane = iPlaneTangentToSurface.choosePlane    Получить свойство(* )
iPlaneTangentToSurface.choosePlane = choosePlane    Установить свойство (* )
choosePlane = iPlaneTangentToSurface.GetChoosePlane()    Получить свойство (**)
iPlaneTangentToSurface.SetChoosePlane(choosePlane)    Установить свойство (**)
```


## GetFace - Получить указатель на интерфейс цилиндрической или конической грани, к которой требуется построить касательную плоскость

Синтаксис Automation:
```
LPDISPATCH GetFace();
```
Синтаксис COM:
```
LPENTITY GetFace();
Возвращаемое значение:
- указатель на интерфейс грани ksEntity или IEntity.
```


## GetPlane - Получить указатель на интерфейс плоского объекта, параллельно которому должна пройти новая плоскость

Синтаксис Automation:
```
LPDISPATCH GetPlane();
```
Синтаксис COM:
```
LPENTITY GetPlane();
Возвращаемое значение:
- указатель на интерфейс плоской грани или плоскости ksEntity или IEntity.
```


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

Синтаксис Automation:
```
LPDISPATCH GetSurface();
```
Синтаксис COM:
```
LPSURFACE GetSurface();
Возвращаемое значение:
- указатель на интерфейс плоской грани или плоскости ksSurface или ISurface.
```


## SetFace - Установить указатель на интерфейс цилиндрической или конической грани, к которой требуется построить касательную плоскость

Синтаксис Automation:
```
BOOL SetFace (LPDISPATCH face);
```
Синтаксис COM:
```
BOOL SetFace (LPENTITY face);
Входной параметр:
plane    - указатель на интерфейс грани ksEntity или IEntity.
Возвращаемое значение:
TRUE    - в случае успешного завершения.
```


## SetPlane - Установить указатель на интерфейс плоского объекта, параллельно которому должна пройти новая плоскость

Синтаксис Automation:
```
BOOL SetPlane (LPDISPATCH plane);
```
Синтаксис COM:
```
BOOL SetPlane (LPENTITY plane);
Входной параметр:
plane    - указатель на интерфейс плоской грани или плоскости ksEntity или IEntity.
Возвращаемое значение:
TRUE    - в случае успешного завершения.
```