Femtet2026.0マクロヘルプ/マニュアル
 

ホーム / モデリング / CGaudi / 関数 / FindBodyAllByGroupName

FindBodyAllByGroupName関数

定義

FindBodyAllByGroupName ( GroupName As String, BodyArray() As CGaudiBody, TextMatch As TEXT_MATCH_T ) As Boolean
 


[Python]
 FindBodyAllByGroupName_py(str GroupName, constants.TEXT_MATCH_T TextMatchType)

戻り値

True   成功
False   失敗
 


[Python]
[0]   True:成功、False:失敗
[1][0~検索されたボディ数-1]   指定されたグループ名のボディ(CGaudiBody)を返すための配列(動的配列)

引数

GroupName   グループ名
BodyArray   指定されたグループ名のボディを返すための配列(動的配列)
TextMatch   材料名の文字列の検索方法(TEXT_MATCH_Tを設定してください)
 


[Python]
GroupName   グループ名
TextMatch   材料名の文字列の検索方法(constants.TEXT_MATCH_Tを設定してください)

解説

指定されたグループ名のボディを全て取得します。
ボディが見つからなかった場合やBodyArrayが動的配列ではない場合は失敗します。
 
グループが2階層以上ある場合は、';'で区切って1つの文字列として指定します。
(例)"親グループ名;子グループ名;孫グループ名"
 
    
グループ名の検索方法は下記の種類があります。

  • 完全一致
  • 大文字小文字の区別なしで完全一致
  • 部分一致
  • 大文字小文字の区別なしで部分一致

 

材料名の検索方法を指定する第3引数の初期値は完全一致です。

完全一致で検索する場合は第3引数の設定は不要です。

 

各検索方法の動作について、
グループ名"Polycarbonate"のボディが存在するとき、
各方法で"Polycarbonate"を取得する場合に
第1引数に指定する検索文字列の例です。

 

完全一致

大文字小文字の区別なしで完全一致

部分一致

大文字小文字の区別なしで部分一致

Polycarbonate

polycarbonate、POLYCARBONATEなど

Poly、carbonateなど

poly、POLY、Carbonateなど

 

実行例

Dim Femtet As New CFemtet
Dim Gaudi As CGaudi
Dim Body() As CGaudiBody


'プロジェクトを開く
If Femtet.LoadProject("C:\Test\test.femprj", True) = False Then

    Femtet.ShowLastError

End If

'Femtet.Gaudiを変数Gaudiに代入して使いやすくする
Set Gaudi = Femtet.Gaudi

'完全一致で検索
If Gaudi.FindBodyAllByGroupName( "Polycarbonate", Body ) = False Then
    Femtet.ShowLastError
End If

'部分一致で検索
If Gaudi.FindBodyAllByGroupName( "Poly", Body, TEXT_MATCH_PARTIAL_C ) = False Then
    Femtet.ShowLastError
End If