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

# XGameUiTextEntryGetExtents

> XGameUiTextEntryGetExtents

# XGameUiTextEntryGetExtents

取得虛擬鍵盤的螢幕範圍，讓呼叫端知道在何處轉譯文字是安全的。

## 語法

```cpp theme={null}
HRESULT XGameUiTextEntryGetExtents(  
         XGameUiTextEntryHandle handle,
         XGameUiTextEntryExtents* extents
)  
```

### 參數

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

目前開啟之虛擬鍵盤的控制代碼。

*handle*   \_Out\_\
類型：[XGameUiTextEntryExtents](/zh-TW/reference/system/xgameui/structs/xgameuitextentryextents)

描述虛擬鍵盤的螢幕範圍。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。如需錯誤碼清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

## 備註

如果完整鍵盤可見，此函式一律會傳回大型協助工具鍵盤的範圍。
否則，會傳回候選清單的範圍。

## 需求

**標頭：** XGameUI.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XGameUI](/zh-TW/reference/system/xgameui/xgameui_members)


## Related topics

- [XGameUiTextEntryGetExtents](/reference/system/xgameui/functions/xgameuitextentrygetextents.md)
- [XGameUiTextEntryExtents](/reference/system/xgameui/structs/xgameuitextentryextents.md)