org.eclipse.swt.internal

Class BidiUtil

java.lang.Object

org.eclipse.swt.internal.BidiUtil

public class BidiUtil
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static int	CLASS_ARABIC
static int	CLASS_HEBREW
static int	CLASS_LATINNUMBER
static int	CLASS_LOCALNUMBER
static int	CLASSIN
static int	GLYPHSHAPE
static int	KEYBOARD_BIDI
static int	KEYBOARD_NON_BIDI
static int	LIGATE
static int	LINKAFTER
static int	LINKBEFORE
static int	REORDER

Constructor Summary

Constructors

Constructor and Description
BidiUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addLanguageListener(Control control, java.lang.Runnable runnable)
static void	addLanguageListener(int hwnd, java.lang.Runnable runnable) Adds a language listener.
static void	drawGlyphs(GC gc, char[] renderBuffer, int[] renderDx, int x, int y) Wraps the ExtTextOut function.
static int	getFontBidiAttributes(GC gc) Return bidi attribute information for the font in the specified gc.
static int	getKeyboardLanguage() Return the active keyboard language type.
static void	getOrderInfo(GC gc, java.lang.String text, int[] order, byte[] classBuffer, int flags, int[] offsets) Return bidi ordering information for the given text.
static char[]	getRenderInfo(GC gc, java.lang.String text, int[] order, byte[] classBuffer, int[] dx, int flags, int[] offsets) Return ordering and rendering information for the given text.
static boolean	isBidiPlatform() Return whether or not the platform supports a bidi language.
static boolean	isKeyboardBidi() Return whether or not the keyboard supports input of a bidi language.
static void	removeLanguageListener(Control control)
static void	removeLanguageListener(int hwnd) Removes the specified language listener.
static void	setKeyboardLanguage(int language) Switch the keyboard language to the specified language type.
static boolean	setOrientation(Control control, int orientation)
static boolean	setOrientation(int hwnd, int orientation) Sets the orientation (writing order) of the specified control.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

KEYBOARD_NON_BIDI

public static final int KEYBOARD_NON_BIDI

See Also:

Constant Field Values

KEYBOARD_BIDI

public static final int KEYBOARD_BIDI

See Also:

Constant Field Values

CLASSIN

public static final int CLASSIN

See Also:

Constant Field Values

LINKBEFORE

public static final int LINKBEFORE

See Also:

Constant Field Values

LINKAFTER

public static final int LINKAFTER

See Also:

Constant Field Values

CLASS_HEBREW

public static final int CLASS_HEBREW

See Also:

Constant Field Values

CLASS_ARABIC

public static final int CLASS_ARABIC

See Also:

Constant Field Values

CLASS_LOCALNUMBER

public static final int CLASS_LOCALNUMBER

See Also:

Constant Field Values

CLASS_LATINNUMBER

public static final int CLASS_LATINNUMBER

See Also:

Constant Field Values

REORDER

public static final int REORDER

See Also:

Constant Field Values

LIGATE

public static final int LIGATE

See Also:

Constant Field Values

GLYPHSHAPE

public static final int GLYPHSHAPE

See Also:

Constant Field Values

Constructor Detail

BidiUtil

public BidiUtil()

Method Detail

addLanguageListener

public static void addLanguageListener(int hwnd,
                       java.lang.Runnable runnable)

Adds a language listener. The listener will get notified when the language of the keyboard changes (via Alt-Shift on Win platforms). Do this by creating a window proc for the Control so that the window messages for the Control can be monitored.

Parameters:

hwnd - the handle of the Control that is listening for keyboard language changes

runnable - the code that should be executed when a keyboard language change occurs

addLanguageListener

public static void addLanguageListener(Control control,
                       java.lang.Runnable runnable)

drawGlyphs

public static void drawGlyphs(GC gc,
              char[] renderBuffer,
              int[] renderDx,
              int x,
              int y)

Wraps the ExtTextOut function.

Parameters:

gc - the gc to use for rendering

renderBuffer - the glyphs to render as an array of characters

