---
title: "Интерфейс IAdditionalBlockTuning"
type: interface
api: [api7]
tags: [interface, api7, iadditionalblocktuning]
sources:
  - iadditionalblocktuning.html
---

*API интерфейсов. Версия 7 > Работа со спецификацией *


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

Интерфейс настройки блока дополнительных (вложенных) разделов..
Иерархия:
IKompasAPIObject
IAdditionalBlockTuning
Описание:
Данный интерфейс позволяет получить доступ к настройкам блока дополнительных (вложенных) разделов спецификации. Если настройки взяты у стиля спецификации, то они являются умолчательными для данного стиля, и изменять их нельзя. В этом случае данный интерфейс отражает содержимое настроек стиля в библиотеке стилей на момент получения и в дальнейшем не отслеживает изменений в библиотеке стилей.
Если настройки взяты у описания спецификации, то они отображают и отслеживают текущее состояние описания спецификации. Эти настройки можно изменять и они могут отличаться от умолчательных настроек стиля спецификации, по которому создано данное описание спецификации.
После изменения настроек (для того чтобы эти изменения реально отобразились в документе) необходимо вызвать метод ISpecificationTuning::Update.
Примечание:
Данный интерфейс можно получить у коллекции IAdditionalBlockTunings.


## DocumentMarking - Обозначение документа

Тип данных: BSTR
Синтаксис Automation:
```
DocumentMarking = Object.DocumentMarking    Получить свойство (* )
Object.DocumentMarking = DocumentMarking    Установить свойство (* )
DocumentMarking = Object.GetDocumentMarking()    Получить свойство (**)
Object.SetDocumentMarking( DocumentMarking )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_DocumentMarking( &DocumentMarking )    Получить свойство
Object.put_DocumentMarking( DocumentMarking )    Установить свойство
КOMPAS v24
.
```


## DocumentName - Имя файла документа, по которому устанавливается имя блока дополнительных (вложенных) разделов

Тип данных: BSTR (строка)
Синтаксис Automation:
```
DocumentName = iObject.DocumentName    Получить свойство (* )
iObject.DocumentName = DocumentName    Установить свойство (* )
DocumentName = iObject.GetDocumentName()    Получить свойство (**)
iObject.SetDocumentName (DocumentName)    Установить свойство (**)
```
Синтаксис COM:
```
iObject->get_DocumentName (&DocumentName)    Получить свойство
iObject->put_DocumentName (DocumentName)    Установить свойство
```
Примечание:
Позволяет получить\изменить полное имя файла КОМПАС-документа для связи с заголовком блока. Обозначение из этого файла может включаться в заголовок блока. Чтобы это включение было возможно, имя блока (заданное при настройке стиля спецификации) должно содержать синтаксическую конструкцию вида #XXX# (Количество и тип символов между «решетками» не имеет значения). Вместо этой конструкции в заголовок блока в спецификации будет подставлено обозначение, полученное из документа, путь к которому указан в этом свойстве. Таким образом, указание документа имеет смысл лишь при настройке блоков, заголовки которых содержат конструкцию вида #XXX#. Обычно для связи с заголовком блока выбирается электромонтажный чертеж или таблица соединений.


## FirstOnSheet - Блок размещать с новой страницы

Тип данных: BOOL
Синтаксис Automation:
```
FirstOnSheet = iObject.FirstOnSheet    Получить свойство (* )
iObject.FirstOnSheet = FirstOnSheet    Установить свойство (* )
FirstOnSheet = iObject.GetFirstOnSheet()    Получить свойство (**)
iObject.SetFirstOnSheet (FirstOnSheet)    Установить свойство (**)
```
Синтаксис COM:
```
iObject->get_FirstOnSheet (&FirstOnSheet)    Получить свойство
iObject->put_FirstOnSheet (FirstOnSheet)    Установить свойство
Значения свойства:
TRUE    - располагать блок на новой странице,
FALSE    - располагать блок сразу за предыдущим.
```
Примечание:
Позволяет включать и отключать размещение блока на новом листе спецификации.


## IndependentPosition - Независимая нумерация позиций

Тип данных: BOOL
Синтаксис Automation:
```
IndependentPosition = Object.IndependentPosition    Получить свойство (* )
Object.IndependentPosition = IndependentPosition    Установить свойство (* )
IndependentPosition = Object.GetIndependentPosition()    Получить свойство (**)
Object.SetIndependentPosition( IndependentPosition )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_IndependentPosition( &IndependentPosition )    Получить свойство
Object.put_IndependentPosition( IndependentPosition )    Установить свойство
```


## Mark - Марка. Текст префикса

Тип данных: BSTR
Синтаксис Automation:
```
Mark = Object.Mark    Получить свойство (* )
Object.Mark = Mark    Установить свойство (* )
Mark = Object.GetMark()    Получить свойство (**)
Object.SetMark( Mark )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Mark( &Mark )    Получить свойство
Object.put_Mark( Mark )    Установить свойство
```


## MarkOn - Марка. Включена простановка позиций c префиксом

Тип данных: BOOL
Синтаксис Automation:
```
MarkOn = Object.MarkOn    Получить свойство (* )
Object.MarkOn = MarkOn    Установить свойство (* )
MarkOn = Object.GetMarkOn()    Получить свойство (**)
Object.SetMarkOn( MarkOn )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_MarkOn( &MarkOn )    Получить свойство
Object.put_MarkOn( MarkOn )    Установить свойство
```


## Number - Номер блока дополнительных (вложенных) разделов

Тип данных: long
Синтаксис Automation:
```
Number = iObject.Number    Получить свойство (* )
Number = iObject.GetNumber()    Получить свойство (**)
```
Синтаксис COM:
```
iObject->get_Number (&Number)    Получить свойство
```
Примечание:
1. Данное свойство определяет уникальный номер блока дополнительных (вложенных) разделов в данном стиле спецификации.
2. Свойство доступно только для чтения.


## Sections - Разделы блока дополнительных (вложенных) разделов

Тип данных: указатель на интерфейс IAdditionalBlockSectionTunings коллекции настроек разделов блока дополнительных (вложенных) разделов
Синтаксис Automation:
```
Sections = iObject.Sections    Получить свойство (* )
Sections = iObject.GetSections()    Получить свойство (**)
```
Синтаксис COM:
```
iObject->get_Sections (&Sections)    Получить свойство
```
Примечание:
Свойство доступно только для чтения.


## Use - Использовать этот блок

Тип данных: BOOL
Синтаксис Automation:
```
Use = iObject.Use    Получить свойство (* )
iObject.Use = Use    Установить свойство (* )
Use = iObject.GetUse()    Получить свойство (**)
iObject.SetUse (Use)    Установить свойство (**)
```
Синтаксис COM:
```
iObject->get_Use (&Use)    Получить свойство
iObject->put_Use (Use)    Установить свойство
Значения свойства:
TRUE    - использовать данный блок,
FALSE    - блок использоваться не будет.
```
Примечание:
Позволяет получить\изменить доступность данного блока при заполнении спецификации.
