ユーザーが画像の領域を描画、消去、強調表示できるコントロール。
Description
ユーザーは、ホワイトボード、描画図、型指定されたテキストに変換できる単語の書き込みなどのこのコントロールを使用できます。
制限事項
ペン入力コントロールには、次の制限があります。
- ペン コントロールには、Windows アプリでマウスまたはタッチ入力を使用した描画の部分的なサポートしかありません。 ストロークが断続的になる場合があります。 滑らかな描画を行うには、ペンを使用するか、ブラウザーでアプリを実行します。
重要なプロパティ
Image – エンド ユーザーによって描画されるイメージを表す Output プロパティ。
色 – 入力ストロークの色。
モード – コントロールは 描画 モードまたは 消去 モードです。 選択モードは非推奨になりました。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。 コントロールの目的と、入力の代替メソッドを記述するために使用できます。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
塗りつぶし – コントロールの背景色。
Height – コントロールの上端と下端の間の距離。
入力 – 非推奨。 入力がマウス入力、ペン入力、タッチ入力のいずれをサポートしているか。 既定値 (7) では、3 つすべてがサポートされます。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
SelectionColor – 選択した項目またはリスト内の項目のテキストの色、またはペン コントロールの選択ツールの色。
SelectionThickness – ペン入力コントロールの選択ツールの太さ。
ShowControls – 再生ボタンや音量スライダー、ペン コントロールなど、オーディオ プレーヤーとビデオ プレーヤーのどちらが表示されるか (描画、消去、クリアのアイコンなど)。
サイズ – コントロールに表示されるテキストのフォント サイズ。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナーの左端との間の距離 (親コンテナーがない場合は画面)。
Y – コントロールの上端と親コンテナーの上端との間の距離 (親コンテナーがない場合は画面)。
関連する関数
Collect( CollectionName, DatatoCollect )
Example
イメージのセットを作成する
Pen 入力コントロールを追加し、MyDoodles という名前を付け、ShowControls プロパティを true に設定します。
Button コントロールを追加し、MyDoodles の下に移動し、Button コントロールの Text プロパティを設定して[追加]を表示します。
Button コントロールの OnSelect プロパティを次の式に設定します。
Collect(Doodles, {Sketch:MyDoodles.Image})イメージ ギャラリー コントロールを追加し、それを Button コントロールの下に移動し、3 つの項目が表示されるまでイメージ ギャラリー コントロールの幅を縮小します。
イメージ ギャラリー コントロールの Items プロパティを Doodles に設定し、F5 キーを押します。
MyDoodles で画像を描画し、ボタン コントロールをクリックまたはタップします。
描画したイメージが イメージ ギャラリー コントロールに表示されます。
(省略可能) ペン入力 コントロールで、アイコンをクリックまたはタップして描画した画像をクリアし、別の画像を描画して、 ボタン コントロールをクリックまたはタップします。
イメージ ギャラリー コントロールで、Image コントロールの OnSelect プロパティを次の数式に設定します。
Remove(Doodles, ThisItem)イメージ ギャラリー コントロールで図面をクリックまたはタップして、図面を削除します。
SaveData 関数を使用して図面をローカルに保存するか、Patch 関数を使用してデータ ソースに保存します。
アクセシビリティ ガイドライン
色のコントラスト
次の間に適切な色のコントラストが必要です。
- BorderColor とコントロールの外側の色 (罫線がある場合)
- コントロールの外側の塗りつぶしと色 (罫線がない場合)
スクリーン リーダーのサポート
AccessibleLabel が存在する必要があります。
Important
スクリーン リーダー ユーザーは、ペン入力にアクセスできません。 常に代替形式の入力を提供します。 たとえば、スケッチが必要な場合は、ユーザーが画像をアップロードするための [画像の追加] コントロールを追加することを検討してください。 どちらの方法も提供でき、ユーザーはより快適なものを選択できます。
キーボードのサポート
Important
キーボード ユーザーは、ペン入力にアクセスできません。 常に代替形式の入力を提供します。 たとえば、署名が必要な場合は、ユーザーが自分の名前を 入力するためのテキスト入力 を追加することを検討してください。 どちらの方法も提供でき、ユーザーはより快適なものを選択できます。