GridViewのstretchModeについて

GridViewの「stretchMode」の値によって、グリッド表示がどのように変化するのかを「android:numColumns="3"」の場合で試してみた。

結果は以下の通り。

android:stretchMode="none"


android:stretchMode="columnWidth"


android:stretchMode="spacingWidth"


android:stretchMode="spacingWidthUniform"


GridViewのソースを確認したところ、主に、determineColumnsメソッド（841行目～906行目）内でstretchModeの値による処理内容が決められていることがわかった。

    private void determineColumns(int availableSpace) {
        final int requestedHorizontalSpacing = mRequestedHorizontalSpacing;
        final int stretchMode = mStretchMode;
        final int requestedColumnWidth = mRequestedColumnWidth;
        
        if (mRequestedNumColumns == AUTO_FIT) {
            if (requestedColumnWidth > 0) {
                // Client told us to pick the number of columns
                mNumColumns = (availableSpace + requestedHorizontalSpacing) /
                        (requestedColumnWidth + requestedHorizontalSpacing);
            } else {
                // Just make up a number if we don't have enough info
                mNumColumns = 2;
            }
        } else {
            // We picked the columns
            mNumColumns = mRequestedNumColumns;
        }
        
        if (mNumColumns <= 0) {
            mNumColumns = 1;
        }

        switch (stretchMode) {
        case NO_STRETCH:
            // Nobody stretches
            mColumnWidth = requestedColumnWidth;
            mHorizontalSpacing = requestedHorizontalSpacing;
            break;

        default:
            int spaceLeftOver = availableSpace - (mNumColumns * requestedColumnWidth) -
                    ((mNumColumns - 1) * requestedHorizontalSpacing);
            switch (stretchMode) {
            case STRETCH_COLUMN_WIDTH:
                // Stretch the columns
                mColumnWidth = requestedColumnWidth + spaceLeftOver / mNumColumns;
                mHorizontalSpacing = requestedHorizontalSpacing;
                break;

            case STRETCH_SPACING:
                // Stretch the spacing between columns
                mColumnWidth = requestedColumnWidth;
                if (mNumColumns > 1) {
                    mHorizontalSpacing = requestedHorizontalSpacing + 
                        spaceLeftOver / (mNumColumns - 1);
                } else {
                    mHorizontalSpacing = requestedHorizontalSpacing + spaceLeftOver;
                }
                break;

            case STRETCH_SPACING_UNIFORM:
                // Stretch the spacing between columns
                mColumnWidth = requestedColumnWidth;
                if (mNumColumns > 1) {
                    mHorizontalSpacing = requestedHorizontalSpacing + 
                        spaceLeftOver / (mNumColumns + 1);
                } else {
                    mHorizontalSpacing = requestedHorizontalSpacing + spaceLeftOver;
                }
                break;
            }

            break;
        }
    }

要するに、GridViewでは各行について「余ったスペース」をうまく配分して表示するようになっているところ、この配分方法を決定するのがstretchModeの役割のようだ。

わかりやすく図示すると以下のようになる。









stretchMode="spacingWidthUniform"の場合に、先頭要素の表示位置が右にずれてるのはmakeRowメソッドの

        int nextLeft = mListPadding.left +
                ((mStretchMode == STRETCH_SPACING_UNIFORM) ? horizontalSpacing : 0);

の処理のためですね。

しかし、spacingWidthUniformは表示が右に偏りすぎだけど、これ誰が使うの？？

おそらくだけど、

                    mHorizontalSpacing = requestedHorizontalSpacing + 
                        spaceLeftOver / (mNumColumns + 1);

の部分は、正しくは

                    mHorizontalSpacing = (requestedHorizontalSpacing * (nNumColumns - 1) + 
                        spaceLeftOver) / (mNumColumns + 1);

として下図のように均等配置したかったんじゃないのかなあ？？

ま、stretchModeの値はデフォルトで"columnWidth"となってるし、ここはおとなしくcolumnWidthを使いましょうかね。

いつになく気合の入った記事になってしまった。でもまあ、紙メモだけじゃ絶対に忘却するから、これくらいしないと覚書にはならんのよね。