BIDIOPTIONS structure (richedit.h)

Contains bidirectional information about a rich edit control. This structure is used by the EM_GETBIDIOPTIONS and EM_SETBIDIOPTIONS messages to get and set the bidirectional information for a control.

Syntax

typedef struct _bidioptions {
  UINT cbSize;
  WORD wMask;
  WORD wEffects;
} BIDIOPTIONS;

Members

cbSize

Type: UINT

Specifies the size, in bytes, of the structure. Before passing this structure to a rich edit control, set cbSize to the size of the BIDIOPTIONS structure. The rich edit control checks the size of cbSize before sending an EM_GETBIDIOPTIONS message.

wMask

Type: WORD

A set of mask bits that determine which of the wEffects flags will be set to 1 or 0 by the rich edit control. This approach eliminates the need to read the effects flags before changing them.

Obsolete bits are valid only for the bidirectional version of Rich Edit 1.0.

Value Meaning
BOM_CONTEXTALIGNMENT
The BOE_CONTEXTALIGNMENT value is valid.
BOM_CONTEXTREADING
The BOE_CONTEXTREADING value is valid.
BOM_DEFPARADIR
The BOE_RTLDIR value is valid.
BOM_LEGACYBIDICLASS
The BOE_LEGACYBIDICLASS value is valid.
BOM_NEUTRALOVERRIDE
The BOE_NEUTRALOVERRIDE value is valid.
BOM_PLAINTEXT
The BOE_PLAINTEXT value is valid. (obsolete).
BOM_UNICODEBIDI
The BOE_UNICODEBIDI value is valid.

wEffects

Type: WORD

A set of flags that indicate the desired or current state of the effects flags. Obsolete bits are valid only for the bidirectional version of Rich Edit 1.0.

Obsolete bits are valid only for the bidirectional version of Rich Edit 1.0.

Value Meaning
BOE_CONTEXTALIGNMENT
If this flag is 1, context paragraph alignment is active. This feature is used only for plain-text controls. When active, the paragraph alignment is set to PFA_LEFT if the first strongly directional character is LTR, or PFA_RIGHT if the first strongly directional character is RTL. If the control has no strongly directional character, the alignment is chosen according to the directionality of the keyboard language when the control regains focus (default: 0).
BOE_CONTEXTREADING
If this flag is 1, context paragraph directionality is active. This feature is used only for plain-text controls. When active, the paragraph directionality effect PFE_RTLPARA is set to 0 if the first strongly directional character is LTR, or 1 if the first strongly directional character is RTL. If the control has no strongly directional character, the directionality is chosen according to the directionality of

the keyboard language when the control regains focus (default: 0).

BOE_FORCERECALC
Windows 8: Force the rich edit control to recalculate the bidirectional information, and then redraw the control.
BOE_LEGACYBIDICLASS
Causes the plus and minus characters to be treated as neutral characters with no implied direction. Also causes the slash character to be treated as a common separator.
BOE_NEUTRALOVERRIDE
If this flag is 1, the characters !"#&'()*+,-./:;<=> are treated as strong LTR characters (default: 0).
BOE_PLAINTEXT
Uses plain text layout (obsolete).
BOE_RTLDIR
Default paragraph direction—implies alignment (obsolete).
BOE_UNICODEBIDI
If this flag is 1, the Unicode Bidi Algorithm (UBA) is used for rich-text controls. The UBA is always used for plain-text controls (default: 0).

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header richedit.h
Redistributable Rich Edit 3.0

See also

EM_GETBIDIOPTIONS

EM_SETBIDIOPTIONS