ITextServices::OnTxPropertyBitsChange method (textserv.h)
Sets properties (represented by bits) for the control.
Syntax
HRESULT OnTxPropertyBitsChange(
[in] DWORD dwMask,
[in] DWORD dwBits
);
Parameters
[in] dwMask
Type: DWORD
Bits representing properties to be changed. For the possible bit values, see the TXTBIT_* values list in dwBits.
[in] dwBits
Type: DWORD
New values for bit properties. It can be any combination of the following.
| Value | Meaning |
|---|---|
|
If TRUE, beeping is enabled. |
|
If TRUE, the AutoWordSelect feature is enabled. |
|
If TRUE, the backstyle changed. See TxGetBackStyle. |
|
If TRUE, the character format changed. |
|
If TRUE, the client rectangle changed. |
|
If TRUE, dragging is disabled. |
|
Use Direct2D/DirectWrite for this instance, and not GDI/Uniscribe. |
|
Render glyphs to the nearest pixel positions. Valid only if D2DDWRITE is set. |
|
Draw lines with subpixel precision. Don't pixel-snap text lines, underline, and strikethrough in the secondary text flow direction (usually vertical). Valid only if D2DDWRITE is set and D2DPIXELSNAPPED is not set. |
|
Render text using simple typography (no glyph rendering). This value is valid only if TXTBIT_D2DDWRITE is also specified. |
|
If TRUE, the size of the client rectangle changed. |
|
If TRUE, the text services object should hide the selection when the control is inactive. If FALSE, the selection should be displayed when the control is inactive.
Note, this implies TXTBIT_SAVESELECTION is TRUE. |
|
If TRUE, the maximum length for text in the control changed. |
|
If TRUE, the text services object should work in multiline mode. Use the TXTBIT_WORDWRAP value to determine whether to wrap the lines to the view rectangle or clip them.
If FALSE, the text services object should not process a carriage return/line feed from the ENTER key and it should truncate incoming text containing hard line breaks just before the first line break. It is also acceptable to truncate text that is set with ITextServices::TxSetText, because it is the responsibility of the host not to use a single-line control when bound to a multiline field. |
|
Don't reference TLS data on behalf of this instance. |
|
If TRUE, the paragraph format changed. |
|
If TRUE, the text services object should not accept any editing change through the user interface. However, it should still accept programmatic changes through EM_SETTEXTEX, EM_REPLACESEL, and ITextServices::TxSetText. Also, the user should still be able to move the insertion point, select text, and carry out other operations that don't modify content, such as Copy. |
|
If TRUE, the text services object should be in rich-text mode.
If FALSE, it is in plain-text mode. Note, this affects how editing commands are applied. For example, applying bold to part of the text in a plain-edit control makes the entire text bold. However, for a rich-edit control, this makes only the selected text bold. |
|
If TRUE, the boundaries of the selection should be saved when the control is inactive.
If FALSE, when the control goes active again the selection boundaries can be reset to start = 0, length = 0. |
|
If TRUE, the scroll bar has changed. |
|
If TRUE, the selection bar width has changed |
|
If set, the accelerator character should be underlined.
This must be set in order to call TxGetAcceleratorPos. |
|
Show password strings. |
|
Not supported. |
|
If TRUE, display text using the password character obtained by TxGetPasswordChar.
The notification on this property can mean either that the password character changed or that the password character was not used before but is used now (or vice versa). |
|
Not supported. |
|
If TRUE, the inset changed. |
|
If TRUE and TXTBIT_MULTILINE is also TRUE, multiline controls should wrap the line to the view rectangle. If this property is FALSE and TXTBIT_MULTILINE is TRUE, the lines should not be wrapped but clipped. The right side of the view rectangle should be ignored.
If TXTBIT_MULTILINE is FALSE, this property has no effect. |
Return value
Type: HRESULT
If the method succeeds, the return value is S_OK.
If the method fails, the return value is the following HRESULT code. For more information on COM error codes, see Error Handling in COM.
| Return code | Description |
|---|---|
|
Not implemented. |
Remarks
The client rectangle is the rectangle that the text services object is responsible for painting and managing. The host relies on the text services object for painting that area. The text services object must not paint or invalidate areas outside of that rectangle. In addition, the host will forward mouse messages to the text services object when the cursor is over this rectangle. This rectangle is expressed in client coordinates of the containing window.
The view inset is the amount of space on each side between the client rectangle and the view rectangle. The view rectangle (also called the Formatting rectangle) is the rectangle in which the text should be formatted. For more information, see TxGetViewInset.
The backstyle is the style of the background of the client rectangle. It can be either TXTBACK_TRANSPARENT or TXTBACK_SOLID. See TXTBACKSTYLE.
The scroll bar property indicates changes to the scroll bar: which scroll bar is present, whether scroll bars are hidden or disabled when scrolling is impossible, and also if auto-scrolling is enabled when the insertion point gets off the client rectangle.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | textserv.h |
| DLL | Msftedit.dll |
See also
Conceptual
Other Resources
Reference