> ## 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.

# XGameUiTextEntryUpdatePositionHint

> XGameUiTextEntryUpdatePositionHint

# XGameUiTextEntryUpdatePositionHint

更新虚拟键盘的首选定位。

## 语法

```cpp theme={null}
HRESULT XGameUiTextEntryUpdatePositionHint(  
         XGameUiTextEntryHandle handle,
         XGameUiTextEntryPositionHint positionHint 
)  
```

### 参数

*handle*   \_In\_\
类型：XGameUiTextEntryHandle

已打开的虚拟键盘的句柄。

*positionHint*   \_In\_\
类型：[XGameUiTextEntryPositionHint](/reference/system/xgameui/enums/xgameuitextentrypositionhint)

更新放置虚拟键盘的首选位置。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。有关错误代码列表，请参阅[错误代码](/reference/errorcodes)。

## 要求

**标头：** XGameUI.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 请参阅

[XGameUI](/reference/system/xgameui/xgameui_members)


## Related topics

- [XGameUiTextEntryInputScope](/zh-CN/reference/system/xgameui/enums/xgameuitextentryinputscope.md)
- [XGameUI](/zh-CN/reference/system/xgameui/xgameui_members.md)
- [XGameUiTextEntryPositionHint](/zh-CN/reference/system/xgameui/enums/xgameuitextentrypositionhint.md)
- [XGameUiTextEntryUpdateVisibility](/zh-CN/reference/system/xgameui/functions/xgameuitextentryupdatevisibility.md)
- [XGameUiTextEntryOptions](/zh-CN/reference/system/xgameui/structs/xgameuitextentryoptions.md)