--- 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 - блок использоваться не будет. ``` Примечание: Позволяет получить\изменить доступность данного блока при заполнении спецификации.