| -api-id | -api-type |
|---|---|
M:Microsoft.UI.Text.ITextRange.GetCharacterUtf32(System.UInt32@,System.Int32) |
winrt method |
Retrieves the Unicode Transformation Format (UTF)-32 character code of the character at the specified offset from the end of the text range.
The character value.
The offset from the end of the text range.
| If offset is | The method returns this character |
|---|---|
| 0 | The character at the end of the range |
| in the middle of a surrogate pair | The corresponding UTF-32 character |
This method differs from ITextRange.Character in the following ways:
- It returns the Unicode Transformation Format (UTF)-32 character code for a Unicode Transformation Format (UTF)-16 surrogate pair instead of the pair's lead code (see Sections 3.8 and 3.9 and Table 3-5 in The Unicode Standard for explanations of this notation).
- It gets the code for the character at the specified offset from the end of the text range instead of the character at the start of the range.
If you try to retrieve a character that is before the start of the story or at the end of the story, value is set to the character code 0.
If offset is 0, this method retrieves the character at the end of the range.
If offset is in the middle of a surrogate pair, this method retrieves the corresponding Unicode Transformation Format (UTF)-32 character.