Layoutressource

Eine Layoutressource definiert die Architektur für die Benutzeroberfläche in einer Activity oder einer Komponente einer Benutzeroberfläche.

Dateispeicherort:
res/layout/filename.xml
Der Dateiname wird als Ressourcen-ID verwendet.
Kompilierter Ressourcendatentyp:
Ressourcenzeiger auf eine View-Ressource (oder Unterklasse)
Ressourcenreferenz:
In Java: R.layout.filename
In XML: @[package:]layout/filename
Syntax:
<?xml version="1.0" encoding="utf-8"?>
<ViewGroup
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@[+][package:]id/resource_name"
    android:layout_height=["dimension" | "match_parent" | "wrap_content"]
    android:layout_width=["dimension" | "match_parent" | "wrap_content"]
    [ViewGroup-specific attributes] >
    <View
        android:id="@[+][package:]id/resource_name"
        android:layout_height=["dimension" | "match_parent" | "wrap_content"]
        android:layout_width=["dimension" | "match_parent" | "wrap_content"]
        [View-specific attributes] >
        <requestFocus/>
    </View>
    <ViewGroup >
        <View />
    </ViewGroup>
    <include layout="@layout/layout_resource"/>
</ViewGroup>

Hinweis: Das Stammelement kann ein ViewGroup-, ein View- oder ein <merge>-Element sein. Es darf jedoch nur ein Stammelement geben und es muss das Attribut xmlns:android mit dem Namespace android enthalten, wie im vorherigen Syntaxbeispiel gezeigt.

Elemente:
<ViewGroup>
Ein Container für andere View-Elemente. Es gibt viele verschiedene Arten von ViewGroup-Objekten. Mit jedem können Sie das Layout der untergeordneten Elemente auf unterschiedliche Weise festlegen. Zu den verschiedenen Arten von ViewGroup-Objekten gehören LinearLayout, RelativeLayout und FrameLayout.

Gehe nicht davon aus, dass jede Ableitung von ViewGroup verschachtelte Ansichten akzeptiert. Einige Ansichtsgruppen sind Implementierungen der Klasse AdapterView, die ihre untergeordneten Elemente nur aus einem Adapter bestimmt.

Attribute:

android:id
Ressourcen-ID. Ein eindeutiger Ressourcenname für das Element, mit dem Sie einen Verweis auf die ViewGroup aus Ihrer Anwendung abrufen können. Weitere Informationen finden Sie im Abschnitt Wert für android:id.
android:layout_height
Dimension oder Keyword: Erforderlich. Die Höhe der Gruppe als Dimensionswert (oder Dimensionsressource) oder als Schlüsselwort ("match_parent" oder "wrap_content"). Weitere Informationen finden Sie im Abschnitt Werte für „android:layout_height“ und „android:layout_width“.
android:layout_width
Dimension oder Keyword: Erforderlich. Die Breite der Gruppe als Dimensionswert (oder Dimensionsressource) oder als Schlüsselwort ("match_parent" oder "wrap_content"). Weitere Informationen finden Sie im Abschnitt Werte für android:layout_height und android:layout_width.

Die Basisklasse ViewGroup unterstützt weitere Attribute und jede Implementierung von ViewGroup unterstützt noch viele weitere. Eine Referenz aller verfügbaren Attribute finden Sie in der entsprechenden Referenzdokumentation für die Klasse ViewGroup, z. B. die XML-Attribute für LinearLayout.

<View>
Eine einzelne UI-Komponente, die im Allgemeinen als Widget bezeichnet wird. Zu den verschiedenen Arten von View-Objekten gehören TextView, Button und CheckBox.

Attribute:

android:id
Ressourcen-ID. Ein eindeutiger Ressourcenname für das Element, mit dem Sie einen Verweis auf die View aus Ihrer Anwendung abrufen können. Weitere Informationen finden Sie im Abschnitt Wert für android:id.
android:layout_height
Dimension oder Keyword: Erforderlich. Die Höhe des Elements als Dimensionswert (oder Dimensionsressource) oder als Keyword ("match_parent" oder "wrap_content"). Weitere Informationen finden Sie im Abschnitt Werte für android:layout_height und android:layout_width.
android:layout_width
Dimension oder Keyword: Erforderlich. Die Breite des Elements als Dimensionswert (oder Dimensionsressource) oder als Schlüsselwort ("match_parent" oder "wrap_content"). Weitere Informationen finden Sie im Abschnitt Werte für android:layout_height und android:layout_width.

Die Basisklasse View unterstützt weitere Attribute und jede Implementierung von View unterstützt noch viele weitere. Weitere Informationen finden Sie unter Layouts. Eine Referenz aller verfügbaren Attribute finden Sie in der entsprechenden Referenzdokumentation, z. B. den TextView-XML-Attributen.

