> ## 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::SetFocusPolicy (已淘汰)

> 設定遊戲輸入裝置的焦點原則 (已在 v4 中移除)。

> [!WARNING]
>
> **已淘汰。** 此方法已在 GameInput v4 中移除，目前的 API 中無法使用。請改用 [IGameInput::EnableBackgroundInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)。

設定遊戲輸入裝置的焦點原則。

## 語法

```cpp theme={null}
void SetFocusPolicy(
    GameInputFocusPolicy policy
);
```

### 參數

*policy*   \_In\_\
類型：[GameInputFocusPolicy](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)

要設定的焦點原則。

### 傳回值

類型：void

沒有傳回值。

## 備註

`IGameInput::SetFocusPolicy` 方法會設定遊戲輸入裝置的焦點原則。焦點原則會決定輸入裝置是否根據遊戲的焦點提供輸入。焦點是指遊戲是否被選取為主要焦點，或是目前在背景中執行而由另一個應用程式擁有焦點。如需 GameInput API 的中階和進階使用案例，請參閱 [GameInput 進階主題](https://docs.xbox.com/zh-TW/build/core-features/common/input/advanced/input-advanced-topics.md)。

焦點原則僅適用於 Windows。

在 PC 上，當 GameInput 執行階段是隨應用程式側載而非安裝在系統上時，只接受 `GameInputDefaultFocusPolicy` 和 `GameInputEnableBackgroundInput`。其他值 (包括任何旗標組合) 都會被忽略。如需詳細資訊，請參閱 [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)\
[IGameInput::EnableBackgroundInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)\
[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[GameInputFocusPolicy](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)\
[IGameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## 版本歷程記錄

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


## Related topics

- [IGameInput::EnableBackgroundInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)
- [GameInputFocusPolicy (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [IGameInput::SetFocusPolicy](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInputDevice::SetInputSynchronizationState (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setinputsynchronizationstate.md)
- [IGameInputDevice::SetRawDeviceFeature (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setrawdevicefeature.md)