---
title: "Интерфейс фильтрации объектов документа-модели (Интерфейс ksObjectsFilter3D)"
type: interface
api: [api7]
domain: [3d]
tags: [interface, api7, 3d, ksobjectsfilter3d]
sources:
  - ksobjectsfilter3d.html
---

*API интерфейсов. Версия 5*


## Интерфейс фильтрации объектов документа-модели (Интерфейс ksObjectsFilter3D)

Интерфейс фильтрации объектов документа-модели.
| ksObjectsFilter3D | - интерфейс Automation |
| --- | --- |
| IObjectsFilter3D | - интерфейс COM |
Примечание:
1. Служит для включения режима, в котором возможен динамический поиск и указание курсором объектов модели: осей, плоскостей, граней, ребер и вершин.
2. Если установить свойство filterAll, то остальные флаги снимаются.
3. После установки любого свойства, разрешающего поиск и указание объектов определенного типа, свойство Фильтровать все отключается.
4. Если выключаются флаги, соответствующие типам объектов, то флаг Фильтровать все автоматически включается (то есть отключить указание всех типов объектов невозможно).
5. Указатель на интерфейс можно получить, используя свойство KompasObject::ksGetObjectsFilter3D или экспортную функцию ksGetObjectsFilter3D.


## filterAll - Фильтровать все

Тип данных: BOOL
Значения свойства:
| TRUE | - разрешить фильтрацию для всех типов объектов, |
| --- | --- |
| FALSE | - фильтрация разрешена только для конкретных типов объектов. |
Синтаксис Automation:
```
filterAll = iObjFilter3D.filterAll;    Получить свойство (* )
iObjFilter3D.filterAll = filterAll;    Установить свойство (* )
filterAll = iObjFilter3D.GetFilterAll();    Получить свойство (**)
iObjFilter3D.SetFilterAll(filterAll);    Установить свойство (**)
```
Синтаксис COM:
```
filterAll = iObjFilter3D.GetFilterAll();    Получить свойство
iObjFilter3D.SetFilterAll(filterAll);    Установить свойство
```
Примечание:
Напрямую установить свойство равным FALSE нельзя. Свойство устанавливается равным FALSE после установки любых флагов для конкретных типов объектов.


## filterCAxis - Фильтровать конструктивные оси

Тип данных: BOOL
Значения свойства:
| TRUE | - разрешить фильтрацию конструктивных осей, |
| --- | --- |
| FALSE | - запретить фильтрацию конструктивных осей. |
Синтаксис Automation:
```
filterCAxis = iObjFilter3D.filterCAxis;    Получить свойство (* )
iObjFilter3D.filterCAxis = filterCAxis;    Установить свойство (* )
filterCAxis = iObjFilter3D.GetFilterCAxis();    Получить свойство (**)
iObjFilter3D.SetFilterCAxis(filterCAxis);    Установить свойство (**)
```
Синтаксис COM:
```
filterCAxis = iObjFilter3D.GetFilterCAxis();    Получить свойство
iObjFilter3D.SetFilterCAxis(filterCAxis);    Установить свойство
```
Примечание:
1. После установки свойства равным TRUE флаг Фильтровать все снимается.
2. Если после установки флага равным FALSE все флаги для типов объектов окажутся равными FALSE, то будет включено свойство Фильтровать все.


## filterCPlanes - Фильтровать конструктивные плоскости

Тип данных: BOOL
Значения свойства:
| TRUE | - разрешить фильтрацию конструктивных плоскостей, |
| --- | --- |
| FALSE | - запретить фильтрацию конструктивных плоскостей. |
Синтаксис Automation:
```
filterCPlanes = iObjFilter3D.filterCPlanes;    Получить свойство (* )
iObjFilter3D.filterVertexs = filterCPlanes;    Установить свойство (* )
filterCPlanes = iObjFilter3D.GetFilterCPlanes();    Получить свойство (**)
iObjFilter3D.SetFilterCPlanes(filterCPlanes);    Установить свойство (**)
```
Синтаксис COM:
```
filterCPlanes = iObjFilter3D.GetFilterCPlanes();    Получить свойство
iObjFilter3D.SetFilterCPlanes(filterCPlanes);    Установить свойство
```
Примечание:
1. После установки свойства равным TRUE флаг Фильтровать все снимается.
2. Если после установки флага равным FALSE все флаги для типов объектов окажутся равными FALSE, то будет включено свойство Фильтровать все.


## filterEdges - Фильтровать ребра

Тип данных: BOOL
Значения свойства:
| TRUE | - разрешить фильтрацию ребер, |
| --- | --- |
| FALSE | - запретить фильтрацию ребер. |
Синтаксис Automation:
```
filterEdges = iObjFilter3D.filterEdges;    Получить свойство (* )
iObjFilter3D.filterEdges = filterEdges;    Установить свойство (* )
filterEdges = iObjFilter3D.GetFilterEdges();    Получить свойство (**)
iObjFilter3D.SetFilterEdges(filterEdges);    Установить свойство (**)
```
Синтаксис COM:
```
filterEdges = iObjFilter3D.GetFilterEdges();    Получить свойство
iObjFilter3D.SetFilterEdges(filterEdges);    Установить свойство
```
Примечание:
1. После установки свойства равным TRUE флаг Фильтровать все снимается.
2. Если после установки флага равным FALSE все флаги для типов объектов окажутся равными FALSE, то будет включено свойство Фильтровать все.


## filterFaces - Фильтровать грани

Тип данных: BOOL
Значения свойства:
| TRUE | - разрешить фильтрацию граней, |
| --- | --- |
| FALSE | - запретить фильтрацию граней. |
Синтаксис Automation:
```
filterFaces = iObjFilter3D.filterFaces;    Получить свойство (* )
iObjFilter3D.filterFaces = filterFaces;    Установить свойство (* )
filterFaces = iObjFilter3D.GetFilterFaces();    Получить свойство (**)
iObjFilter3D.SetFilterFaces(filterFaces);    Установить свойство (**)
```
Синтаксис COM:
```
filterFaces = iObjFilter3D.GetFilterFaces();    Получить свойство
iObjFilter3D.SetFilterFaces(filterFaces);    Установить свойство
```
Примечание:
1. После установки свойства равным TRUE флаг Фильтровать все снимается.
2. Если после установки флага равным FALSE все флаги для типов объектов окажутся равными FALSE, то будет включено свойство Фильтровать все.


## filterVertexs - Фильтровать вершины

Тип данных: BOOL
Значения свойства:
| TRUE | - разрешить фильтрацию вершин, |
| --- | --- |
| FALSE | - запретить фильтрацию вершин. |
Синтаксис Automation:
```
filterVertexs = iObjFilter3D.filterVertexs;    Получить свойство (* )
iObjFilter3D.filterVertexs = filterVertexs;    Установить свойство (* )
filterVertexs = iObjFilter3D.GetFilterVertexs();    Получить свойство (**)
iObjFilter3D.SetFilterVertexs(filterVertexs);    Установить свойство (**)
```
Синтаксис COM:
```
filterVertexs = iObjFilter3D.GetFilterVertexs();    Получить свойство
iObjFilter3D.SetFilterVertexs(filterVertexs);    Установить свойство
```
Примечание:
1. После установки свойства равным TRUE флаг Фильтровать все снимается.
2. Если после установки флага равным FALSE все флаги для типов объектов окажутся равными FALSE, то будет включено свойство Фильтровать все.
