使用小组件 > 3D > 3D 按钮
  
3D 按钮
* 
仅在 3D 眼镜项目中可用。
* 
我们建议使用“3D 下按按钮”来代替“3D 按钮”，因为“3D 按钮”小组件将在以后的版本中被弃用。以下是需要知悉的事项：
• “3D 按钮”小组件将无法再用于新项目。这不会立即影响包含“3D 按钮”小组件的现有项目，您仍可以编辑并重新发布包含它们的项目。
• 然后，从以后的某个日期（待定）开始，现有的全部“3D 按钮”都将转换为“3D 下按按钮”。有关这一转变的详细信息即将公布。
这个小组件有什么功能？
3D 按钮小组件允许您在 HoloLens 2 上利用完全可表述的手势跟踪。如果使用 HoloLens，还可以凝视并隔空敲击 3D 按钮。
何时会用到这个小组件？
如果要创建在 HoloLens 2 上查看的体验并想要使用可表述的手势跟踪，则 3D 按钮特别有用。您也可以将 3D 按钮用于任何与 3D 标签和 3D 图像小组件类似的用户操作。
这个小组件中是否有专用的属性、服务、事件或操作？
若要查看小组件常用的属性、服务和事件的列表，请参阅小组件的通用属性、服务和事件。
下表列出了该小组件的专用属性。
属性
JavaScript
类型
说明
文本
text
string
3D 按钮标签的文本
资源
src
resource url
用于 3D 按钮的资源的路径。要包括图像，您可以执行以下操作之一：
• 单击字段旁边可添加新的图像文件。
• 输入图像 URL 或将其直接复制粘贴到字段中。
• 从下拉菜单中选择图像。
支持的文件格式包括：
• .png
• .jpg
• .jpeg
• .gif
• .bmp
高度
height
number
以米为单位的 3D 按钮高度。最小值为 0.04 米。
宽度
width
number
以米为单位的 3D 按钮宽度。最小值为 0.04 米。
字体颜色
fontColor
color
字体的颜色。从颜色选取器中选择一种颜色。
X 坐标
x
number
小组件在 X 轴上的位置。
Y 坐标
y
number
小组件在 Y 轴上的位置。
Z 坐标
z
number
小组件在 Z 轴上的位置。
X 旋转
rx
number
小组件绕 X 轴旋转的角度。
Y 旋转
ry
number
小组件绕 Y 轴旋转的角度。
Z 旋转
rz
number
小组件绕 Z 轴旋转的角度。
按钮颜色
color
color
按钮的颜色。从颜色选取器中选择一种颜色。
小组件的显示效果
以下是小组件的显示效果示例！
使用时的必要步骤
显示效果
1. 将“3D 按钮”小组件拖放到工作区中。
2. 在“文本”字段中输入要显示的文字，或将数据属性绑定到小组件的“文本”字段。