Predefined Properties
The following values identify TSF-defined properties. The data format and contents of each property type are included.
Properties
| Property | Description |
|---|---|
| GUID_PROP_ATTRIBUTE | Contains a TfGuidAtom value that represents the GUID of the display attribute. ITfCategoryMgr::GetGUID is used to convert this value into a GUID. For more information, see Using Display Attributes. |
| GUID_PROP_TEXTOWNER | Contains a TfGuidAtom value that represents the class identifier ( CLSID ) of the text service that owns the text. ITfCategoryMgr::GetGUID is used to convert this value into a CLSID. |
| GUID_PROP_LANGID | Contains a DWORD value that contains the language identifier ( LANGID ) of the text in the low word. |
| GUID_PROP_READING | Contains the phonetic reading text for the text covered by the property. This can be different from the actual text. Windows Store apps don't support this property. |
| GUID_PROP_COMPOSING | Contains a Boolean value that is nonzero if the text is part of a composition or zero otherwise. If this property is VT_EMPTY, it can be assumed that the text is not part of a composition. |
| GUID_PROP_MODEBIAS | Contains a TfGuidAtom value that represents the type of mode bias supported. ITfCategoryMgr::GetGUID is used to convert this value into a GUID. This can be one of the mode bias values. |
| GUID_PROP_LMLATTICE | Contains a pointer to an ITfLMLattice object. |
| GUID_PROP_TKB_ALTERNATES | Starting with Windows 8: Contains a DWORD value set by the touch keyboard. This property can be used by TSF-aware edit controls and apps to identify the nature of the text in the text range covered by the property, for example, if the text in the range results from the insertion of a text suggestion or autocorrection. The nature of the text in the text range covered by the property also extends to the type of alternates that would be returned by the ITfFnReconversion interface for that text range in the document. See the following Remarks for the possible values of this property. |
| GUID_PROP_URL | Contains a BSTR value representing the URL of the text control source, where applicable. |
Remarks
The GUID_PROP_TKB_ALTERNATES property can be one of the following values.
| Name | Value | Description |
|---|---|---|
| TKB_ALTERNATES_STANDARD | 0x00000001 | Indicates that the touch keyboard has generated a list of possible alternate words for the text in the range covered by the property, and that neither the text range nor the alternates are an autocorrection or a text suggestion. |
| TKB_ALTERNATES_FOR_AUTOCORRECTION | 0x00000002 | Indicates that the touch keyboard has generated an alternate word which should automatically replace the text in the text range covered by the property. The touch keyboard will not apply the autocorrection without being instructed to do so by the edit control or app. The reconversion interface (ITfFnReconversion) should be used to apply the correction to the text in the document. |
| TKB_ALTERNATES_FOR_PREDICTION | 0x00000003 | Indicates that the text range covered by the property is a text suggestion that has been generated by the touch keyboard and inserted into the document by the user. Additional alternate predictions can also be stored as a property in the document. |
| TKB_ALTERNATES_AUTOCORRECTION_APPLIED | 0x00000004 | Indicates that the text range covered by the property is an autocorrection provided by the touch keyboard and applied via the ITfFnReconversion interface. This value can be used by edit controls or apps, with TKB_ALTERNATES_FOR_AUTOCORRECTION, to prevent the repeated application of an autocorrection. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Redistributable |
TSF 1.0 on Windows 2000 Professional |
| Header |
|
| IDL |
|