EBSILON®Professional Online Documentation
本主题中
    工况函数
    本主题中

    工况函数


    这些函数对处理工况很有用。

     

    定义:

    计算工况:当前的工况,构成了每次调用计算时的基础。所有的分配操作也是在这个工况中完成的。

    (计算工况的)父工况:在工况层次结构中位于激活的工况之上的工况,如果它们没有在激活的工况中被明确设置,其值就在激活的工况中被继承。

    设置父工况:在创建新的工况时用作父工况(用 newSubProfile)。这个设置可以通过 setParentProfile 改变。

    名称

    目的

    参数

    返回值

    设置计算工况

    例子

    clearCalcProfile

    删除在激活的计算工况中明确设置的所有值,即从父工况继承的值再次有效(在属性窗口中显示为灰色)

    -

    clearCalcProfile;

    copyCalcProfile

    在相同的层次结构水平上创建一个具有相同值的激活的工况的副本。复制的工况与原始工况有相同的父工况,继承的值相同。在原始工况中输入的值也会在复制的工况中设置。

    设计工况不能被复制。

    1: BOOLEAN: 递归复制

    2: INTEGER: 父工况的 ID,用于连接复制的工况。 

    INTEGER:
    创建的子工况的 ID

    新创建的子工况

    i:= copyCalcProfile;

    copyParent Profile

    创建一个在设定的父工况中定义的工况的副本。(见 getParentProfile)这个副本是在同一层次上创建的。复制的工况与源工况有相同的父工况,所以继承的值是相同的。在原始工况中输入的值也被设置在复制的工况中。

    此后,新创建的工况是激活的的计算工况和设定的父工况。

    设计工况不能被复制。

    1: BOOLEAN: 递归复制

    2: INTEGER: 父工况的 ID,用于连接复制的工况。 

    INTEGER:
    创建的子工况的 ID

    新创建的父工况

    i:= copyParentProfile;

    deleteCalcProfile

    删除当前的计算工况(包括任何子工况,如果有的话)

    原有的计算工况的父工况

    deleteCalcProfile;

    deleteCalc ProfileDescendants

    删除当前工况的子工况

     

    deleteCalcProfileDescendants;

    deleteParent Profile

    删除设定的父工况(包括任何子工况,如果有的话)

    原有的计算工况的祖父工况

    deleteParentProfile;

    deleteParent ProfileDescendants

    删除工况的子工况,该工况作为当前的父工况使用

     

    deleteParentProfileDescendants;

    getCalcProfile

    返回激活的计算工况 ID

    INTEGER:
    计算工况的 ID

    -

    i:=getCalcProfile;

    getFirstChild ProfileId

     

    用其第一个子工况的 ID 替换指定的 ID

    INTEGER:
    Before call: 在调用之前:所考虑的工况的 ID

    调用后:被考虑的工况的子工况 ID,如果被考虑的工况没有子工况,则为 -1

    未改变

    getFirstChildProfileId (i);

    getFirstProfileId

     

    返回模型中第一个工况的 ID

    INTEGER:
    第一个工况的 ID

    未改变

    i:=getFirstProfileId;

    GetLastChild ProfileId

    将指定的 ID 替换为其最后子工况的 ID

    INTEGER:
    调用之前:所考虑的工况的 ID

    调用之后:被考虑的工况的最后一个工况的 ID,如果被考虑的工况没有子工况,则为 -1

    未改变

    getLastChildProfileId ( i );

    GetLastProfileId

     

    返回模型中最后一个工况的 ID(这是在树上的最后一个条目。不一定是最高的 ID)

    INTEGER:
    最后一个工况的 ID 

    未改变

    i:=getLastProfileId;

    getLocalDesignReferenceProfile

     

    返回设定的参考工况的 ID,其中的参考值将被转移到局部设计中

    INTEGER:

    参考工况的 ID

    未改变

    i:=getLocalDesignReferenceProfile;

    getNextProfileId

    用树中的下一个工况的 ID 替换指定的 ID,不管其相对位置如何。这个函数可以用来穿过所有的工况

    INTEGER:
    调用之前:所考虑的工况的 ID

    调用之后:下一个工况的 ID,如果考虑的工况没有子工况,则为 1

    未改变

    getNextProfileId( i );

    getNextSibl ProfileId

    将指定的 ID 替换为下一个同级别的工况的 ID。

    INTEGER:
    调用之前:所考虑的工况的 ID

    同一层次的下一个工况的 ID -1,如果所考虑的工况没有子工况。

    未改变

    getNextSiblProfileId ( i );

    getParentProfile

    返回设定父工况的 ID(即工况,当下一个"newSubProfile"被调用时,它成为父工况)

    INTEGER:
    父工况的 ID

    未改变

    i:=getParentProfile;

    getParent ProfileId

    将指定的 ID 替换为其父工况的 ID

    INTEGER:
    调用之前:所考虑的工况的 ID

    调用之后:所考虑的工况的父工况的 ID 

    未改变

    getParentProfileId (i);

    getPrevProfileId

    用树中前一个工况的 ID 替换指定的 ID,无论其相对位置如何。这个函数可以用来向后移动所有的工况

    INTEGER:
    调用之前:所考虑的工况的 ID

    调用之后:前一个工况的 ID,如果考虑的工况是第一个,则为 -1

    未改变

    getPrevProfileId( i );

    getPrevSibl ProfileId

    用前一个同级别的工况的 ID 替换指定的 ID。

    INTEGER:
    调用之前:所考虑的工况的 ID

    调用之后:同一层次的前一个工况的 ID,如果考虑的工况没有同级的工况,则为 -1

    未改变

    getPrevSiblProfileId (i);

    getRootProfileId

    返回主工况的 ID

    INTEGER:
    主工况的 ID

    未改变

    iProfileId:= getRootProfileId;

    newSubProfile

    创建一个新的子工况并返回其 ID。该工况是作为设定父工况的子工况创建的。

    1: STRING: 要创建的子工况的名称(可选)。如果没有指定,那么名称为 sub_x

    INTEGER:
    创建的子工况的 ID

    新创建的子工况 

    i:=newSubProfile (“Prof_1”)

    renameProfile

    重命名一个现有的工况

    1: INTEGER: 要重命名的工况的 ID

    2: STRING: 新名称

    BOOLEAN: 真, 当重命名成功时

    未改变

    bOk:= renameProfile(iProfileId, "Auslegung" );

    setCalcProfile

    使工况通过 ID 指定为激活的计算工况

    1: INTEGER: 要被作为计算工况的那个工况的 ID

    INTEGER:

    指定的计算工况的 ID。
    -1,如果计算工况不存在。 

    指定的工况

    setCalcProfile(i);

    setCalc ProfileByName

    如 setCalcProfile 一样,工况不是是由它的 ID,而是由它的名字来指定。

    1: STRING: 将成为计算工况的工况的名称

    INTEGER:

    指定的计算工况的ID。
    -1,如果计算工况不存在。

    指定的工况

    i:=setCalcProfileByName ( "Sub_2" );

    setParentProfile

    使由给定的 ID 指定的工况成为设定的父工况。

    该函数还将计算工况的 ID 设置为父工况的 ID。

    1: INTEGER: 成为父工况的工况的 ID

    INTEGER:

    指定的父工况的 ID。
    -1,如果父工况不存在。

    指定的父工况

    setParentProfile (i);

    SetParent ProfileByName

    如 setParentProfile 一样,工况不是由它的 ID 指定的,而是由它的名字指定的。

    该函数还将计算工况的 ID 设置为父工况的 ID。

    1: STRING: 成为父工况的工况名称

    INTEGER:

    指定的父工况的 ID。
    -1,如果父工况不存在。

    指定的父工况

    i:= setParentProfileByName ("Sub_1“);

    setLocalDesignReferenceProfile

    使通过 ID 指定的工况作为设定参考工况,其中的参考值将被转移到一个局部设计。

    1: INTEGER: 工况的 ID 成为参考工况 ID

    -

    参考工况此时不一定存在。

    setDesignReferenceProfile (i);