CreateProtectionDeviceEx Method
Declaration Description Parameters Method Result See Also Example

<< Click to Display Table of Contents >>

Navigation:  Additional Resources > OLE/COM Automation > Methods > Create >

CreateProtectionDeviceEx Method
Declaration Description Parameters Method Result See Also Example

Previous pageReturn to chapter overviewNext page

 

Section

Declaration

 

function CreateProtectionDeviceEx(

const BranchName: WideString;

SectionID: Integer;

const Name, Number, Descr: WideString;

X, Y: Integer;

const DeviceName: WideString;

DeviceType: Integer;

Rating, MinTripTime, MinDiscrTime: Double;

CurveType, CTPrimary, CTSecondary, CTSaturation: Integer;

PlugSetting, TimeMultiplier, DefMinTime,

ShortPlugSetting, ShortTimeDelay,

HiSetInstantPlugSetting, HiSetInstantTripDelay,

Utm, Ucm, ThermalMinCurrent, ThermalMaxCurrent, ThermalRatedCurrent, ThermalRatedTime: Double;

const Color, UserData: WideString

): WideString;

Section

Description

Creates a Protection Device onto a Branch with the parameters passed to the function.

Should there be a name conflict, it returns the actual name of the Protection Device.

Section

Parameters

 

Parameter

Usage

BranchName

Branch Name the Protection Device should be connected to.

SectionID

Id of the section of the Branch on which to place the Protection Device

Name

Unique Name. If not unique, it will be changed and the new name returned by the method.

Number

Unique Number

Description

A Description for the Series Reactor if it is required.

X

X Co-ordinate

Y

Y Co-ordinate

DeviceName

Protection Device Name

DeviceType

0 - Over Current, 1 - Earth Fault, 2 - Combined

Rating

Breaker Rating in kA

MinTripTime

Breaker Operating Time (s)

MinDiscrTime

Minimum Allowed Discrimination Time (ms)

CurveType

Normal Inverse, Very Inverse, Extremely Inverse, Long Inverse, User Defined,

Moderate Inverse (ANSI), Very Inverse (ANSI), Extremely Inverse (ANSI),

US CO8 Inverse, US CO2 Inverse, Thermal Flat, Thermal It, Thermal I2t, Thermal I4t

CTPrimary

C.T. Primary winding

CTSecondary

C.T. Secondary winding

CTSaturation

CT Saturation

PlugSetting

Device Plug Setting

TimeMultiplier

Device Time Multiplier

DefMinTime

Device Definite Minimum Time (s)

ShortPlugSetting

Device Short Plug Setting

ShortTimeDelay

Device Short time delay (ms)

HiSetInstantPlugSetting

Device Hi-set Instantaneous Plug Setting

HiSetInstantTripDelay

Device Hi-set Instantaneous Time Delay (ms)

Utm

User Time Multiplier (Shifts the user curve time by this factor)

Ucm

User current Multiplier (Shifts the user curve current by this factor)

ThermalMinCurrent

Thermal Pickup Current (kA)

ThermalMaxCurrent

Thermal Maximum Current (kA)

ThermalRatedCurrent

Thermal Rated Current (kA)

ThermalRatedTime

Thermal Rated Time (s)

Color

Device Graph Display Color

UserData

User Defined Time and Current curve.

UserData = Time1 Current1 Time2 Current2, etc...

Section

Method Result

Unique Protection Device Name.

Section

Example

NewName := PowaMasterObj.CreateProtectionDeviceEx(BranchName, SectionID, Name, Number, Descr, X, Y, DeviceName, DeviceType, Rating, MinTripTime, MinDiscrTime, CurveType, CTPrimary, CTSecondary, CTSaturation, PlugSetting, TimeMultiplier, DefMinTime, ShortPlugSetting, ShortTimeDelay, HiSetInstantPlugSetting, HiSetInstantTripDelay, Utm, Ucm, ThermalMinCurrent, ThermalMaxCurrent, ThermalRatedCurrent, ThermalRatedTime, Color, UserData);
 

if CompareText(NewName, OldName) <> 0 then ShowMessage('The Name has been changed');

Section

See Also

CreateBus

CreateGenerator

CreateLoad

CreateMotor

CreateInductionMotor

CreateShuntCap

CreateCoGen

CreateHarmonicSource

CreateBranch

CreateBranchSection

CreateTrfrBranch

CreateSeriesCap

CreateSeriesReactor

Section