Ресурси dimension

Визначення розмірів має відбуватися в папці res/values у файлі з будь-яким довільним іменем. Загальний синтаксис визначення ресурсу наступний:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen name="ім’я_ресурсу">використовуваний_розмір</dimen>
</resources>

Як і інші ресурси, ресурс dimension визначається в кореневому елементі <resources>. Тег <dimen> позначає ресурс і в якості значення приймає певний розмір у одній з прийнятих одиниць вимірювання (dp, sp, pt, px, mm, in).

Тепер додамо в Android Studio до папки res/values новий елемент Values Resources File, який називатимемо dimens.xml.

Визначимо в ньому наступний вміст:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen name="horizontal_margin">64dp</dimen>
    <dimen name="vertical_margin">32dp</dimen>
    <dimen name="text_size">32sp</dimen>
</resources>

Тут визначено два ресурси для відступів horizontal_margin і vertical_margin, які зберігають відповідно значення 64dp і 32dp, а також ресурс text_size, який зберігає висоту шрифту — 32sp. Імена ресурсів можуть бути довільними.

Тепер використовуємо ресурс у файлі activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
 
    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello Android"
        android:background="#eaeaea"
         
        android:layout_marginTop="@dimen/vertical_margin"
        android:layout_marginLeft="@dimen/horizontal_margin"
        android:textSize="@dimen/text_size"
         
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
 
</androidx.constraintlayout.widget.ConstraintLayout>

Ресурси dimension використовуються для таких атрибутів візуальних елементів, які в якості значення потребують числового значення. Наприклад, атрибути android:layout_height або android:textSize. Для отримання ресурсу в xml після @dimen/ вказується ім’я ресурсу.

Для отримання ресурсів у коді Java використовується метод getDimension() класу Resources. Наприклад, визначимо в коді Java аналогічний візуальний інтерфейс:

package com.example.viewapp;
 
import androidx.appcompat.app.AppCompatActivity;
import androidx.constraintlayout.widget.ConstraintLayout;
 
import android.content.res.Resources;
import android.os.Bundle;
import android.util.TypedValue;
import android.widget.TextView;
 
public class MainActivity extends AppCompatActivity {
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //setContentView(R.layout.activity_main);
        // отримуємо ресурси
        Resources resources = getResources();
        float textSize = resources.getDimension(R.dimen.text_size);
        int hMargin = (int)resources.getDimension(R.dimen.horizontal_margin);
        int vMargin = (int)resources.getDimension(R.dimen.vertical_margin);
 
        ConstraintLayout constraintLayout = new ConstraintLayout(this);
 
        ConstraintLayout.LayoutParams layoutParams = new ConstraintLayout.LayoutParams
                (ConstraintLayout.LayoutParams.WRAP_CONTENT , ConstraintLayout.LayoutParams.WRAP_CONTENT);
        layoutParams.leftToLeft = ConstraintLayout.LayoutParams.PARENT_ID;
        layoutParams.topToTop = ConstraintLayout.LayoutParams.PARENT_ID;
 
        TextView textView = new TextView(this);
        textView.setText("Hello Android");
        textView.setBackgroundColor(0XFFEAEAEA);
        // встановлюємо розмір шрифта за ресурсом
        textView.setTextSize(TypedValue.COMPLEX_UNIT_PX, textSize);
        // встановлюємо відступи відповідно до ресурсів
        layoutParams.setMargins(hMargin, vMargin, hMargin, vMargin);
 
        textView.setLayoutParams(layoutParams);
        constraintLayout.addView(textView);
 
        setContentView(constraintLayout);
    }
}

При програмному отриманні ресурсів dimen за допомогою методу getDimension() слід враховувати, що він повертає значення у фізичних пікселях, навіть якщо у файлі ресурсів ми визначили значення в інших одиницях виміру (32sp, 64dp). У більшості випадків це не викликає труднощів, оскільки більшість методів у Java приймають саме пікселі, а не dp чи інші одиниці, як наприклад, метод setMargins(), який встановлює відступи.

Однак метод setTextSize() приймає саме sp, тому з додатковим параметром необхідно вказати, що в даному випадку маються на увазі фізичні пікселі, а не sp:

textView.setTextSize(TypedValue.COMPLEX_UNIT_PX, textSize);

Або, як варіант, за допомогою класу TypedValue можна програмно перевести фізичні пікселі в sp або іншу одиницю виміру.