Language

BoringLayout.ReplaceOrMake Method

Definition

Overloads

Name Description
ReplaceOrMake(ICharSequence, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

ReplaceOrMake(String, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

ReplaceOrMake(ICharSequence, TextPaint, Int32, Layout+Alignment, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32, Boolean)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

ReplaceOrMake(String, TextPaint, Int32, Layout+Alignment, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32, Boolean)

Reinitializes this single-line layout with replacement text and layout options.

ReplaceOrMake(ICharSequence, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

ReplaceOrMake(String, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

ReplaceOrMake(ICharSequence, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

[Android.Runtime.Register("replaceOrMake", "(Ljava/lang/CharSequence;Landroid/text/TextPaint;ILandroid/text/Layout$Alignment;FFLandroid/text/BoringLayout$Metrics;Z)Landroid/text/BoringLayout;", "GetReplaceOrMake_Ljava_lang_CharSequence_Landroid_text_TextPaint_ILandroid_text_Layout_Alignment_FFLandroid_text_BoringLayout_Metrics_ZHandler")]
public virtual Android.Text.BoringLayout? ReplaceOrMake(Java.Lang.ICharSequence? source, Android.Text.TextPaint? paint, int outerwidth, Android.Text.Layout.Alignment? align, float spacingMult, float spacingAdd, Android.Text.BoringLayout.Metrics? metrics, bool includePad);
[<Android.Runtime.Register("replaceOrMake", "(Ljava/lang/CharSequence;Landroid/text/TextPaint;ILandroid/text/Layout$Alignment;FFLandroid/text/BoringLayout$Metrics;Z)Landroid/text/BoringLayout;", "GetReplaceOrMake_Ljava_lang_CharSequence_Landroid_text_TextPaint_ILandroid_text_Layout_Alignment_FFLandroid_text_BoringLayout_Metrics_ZHandler")>]
abstract member ReplaceOrMake : Java.Lang.ICharSequence * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * single * single * Android.Text.BoringLayout.Metrics * bool -> Android.Text.BoringLayout
override this.ReplaceOrMake : Java.Lang.ICharSequence * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * single * single * Android.Text.BoringLayout.Metrics * bool -> Android.Text.BoringLayout

Parameters

source
ICharSequence

the text to render

paint
TextPaint

the default paint for the layout

outerwidth
Int32

the wrapping width for the text

align
Layout.Alignment

whether to left, right, or center the text

spacingMult
Single

this value is no longer used by BoringLayout

spacingAdd
Single

this value is no longer used by BoringLayout

metrics
BoringLayout.Metrics

#Metrics instance that contains information about FontMetrics and line width

includePad
Boolean

set whether to include extra space beyond font ascent and descent which is needed to avoid clipping in some scripts

Returns

This layout after its text and options have been replaced.

Attributes

Remarks

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable. The caller must make sure that no one is still using this Layout.

Android reference for android.text.BoringLayout.replaceOrMake.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

ReplaceOrMake(String, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

public Android.Text.BoringLayout? ReplaceOrMake(string? source, Android.Text.TextPaint? paint, int outerwidth, Android.Text.Layout.Alignment? align, float spacingMult, float spacingAdd, Android.Text.BoringLayout.Metrics? metrics, bool includePad);
member this.ReplaceOrMake : string * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * single * single * Android.Text.BoringLayout.Metrics * bool -> Android.Text.BoringLayout

Parameters

source
String

the text to render

paint
TextPaint

the default paint for the layout

outerwidth
Int32

the wrapping width for the text

align
Layout.Alignment

whether to left, right, or center the text

spacingMult
Single

this value is no longer used by BoringLayout

spacingAdd
Single

this value is no longer used by BoringLayout

metrics
BoringLayout.Metrics

#Metrics instance that contains information about FontMetrics and line width

includePad
Boolean

set whether to include extra space beyond font ascent and descent which is needed to avoid clipping in some scripts

Returns

This layout after its text and options have been replaced.

Remarks

Java documentation for android.text.BoringLayout.replaceOrMake(java.lang.CharSequence, android.text.TextPaint, int, android.text.Alignment, float, float, android.text.Metrics, boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

ReplaceOrMake(ICharSequence, TextPaint, Int32, Layout+Alignment, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32, Boolean)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

[Android.Runtime.Register("replaceOrMake", "(Ljava/lang/CharSequence;Landroid/text/TextPaint;ILandroid/text/Layout$Alignment;Landroid/text/BoringLayout$Metrics;ZLandroid/text/TextUtils$TruncateAt;IZ)Landroid/text/BoringLayout;", "GetReplaceOrMake_Ljava_lang_CharSequence_Landroid_text_TextPaint_ILandroid_text_Layout_Alignment_Landroid_text_BoringLayout_Metrics_ZLandroid_text_TextUtils_TruncateAt_IZHandler", ApiSince=33)]
public virtual Android.Text.BoringLayout ReplaceOrMake(Java.Lang.ICharSequence source, Android.Text.TextPaint paint, int outerWidth, Android.Text.Layout.Alignment align, Android.Text.BoringLayout.Metrics metrics, bool includePad, Android.Text.TextUtils.TruncateAt? ellipsize, int ellipsizedWidth, bool useFallbackLineSpacing);
[<Android.Runtime.Register("replaceOrMake", "(Ljava/lang/CharSequence;Landroid/text/TextPaint;ILandroid/text/Layout$Alignment;Landroid/text/BoringLayout$Metrics;ZLandroid/text/TextUtils$TruncateAt;IZ)Landroid/text/BoringLayout;", "GetReplaceOrMake_Ljava_lang_CharSequence_Landroid_text_TextPaint_ILandroid_text_Layout_Alignment_Landroid_text_BoringLayout_Metrics_ZLandroid_text_TextUtils_TruncateAt_IZHandler", ApiSince=33)>]
abstract member ReplaceOrMake : Java.Lang.ICharSequence * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * Android.Text.BoringLayout.Metrics * bool * Android.Text.TextUtils.TruncateAt * int * bool -> Android.Text.BoringLayout
override this.ReplaceOrMake : Java.Lang.ICharSequence * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * Android.Text.BoringLayout.Metrics * bool * Android.Text.TextUtils.TruncateAt * int * bool -> Android.Text.BoringLayout

Parameters

source
ICharSequence

the text to render. This value cannot be null.

paint
TextPaint

the default paint for the layout. This value cannot be null.

outerWidth
Int32

the wrapping width for the text. Value is 0 or greater

align
Layout.Alignment

whether to left, right, or center the text. This value cannot be null.

metrics
BoringLayout.Metrics

Metrics instance that contains information about FontMetrics and line width. This value cannot be null.

includePad
Boolean

set whether to include extra space beyond font ascent and descent which is needed to avoid clipping in some scripts

ellipsize
TextUtils.TruncateAt

whether to ellipsize the text if width of the text is longer than the requested width. null if ellipsis not applied.

ellipsizedWidth
Int32

the width to which this Layout is ellipsizing. If ellipsize is null, or is TextUtils.TruncateAt.MARQUEE this value is not used, outerWidth is used instead. Value is 0 or greater

useFallbackLineSpacing
Boolean

True for adjusting the line spacing based on fallback fonts. False for keeping the first font's line height. If some glyphs requires larger vertical spaces, by passing true to this argument, the layout increase the line height to fit all glyphs.

Returns

This layout after its text and options have been replaced.

Attributes

Remarks

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable. The caller must make sure that no one is still using this Layout. The spacing multiplier and additional amount spacing are not used by BoringLayout. Layout.getSpacingMultiplier() will return 1.0 and Layout.getSpacingAdd() will return 0.0.

Android reference for android.text.BoringLayout.replaceOrMake.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

ReplaceOrMake(String, TextPaint, Int32, Layout+Alignment, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32, Boolean)

Reinitializes this single-line layout with replacement text and layout options.

public Android.Text.BoringLayout ReplaceOrMake(string source, Android.Text.TextPaint paint, int outerWidth, Android.Text.Layout.Alignment align, Android.Text.BoringLayout.Metrics metrics, bool includePad, Android.Text.TextUtils.TruncateAt? ellipsize, int ellipsizedWidth, bool useFallbackLineSpacing);
member this.ReplaceOrMake : string * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * Android.Text.BoringLayout.Metrics * bool * Android.Text.TextUtils.TruncateAt * int * bool -> Android.Text.BoringLayout

Parameters

source
String

The replacement text to lay out on a single line.

paint
TextPaint

The paint used to measure and draw the replacement text.

outerWidth
Int32

The new layout width in pixels.

align
Layout.Alignment

The paragraph alignment within the layout.

metrics
BoringLayout.Metrics

The font metrics and width measured for the replacement text.

includePad
Boolean

Whether to include extra font padding above and below the text.

ellipsize
TextUtils.TruncateAt

The requested ellipsis mode, or null to disable ellipsis.

ellipsizedWidth
Int32

The width in pixels available for ellipsis; ignored when ellipsis is disabled or marquee is selected.

useFallbackLineSpacing
Boolean

Whether fallback-font metrics can increase the line height.

Returns

This layout after its text and options have been replaced.

Remarks

The existing layout is updated in place; references to it observe the new text and settings.

Applies to

ReplaceOrMake(ICharSequence, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

[Android.Runtime.Register("replaceOrMake", "(Ljava/lang/CharSequence;Landroid/text/TextPaint;ILandroid/text/Layout$Alignment;FFLandroid/text/BoringLayout$Metrics;ZLandroid/text/TextUtils$TruncateAt;I)Landroid/text/BoringLayout;", "GetReplaceOrMake_Ljava_lang_CharSequence_Landroid_text_TextPaint_ILandroid_text_Layout_Alignment_FFLandroid_text_BoringLayout_Metrics_ZLandroid_text_TextUtils_TruncateAt_IHandler")]
public virtual Android.Text.BoringLayout? ReplaceOrMake(Java.Lang.ICharSequence? source, Android.Text.TextPaint? paint, int outerWidth, Android.Text.Layout.Alignment? align, float spacingMult, float spacingAdd, Android.Text.BoringLayout.Metrics? metrics, bool includePad, Android.Text.TextUtils.TruncateAt? ellipsize, int ellipsizedWidth);
[<Android.Runtime.Register("replaceOrMake", "(Ljava/lang/CharSequence;Landroid/text/TextPaint;ILandroid/text/Layout$Alignment;FFLandroid/text/BoringLayout$Metrics;ZLandroid/text/TextUtils$TruncateAt;I)Landroid/text/BoringLayout;", "GetReplaceOrMake_Ljava_lang_CharSequence_Landroid_text_TextPaint_ILandroid_text_Layout_Alignment_FFLandroid_text_BoringLayout_Metrics_ZLandroid_text_TextUtils_TruncateAt_IHandler")>]
abstract member ReplaceOrMake : Java.Lang.ICharSequence * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * single * single * Android.Text.BoringLayout.Metrics * bool * Android.Text.TextUtils.TruncateAt * int -> Android.Text.BoringLayout
override this.ReplaceOrMake : Java.Lang.ICharSequence * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * single * single * Android.Text.BoringLayout.Metrics * bool * Android.Text.TextUtils.TruncateAt * int -> Android.Text.BoringLayout

Parameters

source
ICharSequence

the text to render

paint
TextPaint

the default paint for the layout

outerWidth
Int32

the wrapping width for the text

align
Layout.Alignment

whether to left, right, or center the text

spacingMult
Single

this value is no longer used by BoringLayout

spacingAdd
Single

this value is no longer used by BoringLayout

metrics
BoringLayout.Metrics

#Metrics instance that contains information about FontMetrics and line width

includePad
Boolean

set whether to include extra space beyond font ascent and descent which is needed to avoid clipping in some scripts

ellipsize
TextUtils.TruncateAt

whether to ellipsize the text if width of the text is longer than the requested width

ellipsizedWidth
Int32

the width to which this Layout is ellipsizing. If ellipsize is null, or is TextUtils.TruncateAt.MARQUEE this value is not used, outerWidth is used instead

Returns

This layout after its text and options have been replaced.

Attributes

Remarks

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable. The caller must make sure that no one is still using this Layout.

Android reference for android.text.BoringLayout.replaceOrMake.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

ReplaceOrMake(String, TextPaint, Int32, Layout+Alignment, Single, Single, BoringLayout+Metrics, Boolean, TextUtils+TruncateAt, Int32)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

public Android.Text.BoringLayout? ReplaceOrMake(string? source, Android.Text.TextPaint? paint, int outerWidth, Android.Text.Layout.Alignment? align, float spacingMult, float spacingAdd, Android.Text.BoringLayout.Metrics? metrics, bool includePad, Android.Text.TextUtils.TruncateAt? ellipsize, int ellipsizedWidth);
member this.ReplaceOrMake : string * Android.Text.TextPaint * int * Android.Text.Layout.Alignment * single * single * Android.Text.BoringLayout.Metrics * bool * Android.Text.TextUtils.TruncateAt * int -> Android.Text.BoringLayout

Parameters

source
String

the text to render

paint
TextPaint

the default paint for the layout

outerWidth
Int32

The new layout width in pixels.

align
Layout.Alignment

whether to left, right, or center the text

spacingMult
Single

this value is no longer used by BoringLayout

spacingAdd
Single

this value is no longer used by BoringLayout

metrics
BoringLayout.Metrics

#Metrics instance that contains information about FontMetrics and line width

includePad
Boolean

set whether to include extra space beyond font ascent and descent which is needed to avoid clipping in some scripts

ellipsize
TextUtils.TruncateAt

The requested ellipsis mode, or null to disable ellipsis.

ellipsizedWidth
Int32

The width in pixels available for ellipsis; ignored when ellipsis is disabled or marquee is selected.

Returns

This layout after its text and options have been replaced.

Remarks

Java documentation for android.text.BoringLayout.replaceOrMake(java.lang.CharSequence, android.text.TextPaint, int, android.text.Alignment, float, float, android.text.Metrics, boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to