Button、Container、Switch、Frame、Video

Button のラベルとカーソル、Container のクリッピング、Switch のチェック状態、Frame が表示する Page、Video の再生を扱います。すべての Element ノードに共通する規則は Element にあります。

Button

Button ノードは element:nl.button ピンを取ります。Get Button Label は画面に表示されているラベルを読み取ります。Set Button Label が書き込んだラベルは、ページを開き直すまですべての言語で書き込んだとおりに表示され、Translation key（翻訳キー）や Blueprint Value より優先されます。Self 形態は Button にあります。

Get Button Label

blueprint.element.button.getLabel · Pure

画面に表示されているラベルを、プレイヤーの現在の言語で読み取ります。

Set Button Label

blueprint.element.button.setLabel · Latent

ボタンのラベルテキストを設定します。

Set Button Pointer

blueprint.element.button.setPointer · Latent

ボタンのデフォルトカーソルを選びます。データピンはありません——カードはボタンの Appearance インスペクタと同じアイコン付きドロップダウンを備えています。

カード上のフィールド

Get Button Variant

blueprint.element.button.getVariant · Pure

古い id ベースの読み取り。すでにこれを含むグラフが動き続けるよう登録は残っているが、パレットには提供されません。

Set Button Variant

blueprint.element.button.setVariant · Latent

古い id ベースの書き込みで、同様に隠されています。variantId ピンはなく——保存されたパラメータを読むだけで——作者側にはもうそのパラメータを埋める手段がありません。名前で Variant を選ぶ Set Element Variant を使ってください。

Container

Container ノードは element:nl.container ピンを取ります。Self 形態は Container にあります。

Get Container Clip Content

blueprint.element.container.getClipContent · Pure

コンテナがはみ出したコンテンツをクリップするかどうかを読み取ります。

Set Container Clip Content

blueprint.element.container.setClipContent · Latent

コンテナがはみ出したコンテンツをクリップするかどうかを設定します。

Get Container Variant

blueprint.element.container.getVariant · Pure

古い id ベースの読み取り。Button の対と同じ理由でパレットから隠されています。

Set Container Variant

blueprint.element.container.setVariant · Latent

古い id ベースの書き込み。パレットから隠されています。Set Element Variant を使ってください。

Switch

Switch ノードは element:nl.switch ピンを取ります。Self 形態は Switch にあります。Switch の visible / enabled の対は、同じファミリーの他のものと一緒に Displayable にあります。

これらのどれも Switch の Changed、Turned On、Turned Off ヘッドを発火させません——それらはプレイヤーが切り替えたときのためのものです。自分が書き込む Switch を自分でも監視しているグラフが、自分自身を発火させることはありません。

Get Switch Checked

blueprint.element.switch.getChecked · Pure

Set Switch Checked

blueprint.element.switch.setChecked · Latent

Turn Switch On

blueprint.element.switch.turnOn · Latent

true を渡す Set Switch Checked を、よくある場合が一語で読めるよう専用のカードにしたものです。

Turn Switch Off

blueprint.element.switch.turnOff · Latent

Toggle Switch

blueprint.element.switch.toggle · Latent

状態を反転させ、結果として何になったかを返します。そのため後続の分岐は2度目の読み取りを必要としません。

Frame

Frame ノードは element:nl.frame ピンを取り、その Frame 自身のターゲット Page と params に作用します。プレイヤーを別の Page に移動させるのは別の仕事であり、App の Go Page が担います。Self 形態は Frame にあります。

Get Frame Target Page

blueprint.element.frame.getTargetPage · Pure

ターゲット Page の surface id を読み取ります。Frame が何も表示していないときは空文字列。

Set Frame Page

blueprint.element.frame.setTargetPage · Latent

Frame を別の Page に切り替えます。ドロップダウンは、Frame 自身が乗っている Page と、直接またはコンポーネントを経由してそこへ戻ってくる Page を除外します。この Element 形態は接続された Element ノードを通して Frame を見つけるため、参照が接続されるまで、ドロップダウンはすべての Page を一覧表示します。切り替え後、Frame は通常の進入・退出アニメーションを再生します。

カード上のフィールド

選んだ Page がパラメータを宣言している場合、Frame の Self 版と同じように、カードの props の前にパラメータごとの入力が増えます。

Get Frame Params

blueprint.element.frame.getParams · Pure

埋め込まれた Page に渡される params オブジェクトを読み取ります。

Set Frame Params

blueprint.element.frame.setParams · Latent

params オブジェクトを書き込みます。オブジェクトでない値は空のオブジェクトに正規化されます。

Video

Video ノードは video という名前の element:nl.video ピンを持つため、動画へのバインディングを持つページ上のどのグラフからでも使えます。たとえば動画の横に置いたスキップボタンのブループリントです。各ノードは、Video にある同じ名前のノードが自身の動画に行うことを、接続された動画に対して行います。動画の Playback Ended（再生終了）は、動画ウィジェット自身のブループリントにあります。

Play Video

blueprint.element.video.play · Latent

動画の再生を始めます。一時停止中なら止めた位置から再開し、最後まで再生したあとなら最初から再生し直します。

Pause Video

blueprint.element.video.pause · Latent

動画を今の位置で一時停止します。

Stop Video

blueprint.element.video.stop · Latent

動画を一時停止し、クリップの先頭に戻します。

Seek Video

blueprint.element.video.seek · Latent

動画を time の位置へ移します。再生中の動画を終わりに移すと、その動画の Playback Ended が実行されます。

Get Video Time

blueprint.element.video.getTime · Pure

動画の今の再生位置を、クリップの先頭からの秒数で返します。画面にクリップがないときは 0 です。

Get Video Duration

blueprint.element.video.getDuration · Pure

クリップの長さを秒で返します。読み込みが終わるまでは 0 です。

Is Video Playing

blueprint.element.video.isPlaying · Pure

動画が再生中のとき true です。

Is Video Ended

blueprint.element.video.isEnded · Pure

クリップが最後まで再生されたあとは true で、もう一度再生するか位置を移すまで続きます。Loop がオンのときは常に false です。

Set Video Volume

blueprint.element.video.setVolume · Latent

ウィジェットで設定した Volume（音量）の代わりに、動画の音量を設定します。

Set Video Muted

blueprint.element.video.setMuted · Latent

動画を消音するか、消音を解除します。

Set Video Loop

blueprint.element.video.setLoop · Latent

Loop（ループ）をオンかオフにします。

Set Video Speed

blueprint.element.video.setPlaybackRate · Latent

動画の再生の速さを設定します。1 が通常です。

Get Video Volume

blueprint.element.video.getVolume · Pure

動画の音量（0 から 1）を返します。プレイヤーの音量設定は含みません。

Is Video Muted

blueprint.element.video.isMuted · Pure

動画が消音されているとき true です。