Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
b31f2c02
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
b31f2c02
编写于
8月 27, 2022
作者:
L
LVB8189
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Signed-off-by: LVB8189 <lvbai1@huawei.com>
Changes to be committed:
上级
4f4ef6dd
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
38 addition
and
37 deletion
+38
-37
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
+38
-37
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
浏览文件 @
b31f2c02
...
@@ -25,7 +25,7 @@ import pasteboard from '@ohos.pasteboard';
...
@@ -25,7 +25,7 @@ import pasteboard from '@ohos.pasteboard';
| MIMETYPE_TEXT_WANT
<sup>
7+
</sup>
| string | 是 | 否 | Want的MIME类型定义。 |
| MIMETYPE_TEXT_WANT
<sup>
7+
</sup>
| string | 是 | 否 | Want的MIME类型定义。 |
| MIMETYPE_TEXT_PLAIN
<sup>
7+
</sup>
| string | 是 | 否 | Plain
text文本的MIME类型定义。 |
| MIMETYPE_TEXT_PLAIN
<sup>
7+
</sup>
| string | 是 | 否 | Plain
text文本的MIME类型定义。 |
| MIMETYPE_TEXT_URI
<sup>
7+
</sup>
| string | 是 | 否 | URI文本的MIME类型定义。 |
| MIMETYPE_TEXT_URI
<sup>
7+
</sup>
| string | 是 | 否 | URI文本的MIME类型定义。 |
| MIMETYPE_PIXELMAP
<sup>
9+
</sup>
| string | 是 | 否 |
像素映射
的MIME类型定义。 |
| MIMETYPE_PIXELMAP
<sup>
9+
</sup>
| string | 是 | 否 |
PixelMap
的MIME类型定义。 |
## pasteboard.createPlainTextData
## pasteboard.createPlainTextData
...
@@ -157,11 +157,11 @@ createPixelMapData((pixelMap: image.PixelMap): PasteData
...
@@ -157,11 +157,11 @@ createPixelMapData((pixelMap: image.PixelMap): PasteData
import
image
from
'
@ohos.multimedia.image
'
;
import
image
from
'
@ohos.multimedia.image
'
;
var
buffer
=
new
ArrayBuffer
(
128
)
var
buffer
=
new
ArrayBuffer
(
128
)
var
opt
=
{
var
opt
=
{
size
:
{
height
:
3
,
width
:
5
},
size
:
{
height
:
3
,
width
:
5
},
pixelFormat
:
3
,
pixelFormat
:
3
,
editable
:
true
,
editable
:
true
,
alphaType
:
1
,
alphaType
:
1
,
scaleMode
:
1
scaleMode
:
1
}
}
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
var
pasteData
=
pasteboard
.
createPixelMapData
(
pixelMap
);
var
pasteData
=
pasteboard
.
createPixelMapData
(
pixelMap
);
...
@@ -170,16 +170,16 @@ createPixelMapData((pixelMap: image.PixelMap): PasteData
...
@@ -170,16 +170,16 @@ createPixelMapData((pixelMap: image.PixelMap): PasteData
## pasteboard.createData<sup>9+</sup>
## pasteboard.createData<sup>9+</sup>
createData(mi
n
eType:string, value: ArrayBuffer): PasteData;
createData(mi
m
eType:string, value: ArrayBuffer): PasteData;
构建一个
具有mineType和value的剪贴板内容对象。
构建一个
自定义类型的剪贴板内容对象,mimeType表明了自定义数据value的数据类型
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**参数**
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| mi
neType | string | 是 | 待保存的min
eType内容。 |
| mi
meType | string | 是 | 待保存的mim
eType内容。 |
| value | ArrayBuffer | 是 | 待保存的value内容。 |
| value | ArrayBuffer | 是 | 待保存的value内容。 |
**返回值**
**返回值**
...
@@ -324,11 +324,11 @@ createPixelMapRecord(pixelMap:image.PixelMap): PasteDataRecord
...
@@ -324,11 +324,11 @@ createPixelMapRecord(pixelMap:image.PixelMap): PasteDataRecord
import
image
from
'
@ohos.multimedia.image
'
;
import
image
from
'
@ohos.multimedia.image
'
;
var
buffer
=
new
ArrayBuffer
(
128
)
var
buffer
=
new
ArrayBuffer
(
128
)
var
opt
=
{
var
opt
=
{
size
:
{
height
:
3
,
width
:
5
},
size
:
{
height
:
3
,
width
:
5
},
pixelFormat
:
3
,
pixelFormat
:
3
,
editable
:
true
,
editable
:
true
,
alphaType
:
1
,
alphaType
:
1
,
scaleMode
:
1
scaleMode
:
1
}
}
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
var
record
=
pasteboard
.
createPixelMapRecord
(
pixelMap
);
var
record
=
pasteboard
.
createPixelMapRecord
(
pixelMap
);
...
@@ -340,20 +340,20 @@ createPixelMapRecord(pixelMap:image.PixelMap): PasteDataRecord
...
@@ -340,20 +340,20 @@ createPixelMapRecord(pixelMap:image.PixelMap): PasteDataRecord
createRecord(mimeType:string, value: ArrayBuffer):PasteDataRecord;
createRecord(mimeType:string, value: ArrayBuffer):PasteDataRecord;
创建一条具有mi
n
eType和value的对象内容的条目。
创建一条具有mi
m
eType和value的对象内容的条目。
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**参数**
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| mi
neType | string | 是 | min
eType内容。 |
| mi
meType | string | 是 | mim
eType内容。 |
| value | ArrayBuffer | 是 | ArrayBuffer类型的value内容。 |
| value | ArrayBuffer | 是 | ArrayBuffer类型的value内容。 |
**返回值**
**返回值**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
|
[
PasteDataRecord
](
#pastedatarecord7
)
| 一条新建的具有mi
n
eType和value的对象内容条目。 |
|
[
PasteDataRecord
](
#pastedatarecord7
)
| 一条新建的具有mi
m
eType和value的对象内容条目。 |
**示例**
**示例**
...
@@ -371,14 +371,14 @@ createRecord(mimeType:string, value: ArrayBuffer):PasteDataRecord;
...
@@ -371,14 +371,14 @@ createRecord(mimeType:string, value: ArrayBuffer):PasteDataRecord;
| 名称 | 说明 |
| 名称 | 说明 |
| ----- | ----------------------- |
| ----- | ----------------------- |
| InApp
<sup>
9+
</sup>
|InApp表示仅允许应用内粘贴。 |
| InApp
<sup>
9+
</sup>
|InApp表示仅允许
同
应用内粘贴。 |
| LocalDevice
<sup>
9+
</sup>
|LocalDevice表示仅允许在此设备中粘贴。 |
| LocalDevice
<sup>
9+
</sup>
|LocalDevice表示仅允许在此设备中粘贴。 |
| CrossDevice
<sup>
9+
</sup>
|CrossDevice表示允许跨设备在任何应用程序中粘贴。 |
| CrossDevice
<sup>
9+
</sup>
|CrossDevice表示允许跨设备在任何应用程序中粘贴。 |
## PasteDataProperty
## PasteDataProperty
定义了剪贴板中所有内容条目的属性,包含时间戳、数据类型以及一些附加数据等。
定义了剪贴板中所有内容条目的属性,包含时间戳、数据类型
、粘贴范围
以及一些附加数据等。
**系统能力**
: 以下各项对应的系统能力均为SystemCapability.MiscServices.Pasteboard。
**系统能力**
: 以下各项对应的系统能力均为SystemCapability.MiscServices.Pasteboard。
...
@@ -431,7 +431,7 @@ convertToText(): Promise<string>
...
@@ -431,7 +431,7 @@ convertToText(): Promise<string>
var
record
=
pasteboard
.
createUriRecord
(
"
dataability:///com.example.myapplication1?user.txt
"
);
var
record
=
pasteboard
.
createUriRecord
(
"
dataability:///com.example.myapplication1?user.txt
"
);
record
.
convertToText
().
then
((
data
)
=>
{
record
.
convertToText
().
then
((
data
)
=>
{
console
.
info
(
'
convertToText success data :
'
+
JSON
.
stringify
(
data
));
console
.
info
(
'
convertToText success data :
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
'
convertToText failed because
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
convertToText failed because
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -580,17 +580,18 @@ getPrimaryPixelMap(): image.PixelMap
...
@@ -580,17 +580,18 @@ getPrimaryPixelMap(): image.PixelMap
```
js
```
js
import
image
from
'
@ohos.multimedia.image
'
;
import
image
from
'
@ohos.multimedia.image
'
;
var
buffer
=
new
ArrayBuffer
(
128
)
var
buffer
=
new
ArrayBuffer
(
128
)
var
opt
=
{
var
opt
=
{
size
:
{
height
:
3
,
width
:
5
},
size
:
{
height
:
3
,
width
:
5
},
pixelFormat
:
3
,
pixelFormat
:
3
,
editable
:
true
,
editable
:
true
,
alphaType
:
1
,
alphaType
:
1
,
scaleMode
:
1
scaleMode
:
1
}
}
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
var
pasteData
=
pasteboard
.
createPixelMapData
(
pixelMap
);
var
pasteData
=
pasteboard
.
createPixelMapData
(
pixelMap
);
var
pixelMap
=
pasteData
.
getPrimaryPixelMap
();
var
pixelMap
=
pasteData
.
getPrimaryPixelMap
();
})
})
```
```
...
@@ -697,7 +698,7 @@ addPixelMapRecord(pixelMap: image.PixelMap): void
...
@@ -697,7 +698,7 @@ addPixelMapRecord(pixelMap: image.PixelMap): void
向当前剪贴板内容中添加一条pixelMap条目,并将MIMETYPE_PIXELMAP添加到
[
PasteDataProperty
](
#pastedataproperty7
)
的mimeTypes中。入参均不能为空,否则添加失败。
向当前剪贴板内容中添加一条pixelMap条目,并将MIMETYPE_PIXELMAP添加到
[
PasteDataProperty
](
#pastedataproperty7
)
的mimeTypes中。入参均不能为空,否则添加失败。
剪贴板内容中添加的条目达到数量上限
128
后,后续的添加操作无效。
剪贴板内容中添加的条目达到数量上限
512
后,后续的添加操作无效。
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**系统能力**
: SystemCapability.MiscServices.Pasteboard
...
@@ -712,11 +713,11 @@ addPixelMapRecord(pixelMap: image.PixelMap): void
...
@@ -712,11 +713,11 @@ addPixelMapRecord(pixelMap: image.PixelMap): void
import
image
from
'
@ohos.multimedia.image
'
;
import
image
from
'
@ohos.multimedia.image
'
;
var
buffer
=
new
ArrayBuffer
(
128
)
var
buffer
=
new
ArrayBuffer
(
128
)
var
opt
=
{
var
opt
=
{
size
:
{
height
:
3
,
width
:
5
},
size
:
{
height
:
3
,
width
:
5
},
pixelFormat
:
3
,
pixelFormat
:
3
,
editable
:
true
,
editable
:
true
,
alphaType
:
1
,
alphaType
:
1
,
scaleMode
:
1
scaleMode
:
1
}
}
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
var
record
=
pasteboard
.
createPlainTextData
(
"
hello
"
).
addPixelMapRecord
(
pixelMap
);
var
record
=
pasteboard
.
createPlainTextData
(
"
hello
"
).
addPixelMapRecord
(
pixelMap
);
...
@@ -726,19 +727,19 @@ addPixelMapRecord(pixelMap: image.PixelMap): void
...
@@ -726,19 +727,19 @@ addPixelMapRecord(pixelMap: image.PixelMap): void
### addRecord<sup>9+</sup>
### addRecord<sup>9+</sup>
addRecord(mi
n
eType: string, value: ArrayBuffer): void;
addRecord(mi
m
eType: string, value: ArrayBuffer): void;
向当前剪贴板内容中添加一条键值对记录条目,同时也会将条目类型添加到
[
PasteDataProperty
](
#pastedataproperty7
)
的mimeTypes中。入参均不能为空,否则添加失败。
向当前剪贴板内容中添加一条键值对记录条目,同时也会将条目类型添加到
[
PasteDataProperty
](
#pastedataproperty7
)
的mimeTypes中。入参均不能为空,否则添加失败。
剪贴板内容中添加的条目达到数量上限
128
后,后续的添加操作无效。
剪贴板内容中添加的条目达到数量上限
512
后,后续的添加操作无效。
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**系统能力**
: SystemCapability.MiscServices.Pasteboard
**参数**
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| mi
neType | string | 是 | 待添加的mineType内容条目
。 |
| mi
meType | string | 是 | 待添加的自定义数据的mimeType类型
。 |
| value | ArrayBuffer | 是 |
要保存的ArrayBuffer类型的value
内容。 |
| value | ArrayBuffer | 是 |
待添加的自定义数据
内容。 |
**示例**
**示例**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录