<requestFocus>
Jedes Element, das ein View-Objekt darstellt, kann dieses leere Element enthalten, wodurch das übergeordnete Element den anfänglichen Fokus auf dem Bildschirm erhält. Pro Datei ist nur eines dieser Elemente zulässig.
<include>
Fügt eine Layoutdatei in dieses Layout ein.

Attribute:

layout
Layoutressource. Erforderlich. Verweis auf eine Layoutressource.
android:id
Ressourcen-ID. Überschreibt die ID, die der Stammansicht im enthaltenen Layout zugewiesen wurde.
android:layout_height
Dimension oder Keyword: Überschreibt die Höhe, die der Stammansicht im enthaltenen Layout zugewiesen wurde. Nur wirksam, wenn auch android:layout_width deklariert ist.
android:layout_width
Dimension oder Keyword: Überschreibt die Breite, die der Stammansicht im enthaltenen Layout zugewiesen wurde. Nur wirksam, wenn auch android:layout_height deklariert ist.

Du kannst alle anderen Layoutattribute in das <include>-Element einfügen, die vom Stammelement im eingeschlossenen Layout unterstützt werden. Sie überschreiben die im Stammelement definierten Attribute.

Achtung: Wenn Sie Layoutattribute mit dem Tag <include> überschreiben möchten, müssen Sie sowohl android:layout_height als auch android:layout_width überschreiben, damit andere Layoutattribute wirksam werden.

Eine weitere Möglichkeit, ein Layout einzubinden, ist die Verwendung von ViewStub: eine einfache Ansicht, die keinen Layoutbereich belegt, bis Sie sie explizit aufblähen. Dabei wird eine Layoutdatei eingefügt, die durch das Attribut android:layout definiert ist. Weitere Informationen zur Verwendung von ViewStub finden Sie unter Ansichten bei Bedarf laden.

<merge>
Ein alternatives Stammelement, das nicht in der Layouthierarchie dargestellt wird. Die Verwendung dieses Elements als Stammelement ist nützlich, wenn Sie wissen, dass dieses Layout in einem Layout platziert wird, das bereits das entsprechende übergeordnete View-Element enthält, das die untergeordneten Elemente des <merge>-Elements enthalten soll.

Das ist besonders nützlich, wenn Sie dieses Layout mit <include> in eine andere Layoutdatei einfügen möchten und für dieses Layout kein anderer ViewGroup-Container erforderlich ist. Weitere Informationen zum Zusammenführen von Layouts finden Sie unter Layouts mit <include> wiederverwenden.

Wert für android:id

Für den ID-Wert verwenden Sie in der Regel die folgende Syntaxform: "@+id/name", wie im folgenden Beispiel gezeigt. Das Pluszeichen + gibt an, dass es sich um eine neue Ressourcen-ID handelt. Das aapt-Tool erstellt eine neue Ressourcen-Ganzzahl in der Klasse R.java, falls diese noch nicht vorhanden ist.

<TextView android:id="@+id/nameTextbox"/>

Der Name nameTextbox ist jetzt eine Ressourcen-ID, die diesem Element zugeordnet ist. Anschließend können Sie in Java auf die TextView verweisen, mit der die ID verknüpft ist:

Kotlin

val textView: TextView? = findViewById(R.id.nameTextbox)

Java

TextView textView = findViewById(R.id.nameTextbox);

Dieser Code gibt das Objekt TextView zurück.

Wenn Sie jedoch bereits eine ID-Ressource definiert haben, die noch nicht verwendet wird, können Sie diese ID auf ein View-Element anwenden, indem Sie das Pluszeichen im android:id-Wert weglassen.

Werte für android:layout_height und android:layout_width

Die Werte für Höhe und Breite werden mit einer der von Android unterstützten Maßeinheiten (px, dp, sp, pt, in, mm) oder mit den folgenden Keywords angegeben:

WertBeschreibung
match_parent Legt die Dimension so fest, dass sie mit der des übergeordneten Elements übereinstimmt. In API-Level 8 hinzugefügt, um fill_parent einzustellen.
wrap_content Legt die Dimension nur auf die Größe fest, die für den Inhalt dieses Elements erforderlich ist.

Benutzerdefinierte Ansichtselemente

Sie können benutzerdefinierte View- und ViewGroup-Elemente erstellen und sie wie ein Standard-Layoutelement auf Ihr Layout anwenden. Sie können auch die im XML-Element unterstützten Attribute angeben. Weitere Informationen finden Sie unter Benutzerdefinierte Ansichtskomponenten erstellen.

Beispiel:
XML-Datei gespeichert unter res/layout/main_activity.xml:
<?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:id="@+id/text"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:text="Hello, I am a TextView" />
    <Button android:id="@+id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Hello, I am a Button" />
</LinearLayout>

Dieser Anwendungscode lädt das Layout für eine Activity in der Methode onCreate():

Kotlin

public override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main_activity)
}

Java

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main_activity);
}
Siehe auch: