Movatterモバイル変換

ParagraphLayout.More...

#include <ParagraphLayout.h>

Inheritance diagram for icu::ParagraphLayout:

Data Structures
class	Line
	This class represents a single line of text in a`ParagraphLayout`.More...

class	VisualRun
	This object represents a single visual run in a line of text in a paragraph.More...

Public Member Functions
	ParagraphLayout (const LEUnicode chars[], le_int32 count, constFontRuns fontRuns, constValueRuns levelRuns, constValueRuns scriptRuns, constLocaleRuns localeRuns,UBiDiLevel paragraphLevel, le_bool vertical, LEErrorCode &status)
	Construct a`ParagraphLayout` object for a styled paragraph.More...

	~ParagraphLayout ()
	The destructor.More...

UBiDiLevel	getParagraphLevel ()
	Return the resolved paragraph level.More...

UBiDiDirection	getTextDirection ()
	Return the directionality of the text in the paragraph.More...

virtual le_int32	getAscent () const
	Return the max ascent value for all the fonts in the paragraph.More...

virtual le_int32	getDescent () const
	Return the max descent value for all the fonts in the paragraph.More...

virtual le_int32	getLeading () const
	Return the max leading value for all the fonts in the paragraph.More...

void	reflow ()
	Reset line breaking to start from the beginning of the paragraph.More...

