> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查看和操作主机的前面板 (wdpanel.exe)

> 查看和操作主机的前面板 (wdpanel.exe)

使用此工具查看和操作主机的前面板。

| 命令                        | 说明          |
| ------------------------- | ----------- |
| [button](#wdapp_button)   | 按下前面板上的按钮   |
| [screenshot]()            | 拍摄前面板屏幕截图   |
| [script](#wdapp_script)   | 将脚本应用到前面板按钮 |
| [enable]()                | 启用前面板显示     |
| [disable](#wdapp_disable) | 禁用前面板显示     |

<a id="wdapp_button" />

## wdpanel button

按下前面板上的按钮。

`wdpanel button <buttonValue>`

| 选项            | 说明                                                   |
| ------------- | ---------------------------------------------------- |
| `buttonValue` | 要按下的按钮。允许的值为 1-5、up、down、left、right、select 和 switch。 |

<a id="wdapp_screenshot" />

## wdpanel screenshot

以 PNG 文件格式拍摄前面板屏幕截图。

`wdpanel screenshot [<filename>]`

| 选项         | 说明       |
| ---------- | -------- |
| `filename` | 输出文件的名称。 |

<a id="wdapp_script" />

## wdpanel script

将内置或自定义脚本应用到前面板按钮。该脚本必须已存在于主机上,并按名称(而非文件路径)标识。

`wdpanel script <buttonNumber> <scriptname> [custom]`

| 选项             | 说明                  |
| -------------- | ------------------- |
| `buttonNumber` | 前面板按钮的编号。允许的值为 1-5。 |
| `scriptname`   | 要应用到指定按钮的脚本名称。      |
| `custom`       |                     |

<a id="wdapp_enable" />

## wdpanel enable

启用前面板显示。

`wdpanel enable`

<a id="wdapp_disable" />

## wdpanel disable

清除并禁用前面板显示。

`wdpanel disable`

## 另请参阅

[基于主机的命令行工具](/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [基于主机的命令行工具](/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [面向 XBOX 的主机端命令行工具](/zh-CN/tools/tools-console/console_commandlinetools/index.md)
- [使用开发主机测量功耗](/zh-CN/build/game-principles/sustainability/sustainability-devkit-guide.md)
- [XBOX Manager](/zh-CN/tools/tools-console/xbom/xbom.md)
- [XBOX Manager：管理主机设置](/zh-CN/tools/tools-console/xbom/manager-tool-console-settings.md)