[Civil3D2015 개발자 가이드 번역] Corridors

Corridors

이 장은 AutoCAD Civil 3D .NET API를 사용한 corridor object 의 생성과 관리를 설명한다.

이 절의 주제

• 최상위 Objects
• Corridors
• 기준선
• Assemblies and Subassemblies
• 기능 선
• Corridor 표면
• 제목 문자 입력
• 스타일

최상위 Objects

이 절의 주제

• Corridor-기정 기준 Object 접근
• 주변 설정

Corridor-지정 기분 Object 접근

.NET API는 도로-관련 object를 위한 별도의 최상위 object를 사용하지 않는다. COM API와 달리, 당신은 corridor 최상위 object에 접근하기 위해 CivilApplication과 CivilDocument 클래스를 사용하기만 하면 된다.

주변 설정

주변 설정은 당신이 도로 object의 단위와 기본 속성 설정을 get하고 set을 할수 있도록 한다. Corridor의 주변 설정은  CivilDocument.Settings.GetFeatureSetting() 매서드에 의해서 리턴되는 SettingsCorridor object로 접근된다.

Corridor 주변 설정

Corridor 주변 설정 object는 corridor 관련 object를 위한 당신이 기본 이름 형식과 기본 스타일을 set을 할 수 있게 한다. 이름 탬플릿은 당신이 기능선에서 새 corridor, corridor 표면, 종단면도나 선형의 이름이 정해지는 방법을 set할 수 있게 한다. 각 포멧은 다음 속성 필드에 있는 요소들을 사용할 수 있다 :

Valid property fields for SettingsCorridor.SettingsNameFormat.Corridor

<[Corridor First Assembly(CP)]>

<[Corridor First Baseline(CP)]>

<[Corridor First Profile(CP)]>

<[Next Counter(CP)]>

... for SettingsCorridor.SettingsNameFormat.CorridorSurface

<[Corridor Name(CP)]>

<[Next Corridor Surface Counter(CP)]>

...for SettingsCorridor.SettingsNameformat.ProfileFromFeatureLine

<[Next Counter(CP)]>

... for SettingsCorridor.SettingsNameFormat.AlignmentFromFeatureLine

<[Corridor Baseline Name(CP)]>

<[Corridor Feature Code(CP)]>

<[Corridor Name(CP)]>

<[Next Counter(CP)]>

<[Profile Type]>

This sample sets the corridor name format:

// Get the Corridor ambient settings root object
CivilDocument doc = CivilApplication.ActiveDocument;
Editor ed = Application.DocumentManager.MdiActiveDocument.Editor;
SettingsCorridor oCorridorSettings = doc.Settings.GetFeatureSettings<SettingsCorridor>() as SettingsCorridor;
// Set the template so new corridors are named "Corridor"
// followed by a unique number followed by the name of the
// corridor's first assembly in parenthesis.
oCorridorSettings.NameFormat.Corridor.Value = "Corridor <[Next Counter(CP)]>(<[Corridor First Assembly(CP)]>)";

Default styles are set through the SettingsCorridor.StyleSettings property. The styles for corridor alignments, alignment labels, code sets, surfaces, feature lines, profiles, profile labels, and slope pattern are accessed through a series of string properties.

This sample sets the style of alignments in a corridor to the first alignment style in the document’s collection of styles:

using (Transaction ts = Application.DocumentManager.MdiActiveDocument.
   Database.TransactionManager.StartTransaction())
{
   // Get the name of the first alignment style in the collection.
   ObjectId alignId = doc.Styles.AlignmentStyles[0];
   Alignment oAlignment = ts.GetObject(alignId, OpenMode.ForRead) as Alignment;
   // Assign the name to alignment style property.
   oCorridorSettings.Styles.Alignment.Value = oAlignment.Name;
}

Assembly Ambient Settings

The assembly ambient settings object allows you to set the default name formats and default styles for assemblies. The name formats allow you to set how new assemblies, offset assemblies, and assembly groups are named. Each format can use elements from the following property fields:

Valid property fields for SettingsAssembly.NameFormat.Assembly

<[Next Counter(CP)]>

... for SettingsAssembly.NameFormat.Offset

<[Corridor Name(CP)]>

...for SettingsAssembly.NameFormat.Group

<[Next Counter(CP)]>

Subassembly Ambient Settings

The subassembly ambient settings object allows you to set the default name formats and default styles for subassembly objects. The name formats allow you to set how subassemblies created from entities and subassemblies created from macros are named. Each format can use elements from the following property fields:

... for SettingsSubassembly.SettingsNameFormat.CreateFromEntities

<[Macro Short Name(CP)]>

<[Next Counter(CP)]>

<[Subassembly Local Name(CP)]>

<[Subassembly Side]>

... for SettingsSubassembly.SettingsNameFormat.CreateFromMacro

<[Macro Short Name(CP)]>

<[Next Counter(CP)]>

<[Subassembly Local Name(CP)]>

<[Subassembly Side]>

Note:

The name of the default code style set cannot be set with the .NET API.