Definieren von benutzerdefinierten Attras

Derzeit die beste Dokumentation ist die Quelle. Sie können einen Blick an ihm nehmen hier (attrs.xml).

Können Sie definieren Attribute in den top <resources> element oder innerhalb eines <declare-styleable> element. Wenn ich bin eine attr in mehr als einem Ort, den ich steckte es in das root-element. Beachten Sie, dass alle Attribute teilen den gleichen globalen namespace. Das bedeutet, dass selbst wenn Sie ein neues Attribut innerhalb einer <declare-styleable> - element kann verwendet werden, außerhalb von Ihr, und Sie können nicht erstellen Sie ein anderes Attribut mit dem gleichen Namen von einem anderen Typ.

Einer <attr> element hat zwei xml-Attribute name und format. name können Sie rufen Sie es etwas, und das ist, wie Sie am Ende die Bezugnahme auf code, z.B. R.attr.my_attribute. Die format Attribut kann unterschiedliche Werte haben, abhängig von der " Art " - Attribut, die Sie wollen.

• Verweis, wenn - er verweist auf eine andere Ressource-id (e.g, "@color/my_color", "@layout/my_layout")
• Farbe
• boolean
• dimension
• float
• integer
• string
• Bruchteil
• enum - normalerweise implizit definiert
• Flagge - in der Regel implizit definiert

Können Sie das format festlegen, um mehrere Typen mit |z.B. format="reference|color".

enum Attribute kann wie folgt definiert werden:

<attr name="my_enum_attr">
  <enum name="value1" value="1" />
  <enum name="value2" value="2" />
</attr>

flag Attribute sind ähnlich, außer den Werten, die definiert werden müssen, damit Sie die bit-ored zusammen:

<attr name="my_flag_attr">
  <flag name="fuzzy" value="0x01" />
  <flag name="cold" value="0x02" />
</attr>

Zusätzlich zu den Attributen gibt es die <declare-styleable> element. Dies ermöglicht Ihnen das definieren von Attributen einer benutzerdefinierten Ansicht verwenden können. Sie tun dies durch die Angabe einer <attr> element, wenn es war zuvor nicht angegeben format. Wenn Sie möchten, verwenden Sie ein android-attr, zum Beispiel android:gravity, dann kann man das in der name wie folgt.

Ein Beispiel für eine benutzerdefinierte Ansicht <declare-styleable>:

<declare-styleable name="MyCustomView">
  <attr name="my_custom_attribute" />
  <attr name="android:gravity" />
</declare-styleable>

Beim definieren der benutzerdefinierten Attribute in XML auf Ihre benutzerdefinierte Ansicht, die Sie brauchen, um ein paar Dinge tun. Zuerst müssen Sie deklarieren einen namespace zu finden, die deine Attribute. Sie tun dies auf der root-layout-element. Normalerweise gibt es nur xmlns:android="http://schemas.android.com/apk/res/android". Jetzt müssen Sie auch hinzufügen xmlns:whatever="http://schemas.android.com/apk/res-auto".

Beispiel:

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

    <org.example.mypackage.MyCustomView
      android:layout_width="fill_parent"
      android:layout_height="wrap_content"
      android:gravity="center"
      whatever:my_custom_attribute="Hello, world!" />
</LinearLayout>

Schließlich den Zugriff auf benutzerdefinierte attribute, die Sie normalerweise tun, also im Konstruktor der benutzerdefinierten Ansicht wie folgt.

public MyCustomView(Context context, AttributeSet attrs, int defStyle) {
  super(context, attrs, defStyle);

  TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.MyCustomView, defStyle, 0);

  String str = a.getString(R.styleable.MyCustomView_my_custom_attribute);

  //do something with str

  a.recycle();
}

Ende. 🙂

InformationsquelleAutor der Antwort Qberticus

Die Antwort oben umfasst alles sehr detailliert, abgesehen von ein paar Sachen.

Erste, wenn es keine Stile, dann die (Context context, AttributeSet attrs) Signatur der Methode wird instanziiert werden den Vorzug. In diesem Fall verwenden Sie einfach context.obtainStyledAttributes(attrs, R.styleable.MyCustomView) um die TypedArray-Klasse.

Zweitens deckt er nicht, wie man mit plaurals Ressourcen (Menge von Zeichenfolgen). Diese können sich mit der TypedArray-Klasse. Hier ist ein Codeausschnitt aus meinem SeekBarPreference, legt die Zusammenfassung der Vorliebe formatieren Sie dessen Wert entsprechend dem Wert der Einstellung. Wenn die xml für die Voreinstellung legt android:Inhaltsangabe zu einem text-string oder ein string-Ressource der Wert der Voreinstellung formatiert in den string ein (es sollten %d in es, um pick-up die Wert). Wenn android:summary gesetzt ist, um eine plaurals Ressource, dann ist das format das Ergebnis.

//Use your own name space if not using an android resource.
final static private String ANDROID_NS = 
    "http://schemas.android.com/apk/res/android";
private int pluralResource;
private Resources resources;
private String summary;

public SeekBarPreference(Context context, AttributeSet attrs) {
    //...
    TypedArray attributes = context.obtainStyledAttributes(
        attrs, R.styleable.SeekBarPreference);
    pluralResource =  attrs.getAttributeResourceValue(ANDROID_NS, "summary", 0);
    if (pluralResource !=  0) {
        if (! resources.getResourceTypeName(pluralResource).equals("plurals")) {
            pluralResource = 0;
        }
    }
    if (pluralResource ==  0) {
        summary = attributes.getString(
            R.styleable.SeekBarPreference_android_summary);
    }
    attributes.recycle();
}

@Override
public CharSequence getSummary() {
    int value = getPersistedInt(defaultValue);
    if (pluralResource != 0) {
        return resources.getQuantityString(pluralResource, value, value);
    }
    return (summary == null) ? null : String.format(summary, value);
}

• Dies ist nur als Beispiel gegeben, jedoch, wenn Sie gereizt werden, um die Zusammenfassung auf dem Bildschirm bevorzugt, dann müssen Sie rufen Sie notifyChanged() in der Präferenz der onDialogClosed Methode.

InformationsquelleAutor der Antwort Steve Waring