Comment est StaticLayout utilisé dans Android?

StaticLayout (similaire à DynamicLayout et BoringLayout) est utilisé pour la mise en et de dessiner du texte sur une toile. Il est couramment utilisé pour les tâches suivantes:

• Mesure quelle taille de texte multiligne serait après avoir été mis dehors.
• Le dessin du texte sur une image bitmap.
• De prise de vue personnalisée qui gère son propre mise en forme de texte (par opposition à une prise de vue composite avec un intégré à TextView). TextView lui-même utilise une StaticLayout en interne.

La mesure de la taille du texte

Seule ligne

Si vous n'avez qu'une seule ligne de texte, vous pouvez le mesurer avec Paint ou TextPaint.

String text = "This is some text."

TextPaint myTextPaint = new TextPaint();
mTextPaint.setAntiAlias(true);
mTextPaint.setTextSize(16 * getResources().getDisplayMetrics().density);
mTextPaint.setColor(0xFF000000);

float width = mTextPaint.measureText(text);
float height = -mTextPaint.ascent() + mTextPaint.descent();

Multiligne

Cependant, si il y a retour à la ligne et vous avez besoin de la hauteur, alors il est préférable d'utiliser un StaticLayout. Vous fournir la largeur et ensuite, vous pouvez obtenir la hauteur de la StaticLayout.

String text = "This is some text. This is some text. This is some text. This is some text. This is some text. This is some text.";

TextPaint myTextPaint = new TextPaint();
myTextPaint.setAntiAlias(true);
myTextPaint.setTextSize(16 * getResources().getDisplayMetrics().density);
myTextPaint.setColor(0xFF000000);

int width = 200;
Layout.Alignment alignment = Layout.Alignment.ALIGN_NORMAL;
float spacingMultiplier = 1;
float spacingAddition = 0;
boolean includePadding = false;

StaticLayout myStaticLayout = new StaticLayout(text, myTextPaint, width, alignment, spacingMultiplier, spacingAddition, includePadding);

float height = myStaticLayout.getHeight(); 

Nouvelle API

Si vous souhaitez utiliser la plus récente StaticLayout.Builder (disponible à partir de l'API 23), vous pouvez obtenir votre mise en page comme ceci:

StaticLayout.Builder builder = StaticLayout.Builder.obtain(text, 0, text.length(), myTextPaint, width);
StaticLayout myStaticLayout = builder.build();

Vous pouvez fixer sur plus de paramètres à l'aide de la notation point:

StaticLayout.Builder builder = StaticLayout.Builder.obtain(text, 0, text.length(), myTextPaint, width)
        .setAlignment(Layout.Alignment.ALIGN_NORMAL)
        .setLineSpacing(spacingMultiplier, spacingAddition)
        .setIncludePad(includePadding)
        .setMaxLines(5);
StaticLayout myStaticLayout = builder.build();

L'écriture d'un texte sur une image

Je développerai peut-être ce plus dans l'avenir, mais pour l'instant, voir ce post pour un exemple d'une méthode qui utilise StaticLayout et renvoie une image bitmap.

Faire un texte personnalisé de la manipulation de Vue

Voici un exemple d'un affichage personnalisé à l'aide d'un StaticLayout. Il se comporte comme un simple TextView. Lorsque le texte est trop long pour tenir sur l'écran, automatiquement la ligne continue et augmente sa hauteur.

Code

MyView.java

public class MyView extends View {
String mText = "This is some text.";
TextPaint mTextPaint;
StaticLayout mStaticLayout;
//use this constructor if creating MyView programmatically
public MyView(Context context) {
super(context);
initLabelView();
}
//this constructor is used when created from xml
public MyView(Context context, AttributeSet attrs) {
super(context, attrs);
initLabelView();
}
private void initLabelView() {
mTextPaint = new TextPaint();
mTextPaint.setAntiAlias(true);
mTextPaint.setTextSize(16 * getResources().getDisplayMetrics().density);
mTextPaint.setColor(0xFF000000);
//default to a single line of text
int width = (int) mTextPaint.measureText(mText);
mStaticLayout = new StaticLayout(mText, mTextPaint, (int) width, Layout.Alignment.ALIGN_NORMAL, 1.0f, 0, false);
//New API alternate
//
//StaticLayout.Builder builder = StaticLayout.Builder.obtain(mText, 0, mText.length(), mTextPaint, width)
//       .setAlignment(Layout.Alignment.ALIGN_NORMAL)
//       .setLineSpacing(1, 0) //multiplier, add
//       .setIncludePad(false);
//mStaticLayout = builder.build();
}
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
//Tell the parent layout how big this view would like to be
//but still respect any requirements (measure specs) that are passed down.
//determine the width
int width;
int widthMode = MeasureSpec.getMode(widthMeasureSpec);
int widthRequirement = MeasureSpec.getSize(widthMeasureSpec);
if (widthMode == MeasureSpec.EXACTLY) {
width = widthRequirement;
} else {
width = mStaticLayout.getWidth() + getPaddingLeft() + getPaddingRight();
if (widthMode == MeasureSpec.AT_MOST) {
if (width > widthRequirement) {
width = widthRequirement;
//too long for a single line so relayout as multiline
mStaticLayout = new StaticLayout(mText, mTextPaint, width, Layout.Alignment.ALIGN_NORMAL, 1.0f, 0, false);
}
}
}
//determine the height
int height;
int heightMode = MeasureSpec.getMode(heightMeasureSpec);
int heightRequirement = MeasureSpec.getSize(heightMeasureSpec);
if (heightMode == MeasureSpec.EXACTLY) {
height = heightRequirement;
} else {
height = mStaticLayout.getHeight() + getPaddingTop() + getPaddingBottom();
if (heightMode == MeasureSpec.AT_MOST) {
height = Math.min(height, heightRequirement);
}
}
//Required call: set width and height
setMeasuredDimension(width, height);
}
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
//do as little as possible inside onDraw to improve performance
//draw the text on the canvas after adjusting for padding
canvas.save();
canvas.translate(getPaddingLeft(), getPaddingTop());
mStaticLayout.draw(canvas);
canvas.restore();
}
}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="@dimen/activity_vertical_margin"
tools:context="com.example.layoutpractice.MainActivity">
<com.example.layoutpractice.MyView
android:layout_centerHorizontal="true"
android:background="@color/colorAccent"
android:padding="10dp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
</RelativeLayout>

Notes

• Cette, cette, et cette ont été utiles dans l'apprentissage de la façon de faire un texte personnalisé de la manipulation de vue.

• Voir Création d'une Vue de Classe si vous souhaitez ajouter des attributs personnalisés qui peuvent être définies à partir du code ou xml.