renderDx - the width of each glyph in renderBuffer

x - x position to start rendering

y - y position to start rendering

getRenderInfo

public static char[] getRenderInfo(GC gc,
                   java.lang.String text,
                   int[] order,
                   byte[] classBuffer,
                   int[] dx,
                   int flags,
                   int[] offsets)

Return ordering and rendering information for the given text. Wraps the GetFontLanguageInfo and GetCharacterPlacement functions.

Parameters:

gc - the GC to use for measuring of this line, input parameter

text - text that bidi data should be calculated for, input parameter

order - an array of integers representing the visual position of each character in the text array, output parameter

classBuffer - an array of integers representing the type (e.g., ARABIC, HEBREW, LOCALNUMBER) of each character in the text array, input/output parameter

dx - an array of integers representing the pixel width of each glyph in the returned glyph buffer, output parameter

flags - an integer representing rendering flag information, input parameter

offsets - text segments that should be measured and reordered separately, input parameter. See org.eclipse.swt.custom.BidiSegmentEvent for details.

Returns:

buffer with the glyphs that should be rendered for the given text

getOrderInfo

public static void getOrderInfo(GC gc,
                java.lang.String text,
                int[] order,
                byte[] classBuffer,
                int flags,
                int[] offsets)

Return bidi ordering information for the given text. Does not return rendering information (e.g., glyphs, glyph distances). Use this method when you only need ordering information. Doing so will improve performance. Wraps the GetFontLanguageInfo and GetCharacterPlacement functions.

Parameters:

gc - the GC to use for measuring of this line, input parameter

text - text that bidi data should be calculated for, input parameter

order - an array of integers representing the visual position of each character in the text array, output parameter

classBuffer - an array of integers representing the type (e.g., ARABIC, HEBREW, LOCALNUMBER) of each character in the text array, input/output parameter

flags - an integer representing rendering flag information, input parameter

offsets - text segments that should be measured and reordered separately, input parameter. See org.eclipse.swt.custom.BidiSegmentEvent for details.

getFontBidiAttributes

public static int getFontBidiAttributes(GC gc)

Return bidi attribute information for the font in the specified gc.

Parameters:

gc - the gc to query

Returns:

bitwise OR of the REORDER, LIGATE and GLYPHSHAPE flags defined by this class.

getKeyboardLanguage

public static int getKeyboardLanguage()

Return the active keyboard language type.

Returns:

an integer representing the active keyboard language (KEYBOARD_BIDI, KEYBOARD_NON_BIDI)

isBidiPlatform

public static boolean isBidiPlatform()

Return whether or not the platform supports a bidi language. Determine this by looking at the languages that are installed.

Returns:

true if bidi is supported, false otherwise. Always false on Windows CE.

isKeyboardBidi

public static boolean isKeyboardBidi()

Return whether or not the keyboard supports input of a bidi language. Determine this by looking at the languages that are installed for the keyboard.

Returns:

true if bidi is supported, false otherwise.

removeLanguageListener

public static void removeLanguageListener(int hwnd)

Removes the specified language listener.

Parameters:

hwnd - the handle of the Control that is listening for keyboard language changes

removeLanguageListener

public static void removeLanguageListener(Control control)

setKeyboardLanguage

public static void setKeyboardLanguage(int language)

Switch the keyboard language to the specified language type. We do not distinguish between multiple bidi or multiple non-bidi languages, so set the keyboard to the first language of the given type.

Parameters:

language - integer representing language. One of KEYBOARD_BIDI, KEYBOARD_NON_BIDI.

setOrientation

public static boolean setOrientation(int hwnd,
                     int orientation)

Sets the orientation (writing order) of the specified control. Text will be right aligned for right to left writing order.

Parameters:

hwnd - the handle of the Control to change the orientation of

orientation - one of SWT.RIGHT_TO_LEFT or SWT.LEFT_TO_RIGHT

Returns:

true if the orientation was changed, false if the orientation could not be changed

setOrientation

public static boolean setOrientation(Control control,
                     int orientation)