TextView

TextView, přímý potomek View, slouží k zobrazování textu. Samo o sobě umí „jen” zobrazit text, ale mezi jeho potomky patří mnoho dalších důležitých view, jako například EditText či Button. U TextView  ukážu jen opravdu základní metody a atributy, nebudu se věnovat ani těm, které z něj mohou udělat EditText, ani těm, které jsou sice zajímavé, ale ne kriticky důležité (např. android:ellipsize či android:ems), abych vás zbytečně nezahltil. V případě potřeby je určitě najdete v dokumentaci. Některé atributy a metody TextView uvedu až u EditTextu, přestože tam ve skutečnosti nepatří, ale rámcově se tam hodí víc a budete je používat téměř pouze právě s ním.

Pro mnoho dalších atributů a metod TextView se podívejte do jeho dokumentace. Jen pozor na to, abyste kvůli tomu všemu nezapomněli, že existují speciální třídy, mnohem vhodnější pro některé úkony, jako například EditText, Button, CheckBox nebo RadioButton. My si z nich povíme něco jen o  EditText u, Button nemá oproti TextView nic navíc, takže s ním vlastě už umíme, a ty ostatní dvě jsou také už velmi jednoduchá, takže si je, až je budete potřebovat, můžete nastudovat bez problému sami. Pěkně jsou různá formulářová view rozebrána v Input Controls.

Programujeme

Všimněte si, že jsem u <TextView>  s id large_text nastavil nejen atribut android:onClick (abych mohl ukázat, že metoda getLines vrací správné výsledky), ale musel jsem mu nastavit i android:clickable, aby se na něj dalo tapnout. View má ve výchozím stavu clickable="true", ale u TextView  tomu tak není.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:autoLink="all"
        android:text="@string/auto_link" />

    <TextView
        android:id="@+id/large_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:clickable="true"
        android:gravity="left"
        android:onClick="compareLineCount"
        android:text="@string/seo_text"
        android:textAppearance="?android:attr/textAppearanceLarge" />

    <TextView
        android:id="@+id/medium_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal"
        android:text="@string/seo_text"
        android:textAppearance="?android:attr/textAppearanceMedium" />

    <TextView
        android:id="@+id/small_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="right"
        android:text="@string/seo_text"
        android:textAppearance="?android:attr/textAppearanceSmall" />

    <TextView
        android:id="@+id/error"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/error" />

</LinearLayout>

K TextViewActivity.java  nic dodávat nemusím.

public class TextViewActivity extends Activity {

    TextView large;
    TextView medium;
    TextView small;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.text_view);

        ((TextView) findViewById(R.id.error)).setError("Někde se stala chyba.");

        large = (TextView) findViewById(R.id.large_text);
        medium = (TextView) findViewById(R.id.medium_text);
        small = (TextView) findViewById(R.id.small_text);

        Toast.makeText( // true, všechny tři mají stejný text
                this,
                String.valueOf(large.length() == medium.length()
                        && large.length() == small.length()),
                Toast.LENGTH_SHORT).show();
    }

    public void compareLineCount(View v){
        Toast.makeText( // skoro určitě false, ale na širokých displejích možná i true
                this,
                String.valueOf(large.getLineCount() == small.getLineCount()),
                Toast.LENGTH_SHORT).show();
    }
}

EditText

EditText je asi nejčastěji používaným formulářovým view na Androidu. Jako u všech ostatních view si i u něj představíme některé atributy a metody, nicméně v tomto případě jsou všechny bez výjimky ve skutečnosti definované už na TextView, ale používat je budeme na EditTextech, a tak mi přijde logičtější zařadit je sem. Ještě než začnu, upozorním na jednu zajímavou podtřídu EditText u, a to AutoCompleteTextView, což je EditText s funkcí autocomplete.

Metody žádné zmiňovat nebudu, takže si můžeme ukázat nějaký kód.

Ukázka kódu

Tentokrát jen layoutový XML soubor, Activity spočívá v tom, že nastaví správně contentView. Popisky a text jsem ošklivě napral přímo do příslušných atributů, neboť vysvětlují, co který EditText umí.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <EditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:enabled="false"
        android:text="Zakázaný vstup" />

    <EditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Sem vepište jakýkoliv text"
        android:inputType="text" />

    <EditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Kterékoli reálné číslo"
        android:inputType="numberSigned|numberDecimal" /> <!-- Samozřejmě jako desetinný rozvoj. -->

    <EditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Textové heslo"
        android:inputType="textPassword" />

</LinearLayout>

ImageView

