使用小工具 > 3D > 3D 按壓按鈕
  
3D 按壓按鈕
* 
僅適用於 3D 眼鏡專案。
此小工具的功能為何?
「3D 按壓按鈕」小工具可讓您在 HoloLens 2 上使用全面的手關節動作追蹤。如果使用 HoloLens,也可以透過凝視 (Gaze) 或隔空點按 (Air tap) 3D 按鈕。
使用此小工具的時機?
若您想要觸發事件時,「3D 按壓按鈕」尤為有用。例如,您可以使用「3D 按壓按鈕」來開始播放序列。
想在 HoloLens 2 上檢視體驗並使用手關節動作追蹤時,「3D 按壓按鈕」特別有用。不過,「3D 按壓按鈕」適用於任何與「3D 標籤」和「3D 圖像」小工具類似的使用者動作。
還有任何特殊內容、服務、事件、動作嗎?
欲檢視常見小工具內容、服務、事件等清單,請參閱〈共通的小工具屬性、服務、事件〉。
下表是此小工具專屬屬性的清單。
內容
JavaScript
類型
描述
「文字」
text
string
顯示在按鈕上的文字。
圖像
src
resource url
欲納入圖像,您可執行下列動作之一:
按一下欄位旁以新增新圖像檔案。
可直接輸入或貼上圖像網址至此欄位中。
從下拉式功能表中選取圖像。
可支援的檔案格式:
.png
.jpg
高度
height
number
按鈕高度 (以公尺為單位)。最小值為 4 cm。
寬度
width
number
按鈕寬度 (以公尺為單位)。最小值為 4 cm。
字型色彩
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
按鈕的顏色。從顏色選擇器中選擇一個顏色。
可見
visible
boolean
如果選取此核取方塊,小工具則會在執行階段顯示。
已停用
disabled
boolean
如果選取此核取方塊,即會停用小工具的點選功能。
事件
JavaScript
描述
已按下
pressed
按鈕已按下時會觸發。若停用按鈕,則不會觸發事件。
作用中的小工具
此範例為小工具可能的外觀!
使用所必須的最少步驟
近似外觀
* 
這個小工具最適合搭配 「3D 面板」使用。
1. 拖放「3D 面板」小工具至畫布上。
2. 拖放「3D 按壓按鈕」小工具至畫布上。移動小工具至您想要的位置。
* 
您將小工具拖放到畫布後,尚需將他們拖放至「檢視」樹中的面板小工具下。
3. 輸入您要顯示在「文字」欄位中的文字,或繫結資料屬性至小工具的「文字」欄位。在此範例中,我們使用 Submit
4. 將下列編碼新增至 Home.js
$scope.hidePanel = function(){
$scope.view.wdg['3DPanel-1']['visible'] = false;
$scope.view.wdg['3DPressButton-1']['visible'] = false;

}
* 
您需為每個置入在 $scope.hidePanel = function(){ 下的「3D 面板」下的小工具個別包含一行。在我們的範例中,我們也新增了「3D 圖像」、「3D 核取方塊」及「3D 標籤」,因此新增了下列各行至 Home.js
$scope.hidePanel = function(){
$scope.view.wdg['3DPanel-1']['visible'] = false;
$scope.view.wdg['3DPressButton-1']['visible'] = false;
$scope.view.wdg['3DImage-1']['visible'] = false;
$scope.view.wdg['3DCheckbox-1']['visible'] = false;
$scope.view.wdg['3DLabel-1']['visible'] = false;

}
這可確保按一下 Submit「3D 按壓按鈕」時,會隱藏所有置入於面板下的小工具。
5. 返回「3D 按壓按鈕」「詳細資訊」窗格,向下捲動至「事件」
6. 按一下「已按下」事件旁邊的「JS」並輸入「hidePanel()」。