Instance Method インスタンスメソッド

onPasteCommand(of:validator:perform:)

Adds an action to perform in response to the system’s Paste command with items that you validate. あなたが妥当と認める項目をもつシステム「ペースト」コマンドに答えて実行するあるアクションを加えます。

Declaration 宣言 

func onPasteCommand<Payload>(of supportedTypes: [String], validator: @escaping ([NSItemProvider]) -> Payload?, perform payloadAction: @escaping (Payload) -> Void) -> some View

Return Value 戻り値

A view that triggers action when the system paste command is invoked, validating the paste command with validator. あるビュー、それはactionをシステムのペーストコマンドが発動される時に引き起こします、ペーストコマンドをvalidatorで検証しています。

Parameters パラメータ

supportedTypes

The uniform type identifiers that describe the types of content this view can accept through a paste action. If the pasteboard doesn’t contain any of the supported types, the paste command doesn’t trigger. ユニホーム型識別子いくつか、それらはこのビューがペーストアクションを通して受け入れ可能な内容の型を記述します。ペーストボードがこのサポートされる型のいずれも含まないならば、ペーストコマンドは引き起こされません。

validator

A handler that validates the command. This handler receives items from the pasteboard with the types you specify in the supportedTypes parameter. Use this handler to decide whether the items are valid and preprocess them for the action closure. If you return nil instead, the paste command doesn’t trigger. コマンドを検証するハンドラ。このハンドラは、あなたがsupportedTypesパラメータにおいて指定する型をもつペーストボードから項目を受け取ります。このハンドラを使って、項目それらが有効であるかどうかを決定してください、そしてそれらをactionクロージャのために前処理してください。あなたがnilを代わりに返すならば、ペーストコマンドは引き起こされません。

payloadAction

The action to perform when the paste command triggers. ペーストコマンドが引き起こされる時に実行するアクション。

Discussion 議論

Pass an array of uniform type identifiers to the supportedTypes parameter. Place the higher priority types closer to the beginning of the array. The pasteboard items that the validator closure receives have the most preferred type out of all the types the source supports. ユニホーム型識別子それらからなるある配列をsupportedTypesパラメータに渡してください。より高い優先度の型を配列の始まりに置いてください。validatorクロージャが受け取るペーストボード項目は、ソースがサポートする全ての型の中で最も優先される型を持ちます。

For example, if your app can handle plain text and rich text, but you prefer rich text, place the rich text type first in the array. If rich text is available when the paste action occurs, the validator closure passes that rich text along. 例えば、あなたのアプリがプレーンテキストとリッチテキストを取り扱える、しかしあなたがリッチテキストのほうを好むならば、リッチテキスト型をその配列において最初に置いてください。ペーストアクションが発生する時にリッチテキストが利用可能ならば、validatorクロージャはそのリッチテキストを手渡します。

See Also 参照

Input and Events Modifiers

func onLongPressGesture(minimumDuration: Double, maximumDistance: CGFloat, pressing: ((Bool) -> Void)?, perform: () -> Void) -> some View
Adds an action to perform when this view recognizes a long press gesture. このビューが長押しジェスチャを認識する時に実行するアクションを加えます。
Deprecated 非推奨
func onPasteCommand(of: [String], perform: ([NSItemProvider]) -> Void) -> some View
Adds an action to perform in response to the system’s Paste command. システムのもつ「ペースト」コマンドに答えて実行するアクションを加えます。
Deprecated 非推奨
func onDrop(of: [String], delegate: DropDelegate) -> some View
Defines the destination for a drag and drop operation with the same size and position as this view, with behavior controlled by the given delegate. ドラッグアンドドロップ操作の行き先を、このビューと同じ大きさと位置で定義します、この与えられた委任先によって制御された挙動で。
Deprecated 非推奨
func onDrop(of: [String], isTargeted: Binding<Bool>?, perform: ([NSItemProvider]) -> Bool) -> some View
Defines the destination for a drag and drop operation, using the same size and position as this view, handling dropped content with the given closure. ドラッグアンドドロップ操作に対する行き先を定義します、このビューと同じ大きさと位置を使います、ドロップされた内容をこの与えられたクロージャで取り扱います。
Deprecated 非推奨
func onDrop(of: [String], isTargeted: Binding<Bool>?, perform: ([NSItemProvider], CGPoint) -> Bool) -> some View
Defines the destination for a drag and drop operation with the same size and position as this view, handling dropped content and the drop location with the given closure. ドラッグアンドドロップ操作の行き先をこのビューと同じ大きさと位置で定義します、ドロップされた内容とドロップ位置をこの与えられたクロージャで取り扱います。
Deprecated 非推奨
func focusable(Bool, onFocusChange: (Bool) -> Void) -> some View
Specifies if the view is focusable and, if so, adds an action to perform when the view comes into focus. ビューがフォーカス可能であるならば指定しますそして、もしそうならば、ビューがフォーカスに入る時に実行するアクションを加えます。
Deprecated 非推奨