Quelqu'un peut-il m'expliquer déclarer-styleable balise XML dans cet exemple et la théorie derrière son usage?

Je suis en train de lire le Début d'Android 4 Développement et dans le chapitre 5, on parle de Galerie et ImageVievs et introduit la déclarer-styleable balise XML sans expliquer son but.. j'ai essayé de trouver quelques infos également sur la référence, sans la chance.. nous avons Par exemple la suivante:

res/values/attrs.xml

<?xml version=”1.0 encoding=”utf-8”?> 
<resources>
    <declare-styleable name=”Gallery1”>
        <attr name=”android:galleryItemBackground” />
    </declare-styleable>
</resources>

example.java

public class GalleryActivity extends Activity {
[...]
    public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState);    
        setContentView(R.layout.main);
        Gallery gallery = (Gallery) findViewById(R.id.gallery1);
        gallery.setAdapter(new ImageAdapter(this)); 
        [...]
    }

    [...]

    public class ImageAdapter extends BaseAdapter {
        [...]
        int itemBackground;

        public ImageAdapter(Context c) {
            context = c;
            //---setting the style---
            TypedArray a = obtainStyledAttributes(
            R.styleable.Gallery1); 
            itemBackground = a.getResourceId(
                        R.styleable.Gallery1_android_galleryItemBackground, 0);
            a.recycle();
        }

        public View getView(int position, View convertView, ViewGroup parent) {
            ImageView imageView;
            [...]
            imageView.setBackgroundResource(itemBackground);
            return imageView; 
        }
    }
}

J'ai lu le code plusieurs fois et je ne comprends pas vraiment le but de la définition de ce styleable Gallery1 avec un seul attr enfant seul avec un nom attribut.. pouvez-vous m'aider? Est-ce galleryItemBackground quelque chose fournies par le système ou est-il quelque chose de défini par nous? Que faisons-nous dans ce morceau de code?

Je vous remercie d'avance pour toute aide!

OriginalL'auteur Gianni Costanzi | 2012-05-31