Ssgetのソースを表示

; 構文
: (ssget [''sel-method''] [''pt1'' [''pt2'']] [''pt-list''] [''filter-list''])


; 機能
: 選択されたオブジェクトから選択セットを作成する。
: 選択セットにはペーパー空間とモデル空間の両方のオブジェクトを含めることができるが、その選択セットを使用するときに、ssget 関数は現在有効でない空間のオブジェクトを除外する。
: ssget 関数が返す選択セットには、主図形のみが含まれる(属性やポリラインの頂点は含まれない)。


; 引数
:* sel-method : オブジェクト選択方法を指定する文字列。
:: 有効な選択方法は、次のとおり。 
:::* '''C ''' … 交差選択 
:::* '''CP''' … ポリゴン交差選択(指定されたポリゴンの内部とポリゴンと交差するすべてのオブジェクト) 
:::* '''F ''' … フェンス選択 
:::* '''I ''' … 暗黙選択(システム変数 PICKFIRST が有効な間に選択されたオブジェクト)
:::* '''L ''' … データベースに最後に追加された可視オブジェクト
:::* '''P ''' … 最後に作成された選択セット
:::* '''W ''' … 窓選択 
:::* '''WP''' … ポリゴン窓選択(指定されたポリゴンに完全に含まれるすべてのオブジェクト)
:::* '''X ''' … データベース全体。 X 選択方法を指定し、filter-list 引数を指定しなかった場合、非表示、フリーズ、表示しているスクリーンの外にある図形を含む、すべての図形を選択する。
:::* ''':E''' … オブジェクト選択ピックボックス内のすべて 
:::* ''':N''' … ssget 関数操作によって選択された任意の図形の、コンテナ ブロックの追加情報および変換マトリックスを ssnamex 関数を呼び出して取得できる。 この追加情報は、窓、交差、点クリックなどのグラフィカル選択方法で選択された図形に対してのみ使用できる。
:::* ''':S''' … 単一図形選択に限定する
:::* ''':R''' … 長いトランザクション内の図形が選択されるようにする。
:::* ''':U''' … 従属図形の選択を可能にする。重複(":D")またはネスト(":N")選択モードと結合することはできない。このモードでは、既定でトップ レベルの図形が選択されるが、ユーザは選択中に[Ctrl]キーを押すことにより、従属図形を選択することができる。このオプションは、窓選択、交差選択、ポリゴン選択などの対話的な選択に対してのみサポートされている。すべて選択、フィルタ選択、グループ選択に対しては、サポートされていない。
:::* ''':V''' … 従属図形選択に限定する。ユーザが実行するすべての対話的な画面上での選択は、従属図形選択として扱われる。返される選択セットには、従属図形のみが含まれる。このオプションは、重複(":D")またはネスト(":N")選択モードと結合することはできない。このオプションは、窓選択や交差選択などの対話的な選択に対してのみサポートされている。すべて選択、フィルタ選択、グループ選択に対しては、サポートされていない。
::: * IntelliCAD では、:E などの :(コロン)つきオプションは使用できない。(IJCAD 8 現在)
::: * 以下は IntelliCAD のみで有効 (IJCAD 8まで)
:::* '''CC''' … 円交差選択(指定された円の内部と円と交差するすべてのオブジェクト) 
:::* '''O ''' … 交差選択外(指定されたポリゴンの内部とポリゴンと交差するすべてのオブジェクト以外のオブジェクト) 
:::* '''OC''' … 円交差選択(指定された円の内部と円と交差するすべてのオブジェクト以外のオブジェクト) 
:::* '''OP''' … 交差選択外(指定されたポリゴンの内部とポリゴンと交差するすべてのオブジェクト以外のオブジェクト) 
:::* '''PO''' … 閉じた図形 (指定された点が内部になるすべての閉じたオブジェクト）
;
:* pt1 : 選択に関する点。
:* pt2 : 選択に関する点。
:* pt-list : 点のリスト。
:* filter-list : オブジェクトのプロパティを指定する連想リスト。この引数に該当するオブジェクトが、選択セットに追加される。参考：[[選択フィルタ]]

* すべての引数を省略すると、プロンプトに「オブジェクトを選択:」を表示し、選択セットを対話的に作成できる。
* 点を指定し、オブジェクト選択方法を指定しなかった場合、ユーザが単一点をクリックしてオブジェクトを選択するものとみなされる。


; 戻り値
: 成功した場合は、作成された選択セットの名前。オブジェクトが何も選択されなかった場合は nil。


; サンプル
<pre class="brush:autolisp;">
(setq myFilter (list (cons 0 "LINE")(cons 8 "寸法"))) ; 寸法画層の線分 
(ssget "X" myFilter)


(setq pt1 (getpoint "１点目："))
(setq pt2 (getpoint pt1 "２点目："))
(setq ss_w (ssget "W" pt1 pt2))
(setq ss_c (ssget "C" pt1 pt2))


</pre>

-----
関連事項
* [[ssadd]]
* [[ssdel]]
* [[ssget]]
* [[sslength]]
* [[ssupd]]
* [[ssname]]
* [[ssnamex]]
* [[選択フィルタ]]


[[Category:AutoLISP]]