ImageView, jak název napovídá, dokáže zobrazit obrázek. Protože není tak důležité, pouze se zmíním, že existuje, ukážu úplný základ a zájemce odkážu na Working With Images In Android, což je článek, který opravdu polopaticky vysvětluje práci s ImageView  o něco více do hloubky. Obrázky se však na telefonech zase tak moc nepoužívají (a tam, kde ano, obvykle nabízí Android jednodušší řešení) a pro většinu výjimek vám bude stačit to, co teď ukážu.

Dá se říci, že na displejích mdpi velmi zhruba jeden reálný pixel odpovídá (tzn. s odchylkou do asi 20 %) jednomu dp. Z toho můžete vycházet v tom, jak veliký obrázek pro mdpi displej vyrobíte. Potom ho musíte ještě samozřejmě velikostně předělat pro ostatní hustoty, viz kapitola Jednotky v minulém článku. Když máte v /res/drawable-ldpi, /res/drawable-mdpi, /res/drawable-hdpi a /res/drawable-xhdpi stejně pojmenované obrázky lišící se pouze velikostí, je potom už jednoduché ImageView použít:

<ImageView
    android:src="@drawable/image"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

ProgressBar

ProgressBar je nástroj, kterým dáme uživateli vědět, že se něco děje, přestože to nevidí. Je to taková obdoba technologické přestávky na silnicích. Atributy tentokráte neseřadím podle abecedy, ale přirozeněji, od jednodušších ke složitějším (respektive od základních ke specifičtějším).

Vedle výše jmenovaných nás zajímá už jen jedna metoda, a to incrementProgressBy(int diff), která místo nastavení nové hodnoty progressu jeho hodnotu zvýší o  diff.

ProgressBar pb = (ProgressBar)findViewById(R.id.determinate_progressbar);
for(int i = 0;i<=100;i++){
    pb.setProgress(i);
    try {
        Thread.sleep(100);
    } catch (InterruptedException e) {
    }
}

public void startPretendingWork(View v){
    final ProgressBar pb = (ProgressBar)findViewById(R.id.determinate_progressbar);
    for(int i = 0;i<=100;i++){
        pb.setProgress(i); // Jako pb.incrementProgressBy(1), je-li předtím progress 0
        try {
            Thread.sleep(100);
        } catch (InterruptedException e) {
        }
    }
}

public void startPretendingWork(View v) {
    final ProgressBar pb = (ProgressBar)findViewById(R.id.determinate_progressbar);
    new Thread(new Runnable() {
        public void run() {
            for (int i = 0; i <= 100; i++) {
                pb.setProgress(i);
                try {
                    Thread.sleep(100);
                } catch (InterruptedException e) {
                }
            }
        }
    }).start();
}

Jak se tedy takový progressbar tvoří?

Opět vynecháme activity, která sestává jen z nastavení správného contentView, a podíváme se jen na layoutový XML soubor. Ten není totožný s tím, který bude v ukázkových zdrojácích a ze kterého pochází screenshot – zde jsem pro stručnost nahradil všechna TextView komentářem:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <!-- Nejjednodušší případ -->
    <ProgressBar
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <!-- Výchozí, nekonečný -->
    <ProgressBar
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminate="true" />

    <!-- Horizontální nekonečný -->
    <ProgressBar
        style="@android:style/Widget.ProgressBar.Horizontal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminate="true" />

    <!-- Malý, nekonečný -->
    <ProgressBar
        style="@android:style/Widget.ProgressBar.Small"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminate="true" />

    <!-- Velký, nekonečný -->
    <ProgressBar
        style="@android:style/Widget.ProgressBar.Large"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminate="true" />

    <!-- Výchozí, konečný -->
    <ProgressBar
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminate="false"
        android:progress="45" />

    <!-- Horizontální, konečný -->
    <ProgressBar
        android:id="@+id/determinate_progressbar"
        style="@android:style/Widget.ProgressBar.Horizontal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminate="false"
        android:progress="79" />

</LinearLayout>

Text opět nesprávně předávám hodnotou, ale i v tomto případě plní text popisku dokumentační funkci. Na následujícím obrázku si jistě všimnete, že nejjednodušší, výchozí-nekonečný a výchozí-konečný vypadají stejně.

Tím jsme sice zdaleka neskončili, ale máme za sebou všechny potomky View a zároveň ne-potomky ViewGroup, které si dnes ukážeme. View má samozřejmě mnohem více potomků, stačí se podívat do dokumentace, kde jsou vypsáni všichni přímí i nepřímí potomci zobrazit.

A protože jsme probrali všechny ne-potomky ViewGroup , myslím, že můžeme říci, že jsme dokončili kapitolu. Článek pokračuje ve Vyvíjíme pro Android: Bližší pohled na pohledy – 2. díl.