Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.
Layoutressource
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
| Wert | Beschreibung |
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:
-
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2026-11-19 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2026-11-19 (UTC)."],[],[]]