|
ホーム / モデリング / CGaudi / 関数 / FindBodyAllByBodyAttributeName
FindBodyAllByBodyAttributeName関数
定義
FindBodyAllByBodyAttributeName ( BodyAttributeName As String, BodyArray() As CGaudiBody, TextMatch As TEXT_MATCH_T ) As Boolean
[Python]
FindBodyAllByBodyAttributeName_py(str BodyAttributeName, constants.TEXT_MATCH_T TextMatchType)
戻り値
| True | 成功 | |
| False | 失敗 |
[Python]
| [0] | True:成功、False:失敗 | |
| [1][0～検索結果ボディ数-1] | 指定されたボディ属性名のボディ(CGaudiBody)を返すための配列(動的配列) |
引数
| BodyAttributeName | ボディ属性名 | |
| BodyArray | 指定されたボディ属性名のボディを返すための配列(動的配列) | |
| TextMatch | ボディ属性名の文字列の検索方法(TEXT_MATCH_Tを設定してください) |
[Python]
| BodyAttributeName | ボディ属性名 | |
| TextMatch | ボディ属性名の文字列の検索方法(constants.TEXT_MATCH_Tを設定してください) |
解説
指定されたボディ属性名のボディを全て取得します。ボディが見つからなかった場合やBodyArrayが動的配列ではない場合は失敗します。
指定ボディ属性名のボディをどれか一つ取得すればよい場合は、
FindBodyByBodyAttributeNameを使用した方が動作速度が速くなります。
ボディ属性名の検索方法は下記の種類があります。
- 完全一致
- 大文字小文字の区別なしで完全一致
- 部分一致
- 大文字小文字の区別なしで部分一致
ボディ属性名の検索方法を指定する第3引数の初期値は完全一致です。
完全一致で検索する場合は第3引数の設定は不要です。
各検索方法の動作について、
ボディ属性名"Coil01"のボディが存在するとき、
各方法で"Coil01"を取得する場合に
第1引数に指定する検索文字列の例です。
|
完全一致 |
大文字小文字の区別なしで完全一致 |
部分一致 |
大文字小文字の区別なしで部分一致 |
|
Coil01 |
Coil01、COIL01など |
Coil、01など |
Coil、COIL、01など |
実行例
Dim Femtet As New CFemtetDim 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.FindBodyAllByBodyAttributeName( "Coil01", Body ) = False Then
Femtet.ShowLastError
End If
'部分一致で検索
If Gaudi.FindBodyAllByBodyAttributeName( "Coil", Body, TEXT_MATCH_PARTIAL_C ) = False Then
Femtet.ShowLastError
End If