le_bool	isDone () const
	Convenience method for determining if paragraph layout processing is complete ( i.e.More...

Line *	nextLine (float width)
	Return a`ParagraphLayout::Line` object which represents next line in the paragraph.More...

UClassID	getDynamicClassID () const override
	ICU "poor man's RTTI", returns a UClassID for the actual class.More...

Public Member Functions inherited fromicu::UObject
virtual	~UObject ()
	Destructor.More...

Static Public Member Functions
static le_bool	isComplex (const LEUnicode chars[], le_int32 count)
	Examine the given text and determine if it contains characters in any script which requires complex processing to be rendered correctly.More...

staticUClassID	getStaticClassID ()
	ICU "poor man's RTTI", returns a UClassID for this class.More...

Detailed Description

ParagraphLayout.

TheParagraphLayout object will analyze the text into runs of text in the same font, script and direction, and will create aLayoutEngine object for each run. TheLayoutEngine will transform the characters into glyph codes in visual order.

Clients can use this to break a paragraph into lines, and to display the glyphs in each line.

Note that the ICU layout engine has been deprecated and removed. You may use this class with the HarfBuzz icu-le-hb wrapper, seehttp://www.freedesktop.org/wiki/Software/HarfBuzz/

Seehttps://unicode-org.github.io/icu/userguide/layoutengine for special build instructions.

Definition at line51 of fileParagraphLayout.h.

Constructor & Destructor Documentation

◆ ParagraphLayout()

icu::ParagraphLayout::ParagraphLayout	(	const LEUnicode	chars[],
		le_int32	count,
		constFontRuns *	fontRuns,
		constValueRuns *	levelRuns,
		constValueRuns *	scriptRuns,
		constLocaleRuns *	localeRuns,
		UBiDiLevel	paragraphLevel,
		le_bool	vertical,
		LEErrorCode &	status
	)

Construct aParagraphLayout object for a styled paragraph.

The paragraph is specified as runs of text all in the same font. AnLEFontInstance object and a limit offset are specified for each font run. The limit offset is the offset of the character immediately after the font run.

Clients can optionally specify directional runs and / or script runs. If these aren't specified they will be computed.

If any errors are encountered during construction,status will be set, and the object will be set to be empty.

Parameters

chars	is an array of the characters in the paragraph
count	is the number of characters in the paragraph.
fontRuns	a pointer to a`FontRuns` object representing the font runs.
levelRuns	is a pointer to a`ValueRuns` object representing the directional levels. If this pointer in`nullptr` the levels will be determined by running the Unicode Bidi algorithm.
scriptRuns	is a pointer to a`ValueRuns` object representing script runs. If this pointer in`nullptr` the script runs will be determined using the Unicode code points.
localeRuns	is a pointer to a`LocaleRuns` object representing locale runs. The`Locale` objects are used to determine the language of the text. If this pointer is`nullptr` the default locale will be used for all of the text.
paragraphLevel	is the directionality of the paragraph, as in the UBiDi object.
vertical	is`true` if the paragraph should be set vertically.
status	will be set to any error code encountered during construction.

See also: ubidi.h; LEFontInstance.h; LayoutEngine.h; RunArrays.h

Stable:: ICU 2.8

◆ ~ParagraphLayout()

icu::ParagraphLayout::~ParagraphLayout

(

)

The destructor.

Virtual so that it works correctly with subclasses.

Stable:: ICU 3.2

Member Function Documentation

◆ getAscent()

virtual le_int32 icu::ParagraphLayout::getAscent

(

)

const

virtual

Return the max ascent value for all the fonts in the paragraph.

Returns: the ascent value.

Stable:: ICU 3.2

◆ getDescent()

virtual le_int32 icu::ParagraphLayout::getDescent

(

)

const

virtual

Return the max descent value for all the fonts in the paragraph.

Returns: the decent value.

Stable:: ICU 3.2

◆ getDynamicClassID()

UClassID icu::ParagraphLayout::getDynamicClassID

(

)

const

inlineoverridevirtual

ICU "poor man's RTTI", returns a UClassID for the actual class.

Stable:: ICU 3.2

Reimplemented fromicu::UObject.

Definition at line553 of fileParagraphLayout.h.

◆ getLeading()

virtual le_int32 icu::ParagraphLayout::getLeading

(

)

const

virtual

Return the max leading value for all the fonts in the paragraph.

Returns: the leading value.

Stable:: ICU 3.2

◆ getParagraphLevel()

UBiDiLevel icu::ParagraphLayout::getParagraphLevel

(

)

inline

Return the resolved paragraph level.

This is useful for those cases where the bidi analysis has determined the level based on the first strong character in the paragraph.

Returns: the resolved paragraph level.

Stable:: ICU 3.2

Definition at line648 of fileParagraphLayout.h.

Referencesubidi_getParaLevel().

◆ getStaticClassID()

staticUClassID icu::ParagraphLayout::getStaticClassID

(

)

inlinestatic

ICU "poor man's RTTI", returns a UClassID for this class.

Stable:: ICU 3.2

Definition at line546 of fileParagraphLayout.h.

◆ getTextDirection()

UBiDiDirection icu::ParagraphLayout::getTextDirection

(

)

inline

Return the directionality of the text in the paragraph.

Returns: UBIDI_LTR if the text is all left to right,UBIDI_RTL if the text is all right to left, orUBIDI_MIXED if the text has mixed direction.

Stable:: ICU 3.2

Definition at line653 of fileParagraphLayout.h.

Referencesubidi_getDirection().

◆ isComplex()

static le_bool icu::ParagraphLayout::isComplex	(	const LEUnicode	chars[],
		le_int32	count
	)

static

Examine the given text and determine if it contains characters in any script which requires complex processing to be rendered correctly.

Parameters

chars	is an array of the characters in the paragraph
count	is the number of characters in the paragraph.

Returns: true if any of the text requires complex processing.

Stable:: ICU 3.2

◆ isDone()

le_bool icu::ParagraphLayout::isDone

(

)

const

inline

Convenience method for determining if paragraph layout processing is complete ( i.e.

there are no more lines left to process. )

Returns: true if there are no more lines to be processed

Internal:: Do not use. This API is for internal use only.

◆ nextLine()

Line* icu::ParagraphLayout::nextLine

(

float

width

)

Return aParagraphLayout::Line object which represents next line in the paragraph.

The width of the line is specified each time so that it can be varied to support arbitrary paragraph shapes.

Parameters

width is the width of the line. Ifwidth is less than or equal to zero, aParagraphLayout::Line object representing the rest of the paragraph will be returned.

Returns: aParagraphLayout::Line object which represents the line. The caller is responsible for deleting the object. Returnsnullptr if there are no more lines in the paragraph.

See also: ParagraphLayout::Line

Stable:: ICU 3.2

◆ reflow()

void icu::ParagraphLayout::reflow

(

)

inline

Reset line breaking to start from the beginning of the paragraph.

Stable:: ICU 3.2

Definition at line658 of fileParagraphLayout.h.

The documentation for this class was generated from the following file:

layoutex/layout/ParagraphLayout.h

Movatterモバイル変換

Data Structures

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ParagraphLayout()

◆ ~ParagraphLayout()

Member Function Documentation

◆ getAscent()

◆ getDescent()

◆ getDynamicClassID()

◆ getLeading()

◆ getParagraphLevel()

◆ getStaticClassID()

◆ getTextDirection()

◆ isComplex()

◆ isDone()

◆ nextLine()

◆ reflow()