Manipulate

• 式 expr はグラフィックスやその他の式でもよい．Noneの場合はコントロールのみが表示される．

• デフォルトで，次の形式はコントロールの特別な形を与える．

• コントロールの代りに与えることのできる注釈には，TabViewやGridのようなビューおよびレイアウト構造に加え，String，Style，Row，Item，Text，ExpressionCell，TextCellを頭部に持つ式等がある．

• コントロールのラベル u_lbl はどのような式でもよい．

• 注釈内部では，コントロールはControlを使って指定することができる．

• オプション設定のControlType->type は，指定されたタイプのコントロールを行おうとする．

• 可能なコントロールタイプには，Animator，Checkbox，CheckboxBar，ColorSetter，ColorSlider，InputField，Manipulator，PopupMenu，RadioButton，RadioButtonBar，かSetterかSetterBar，あるいはSlider，Slider2D，TogglerBar，Trigger，VerticalSlider等がある．Noneを使うこともできる．

• 各変数に対して別々にControlTypeオプションを与えることができる．コントロール用のオプションも，変数の指定内で与えることができる．

• ControlType->Triggerは，特定の変数をトリガで制御するように指定する．

• コントロール指定{u, u_min, u_max, ..., Appearance->"Labeled"}は値がラベルとして表示されるスライダーを返す．

• {u, func}の形のときは， Dynamic[u]が func の第1引数として与えられる．

• {u, u_min, u_max, func}という形もまた使うことができる．この場合，評価されるのはfunc[Dynamic[u], {u_min, u_max}]である．

• {u}は{u, InputField}と等価である．{u, ColorSlider}はデフォルトの色スライダーをコントロールとして与える．

• {u, Locator}の形式のとき，u の値は x と y の座標を与えるリストである．この座標は expr 中の最初のグラフィックスか，expr の各方向について0から1の範囲のどちらかに属する．

• {{u, {{x₁, y₁}, {x₂, y₂}, ...}}, Locator}の形式で{x_i, y_i}のそれぞれのロケータを設定し，u の値がすべての{x_i, y_i}のリストになるようにする．

• {{u, u_init}, {x_min, y_min}, {x_max, y_max}, Locator}の形式でロケータの範囲を指定する．

• オプション設定のLocatorAutoCreate->Allは，既存のロケータに当たらなかったクリックについて新たなロケータを追加するように指定する．Alt+Clickでロケータを削除する．

• {{u, {}}, Locator, LocatorAutoCreate->All}は，ロケータがない状態から始めるが，新たなロケータが作られることを許容する．

• 変数 u が複数回用いられている場合は，このためのリンクされたコントロールが与えられている．

• オプション設定のControlPlacement->pos で，expr と相対的な位置 pos にコントロールを置くように指定する．pos の可能な設定値はBottom，Left，Right，Topである．

• 注釈の置き方は，注釈をControlPlacementオプションを持つItemで囲むことで指定することができる．

• 次のオプションが使用できる．

• オプションControlPlacementおよびControlTypeは，{u, spec, opts}の形式で，それぞれの変数に別々に与えることができる．

• Manipulateはレキシカルスコープを実装するスコープ構文である．

• Manipulateは，変数 u や v 等を局所的に指定してDynamicModuleオブジェクトを生成する．

• デフォルト設定のPreserveSettings->Trueでは，変数 u や v 等の値は自動的にノートブックに保存され，ノートブックが再度開かれたときに復元される．

• Initialization:>expr の設定では，Manipulateが実行されたとき，あるいは特定のセッションで結果が最初に表示されたときに式 expr が評価される．

• AppearanceElementsの設定として，リスト中に"ContentResizeArea"，"HideControlsButton"，"ManipulateMenu"，"SnapshotButton"を任意の順序で指定することができる．デフォルトでは"ManipulateMenu"のみが含まれる．

• スナップショットボタンを押すとManipulate出力の真下に全変数の現行値を指定するWith[{u=u_val, ...}, expr]形式の入力を含むセルが作られる．

• ContinuousAction->Noneという設定のときは明示的な更新ボタンが表示され，これが押されるまで expr は再評価されない．

• デフォルト設定のTrackedSymbols->Automaticでは，expr に明示的に現れる記号だけが追跡記録される．

• TrackedSymbols->TrueはManipulateのコントロールに現れたシンボルを追跡する．

• TrackedSymbols->Allとすると，評価中に遭遇した記号が変化するたびに出力が更新される．

• デフォルト設定のControllerLinking->Automaticでは，Manipulateが現行選択の一部である場合は常に，Manipulate中のコントロールは外部デバイスにある指定コントローラに対応する．

• ゲームパッドのような外部デバイス上のコントローラは，ジョイスティック，ボタン等を含むことができる．

• 外部コントローラ指定には次のようなものがある．

• 特定の Mathematica セッションでアクティブなデバイスのための生の外部コントローラ指定名は，一般にControllerInformationを使って見付けることができる．

• デフォルト設定のControllerMethod->Automaticでは，「X」のようなコントローラ指定は，デフォルトでジョイスティック等のコントロールの移動は対応する変数 x の値の変化率を決定することを意味する．例えばジョイスティックを押すことによって別の状態が選ばれると，コントロールの絶対的な位置が x の値を直接決定する．

• 「XAbsolute」のようなコントローラ指定では，ジョイスティックのようなコントロールの絶対的な位置が，対応する変数 x の値を決定する．

• 「XCyclic」のようなコントローラ指定では，一般にコントロールが範囲の端に達すると対応する変数 x の値は循環的にラップするとされる．

• 「XYZ」のようなコントローラ指定は，例えば1つのコントローラ上の2つの異なるジョイスティックの軸のように外部デバイス上の複数のコントロールと関連している可能性がある．

• ゲームパッドや2つのジョイスティックがあるその他のデバイス上では，「XY1」は一般に左側のスティックを指し，「XY2」は一般に右側のスティックを指す．ゲームパッドに「hat」コントロールがある場合は，一般に「XY3」でこれを指す．

• 「B1」のようなボタンコントローラ指定は，対応するボタンが押されるたびにTrueとFalseを切り換える．

• 「B1Absolute」のような絶対指定はボタンが押されている間はTrueを，それ以外はFalseを返す．

• BaseStyleおよびLabelStyleの設定値は，一般に現行スタイルシートの"Manipulate"スタイルと"ManipulateLabel"スタイルで与えられるデフォルトスタイルに加えられる．