2016-01-18 14:38:44 +00:00
|
|
|
# clipboard
|
|
|
|
|
|
|
|
`clipboard`モジュールは、コピーとペースト操作を実行するメソッドを提供します。次の例は、クリップボードに文字列を書き込む方法を示しています:
|
|
|
|
|
|
|
|
```javascript
|
2016-10-03 03:47:16 +00:00
|
|
|
const clipboard = require('electron').clipboard
|
|
|
|
clipboard.writeText('Example String')
|
2016-01-18 14:38:44 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
X Windowsシステム上では、セレクションクリップボードがあります。それを操作するために、それぞれのメソッドで、`selection`を通す必要があります。
|
|
|
|
|
|
|
|
```javascript
|
2016-10-03 03:47:16 +00:00
|
|
|
clipboard.writeText('Example String', 'selection')
|
|
|
|
console.log(clipboard.readText('selection'))
|
2016-01-18 14:38:44 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## メソッド
|
|
|
|
|
|
|
|
`clipboard`モジュールには、次のメソッドがあります:
|
|
|
|
|
|
|
|
**Note:** 実験的APIには、そのようにマークしてあり、将来的には削除される可能性があります。
|
|
|
|
|
|
|
|
### `clipboard.readText([type])`
|
|
|
|
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
プレーンテキストとしてクリップボードの内容を返します。
|
|
|
|
|
|
|
|
### `clipboard.writeText(text[, type])`
|
|
|
|
|
|
|
|
* `text` String
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
プレーンテキストとしてクリップボードに`text`を書き込みます。
|
|
|
|
|
2016-05-26 21:26:12 +00:00
|
|
|
### `clipboard.readHTML([type])`
|
2016-01-18 14:38:44 +00:00
|
|
|
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
HTMLマークアップとして、クリップボードの内容を返します。
|
|
|
|
|
2016-05-26 21:26:12 +00:00
|
|
|
### `clipboard.writeHTML(markup[, type])`
|
2016-01-18 14:38:44 +00:00
|
|
|
|
|
|
|
* `markup` String
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
クリップボードにHTMLマークアップとして書き込みます。
|
|
|
|
|
|
|
|
### `clipboard.readImage([type])`
|
|
|
|
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
[NativeImage](native-image.md)としてクリップボードの内容を返します。
|
|
|
|
|
|
|
|
### `clipboard.writeImage(image[, type])`
|
|
|
|
|
|
|
|
* `image` [NativeImage](native-image.md)
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
`image` としてクリップボードに書き込みます。
|
|
|
|
|
|
|
|
### `clipboard.clear([type])`
|
|
|
|
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
クリップボードの内容をクリアします。
|
|
|
|
|
|
|
|
### `clipboard.availableFormats([type])`
|
|
|
|
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
`type`のクリップボードがサポートしているフォーマット配列を返します。
|
|
|
|
|
|
|
|
### `clipboard.has(data[, type])` _実験_
|
|
|
|
|
|
|
|
* `data` String
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
`data`で指定したフォーマットをクリップボードがサポートしているかどうかを返します。
|
|
|
|
|
|
|
|
```javascript
|
2016-10-03 03:47:16 +00:00
|
|
|
console.log(clipboard.has('<p>selection</p>'))
|
2016-01-18 14:38:44 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### `clipboard.read(data[, type])` _実験_
|
|
|
|
|
|
|
|
* `data` String
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
クリップボードから`data`を読み込みます。
|
|
|
|
|
|
|
|
### `clipboard.write(data[, type])`
|
|
|
|
|
|
|
|
* `data` Object
|
|
|
|
* `text` String
|
|
|
|
* `html` String
|
|
|
|
* `image` [NativeImage](native-image.md)
|
|
|
|
* `type` String (optional)
|
|
|
|
|
|
|
|
```javascript
|
2016-10-03 03:47:16 +00:00
|
|
|
clipboard.write({text: 'test', html: '<b>test</b>'})
|
2016-01-18 14:38:44 +00:00
|
|
|
```
|
|
|
|
クリップボードに`data`を書き込みます。
|