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

# IGameInput::EnableBackgroundInput

> 啟用或停用在應用程式位於背景時將輸入傳遞給應用程式。

啟用或停用在應用程式位於背景時將輸入傳遞給應用程式。

## 語法

```cpp theme={null}
void EnableBackgroundInput(
    bool enable
);
```

### 參數

*enable*   \_In\_\
類型：bool

`true` 表示在應用程式未取得焦點時也接收輸入；`false` 表示只在應用程式取得焦點時接收輸入。

### 傳回值

類型：void

此方法不會傳回值。

## 備註

根據預設，GameInput 只會在應用程式位於前景並取得焦點時將輸入傳遞給該應用程式。呼叫 `EnableBackgroundInput(true)`，即可在其他應用程式取得焦點時也接收輸入。背景輸入會一次套用至所有輸入類型，包括透過 [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md) 回報的 Guide 和 Share 系統按鈕。呼叫 `EnableBackgroundInput(false)` 可恢復預設行為。

此設定主要與 Windows 相關，因為在 Windows 上，多個應用程式可以並排執行，且焦點可以在它們之間移動。

此方法取代舊版 GameInput 中的 [IGameInput::SetFocusPolicy](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) 方法和 [GameInputFocusPolicy](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) 列舉。GameInput v4 中不提供可防止其他處理序接收輸入的獨佔前景原則。

在 PC 上，當 GameInput 執行階段是隨應用程式側載而非安裝在系統上時，啟用背景輸入會被忽略。如需詳細資訊，請參閱 [GameInput 側載](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-agility-redistributable.md)。

> [!NOTE]
>
> 許多使用者會執行以 Guide 按鈕開啟功能表、以 Share 按鈕擷取螢幕畫面的重疊應用程式。請考量您的應用程式是否需要在背景時處理系統按鈕。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[GameInput 基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-fundamentals.md)\
[GameInput 側載](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v4** | 已推出。 |


## Related topics

- [IGameInput::SetFocusPolicy (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)
- [GameInputFocusPolicy (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [GameInput 側載](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-agility-redistributable.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)