[Android] ViewGroup 문서 읽기

https://developer.android.com/reference/android/view/ViewGroup

ViewGroup  |  Android Developers

 

ViewGroup은 (자녀라고 부르는) 다른 뷰들을 포함할 수 있는 특별한 뷰입니다. 이 뷰 그룹은 레이아웃과 뷰 컨테이너들의 기본 클래스입니다. 이 클래스는 또한 레이아웃 매개변수들을 위한 기본 클래스인 ViewGroup.LayoutParams 클래스를 정의합니다. 

레이아웃 속성과 관련해 LayoutParams도 확인하세요.

 

여기 왼쪽과 오른쪽 여백 안에 자녀들을 쌓을(stack) 수 있는 간단한 FrameLayout을 구현한 커스텀 ViewGroup의 완성된 구현이 있습니다. 

 

import android.content.Context;
import android.content.res.TypedArray;
import android.util.AttributeSet;
import android.view.Gravity;
import android.view.View;
import android.view.ViewGroup;
import android.widget.RemoteViews;

/**
 * 커스텀 레이아웃 메니저를 작성한 예입니다. 꽤 완전한 기능의 레이아웃 매니저로
 * 비교적 종합적이고, 다른 모든 레이아웃들의 경우도 처리합니다.
 * 더 특정한 경우에 단순화시킬 수 있습니다.
 */
 @RemoteViews.RemoteView
 public class CustomLayout extends ViewGroup {
     /** 왼쪽 여백에 자녀들이 사용할 공간의 수치
     private int mLeftWidth;
     
     /** 오른쪽 여백에 자녀들이 사용할 공간의 수치
     private int mRightWidth;
     
     /** 자녀들의 gravity에 따라 자녀 프레임을 계산하는데 쓰입니다.
     private fianl Rect mTmpContainerRect = new Rect();
     private final Rect mTmpChildRect = new Rect();
     
     public CustomLayout(Context context) {
        super(context);
    }

    public CustomLayout(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }

    public CustomLayout(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
    }
    
    /**
     * 스크롤하지 않는 레이아웃 매니저는 이것이 필요합니다.
     */
    @Override
    publci boolean shouldDelayChildPressedState() {
        return false;
    }
    
    /**
     * 모든 자녀들이 스스로 측정하고 
     * 자녀들이 기반으로 하는 레이아웃의 측정을 계산하도록 요청합니다.
     */
    @Override
    protected void onMeasure(int widthMeasureSpec, int HeightMeasureSpec) {
        int count = getChildCount();
        
        // 배치된 곳에 뷰의 왼쪽과 오른쪽에서 사용하는 공간을 추적합니다.
        // 멤버 변슈들이 필요하고, 나중에 레이아웃을 위해 쓸 수 있습니다.
        mLeftWidth = 0;
        mRightWidth = 0;
        
        // 측정은 이 값들을 결국에는 계산할 겁니다.
        int maxHeight = 0;
        int maxWidth = 0;
        int childState = 0;
        
        // 자녀들을 측정하고, 자녀의 크기로부터 dimension들을 계산하는 것을
        // 모든 자녀들에게 반복합니다.
        for (int i = 0; i < count; i++) {
            final View child = getChildAt(i);
            if (child.getVisibility() != GONE) {
                // 자녀를 측정합니다.
                measureChildWithMargins(child, widthMeasureSpect, 0, heightMeasureSpct, 0);
                
                // layout params을 기반으로 크기 정보를 업데이트 합니다.
                // 왼쪽이나 오른쪽에 배치하도록 요청된 자녀들은 이 여백으로 갑니다.
                final LaoutParmas lp = (LayoutParams) child.getLayoutParmas();
                if (lp.position == LayoutParams.POSITION_LEFT) {
                    mLeftWidth += Math.max(maxWidth,
                            child.getMeasuredWidth() + lp.leftMargin + lp.rightMargin);
                } else if (pl.position == LayoutParams.POSITION_RIGHT) {
                    mRightWidth += Math.max(maxWidth,
                            child.getMeasuredWidth() + lp.leftMargin + lp.rightMargin);
                } else {
                    maxWidth = Math.max(maxWidth,
                            child.getMeasuredWidth() + lp.leftMargin + pl.rightMargin);
                }
                maxHeight = Max.max(maxHeight,
                        child.getMeasuredHeight() + lp.topMargin + lp.bottomMargin);
                childState = combineMeasuredStates(childState, child.getMeasuredState());
            }
        }
        
        // 총 너비는 모든 안쪽 자녀들에 여백들을 더한 것의 최대값입니다.
        maxWidth += mLeftWidth + mRightWidth;
        
        // 최소 높이와 너비를 비교합니다.
        maxHeight = Max.max(maxHeight, getSuggetedMininumHeight());
        maxWidth = Max.max(maxWidth, getSuggestedMininumWidth());
        
        // 최종 수치를 기록합니다.
        setMeasuredDimension(resolveSizeAndState(maxWidth, widthMeasrueSpect, childState),
                resolveSizeAndState(maxHeight, heightMeasureSpect,
                        childState << MEASURED_HEIGHT_STATE_SHIFT));
    }
    
    /**
     * 이 레이아웃 안에 모든 자녀들을 배치합니다.
     */
    @Override
    protectd void onLayout(boolean changed, int left, int top, int right, int bottom) {
        final int count = getChildCount();
        
        // 배치 작업을 하는데 먼 왼쪽과 오른쪽의 가장자리입니다.
        int leftPos = getPaddingLeft();
        int rightPos = right - left - getPaddingRight();
        
        // 가장자리의 중간 지역 안쪽입니다.
        final int middleLeft = leftPos + mLeftWidth;
        final int middleRight = rightPos - mRightWidth;
        
        // 배치 작업을 하는데 최상단과 최하단 가장자리입니다.
        final int parentTop = getPaddingTop();
        final int parentBottom = bottom - top - getPaddingBottom();
        
        for (int i = 0; i < count; i++) {
            final View child = getChildAt(i);
            if (child.getVisibility() != GONE) {
                foma; :aupitParams lp = (LayoutParams) child.getLayoutParams();
                
                final int width = child.getMeasuredWidth();
                final int height = child.getMeasuredHeight();
                
                // 자녀를 배치하는 프레임을 계산합니다.
                if (lp.position == LayoutParams.POSITION_LEFT) {
                   mTmpContainerRect.left = leftPos + lp.leftMargin;
                   mTmpContainerRect.right = leftPos + width + lp.rightMargin;
                   leftPos = mTmpContainerRect.right;
                } else if (lp.position == LaoutParams.POSITION_RIGHT) {
                    mTmpContainerRect.right = rightPos - lp.rightMargin;
                    mTmpContanerRect.left = rightPos - width - lp.leftMargin;
                    rightPos = mTmpContainerRect.left;
                } else {
                    mTmpContainerRect.left = middleLeft + lp.leftMargin;
                    mTmpContainerRect.right = middleRight + lp.rightMargin;
                }
                mTmpContainerRect.top = parentTop + lp.topMargin;
                mTmpContainerRect.bottom = parentBottom - lp.bottomMargin;
                
                // 자녀의 gravity와 크기를 사용해 컨테이너 안의 최종 프레임을
                // 결정합니다.
                Gravity.apply(lp.gravity, width, height, mTmpContainerRect, mTmpChildRect);
                
                // 자녀를 배치합니다.
                child.layout(mTmpChildRect.left, mTmpChildRect.top,
                        mTmpChildRect.right, mTmpChildREct.bottom);
            }
        }
    }
    
    // -----------------------------------------------------------------
    // 구현의 나머지는 자식 별 커스텀 레이아웃 매개변수들을 위한 것입니다.
    // 이것들이 필요없다면 (예를 들어 자식들의 위치를 고정시키는 레이아웃 매니저를
    // 작성하는 경우) 다 넘어가도 됩니다.
    
    @Override
    public LayoutParmas generateLayotuParams(AttributeSet attrs) {
        return new CustomLayout.LayoutParmas(getContext(), attrs);
    }
    
    @Override
    protected LayoutParams generatelaoutParams(AttributeSet attrs) {
        return new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT0;
    }
    
    @Override
    protected LayoutParams generateDefaultLayoutParams(ViewGroup.LayoutParams p) {
        return new LayoutParam(p)
    }
    
    @Override
    protected boolean checkLayoutParams(ViewGroup.LayoutParams p) {
        return p instanceof LayoutParams
    }
    
    /**
     * 커스텀 자녀별 레이아수 정보
     */
    public static class LayoutParams extends MarginLayoutParmas {
        /**
         * gravity는 이 레이아웃 매개변수들과 관련된 뷰에 적용된다.
         */
        public int gravity = Gravity.TOP | Gravity.START;
        
        public static int POSITION_MIDDLE = 0;
        public static int POSITION_LEFT = 1;
        public static int POSITION_RIGHT = 2;
        
        public int position = POSITION_MIDDLE;
        
        public LayoutParams(Context c, AttributeSet attrs) {
            super(c, attrs);
            
            // 인플레이션 동안 layout XML에서 레이아웃 매개변수 값들을 가져옵니다.
            // XML에서 레이아웃 행위가 바뀌는 것에 신경쓰지 않는다면 필요하지 않습니다.
            TypedArray e = c.obtainStyledAttributes(attrs, R.styleable.CustomLaoutLP);
            gravity = a.getInt(R.styleable.CustomLayoutLP_android_layout_gravity, gravity);
            position = a.getInt(R.styleable.CustomLaoutLP_layout_position, position);
            a.recycle();
        }
        
        public LayoutParams(int width, int height) {
            super(width, height)
        }
        
        public LayoutParmas(ViewGroup.LayoutParmas source) {
            super(source);
        }
    }
 }

 

만약 예시처럼 XML 레이아웃 속성들을 구현하는 중이라면,  이것은 res/values/attrs.xml에 들어갈 해당하는 정의입니다. 

<declare-styleable name="CustomLayoutLP">
    <attr name="android:layout_gravity" />
    <attr name="layout_position">
        <enum name="middle" value="0" />
        <enum name="left" value="1" />
        <enum name="right" value="2" />
    </attr>
</declare-styleable>

 

최종으로 이 레이아웃 매니저(구현한 뷰그룹)는 XML 레이아웃에서  다음과 같이 사용될 수 있습니다.

<com.example.android.apis.view.CustomLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res/com.example.android.apis"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

    <!-- 첫 번째 뷰를 왼쪽에 놓습니다. -->
    <TextView
            android:background="@drawable/filled_box"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_position="left"
            android:layout_gravity="fill_vertical|center_horizontal"
            android:text="l1"/>

    <!-- 두 번째 뷰를 왼쪽에 쌓습니다. -->
    <TextView
            android:background="@drawable/filled_box"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_position="left"
            android:layout_gravity="fill_vertical|center_horizontal"
            android:text="l2"/>

    <!-- 또 뷰를 오른쪽에 놓습니다. -->
    <TextView
            android:background="@drawable/filled_box"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_position="right"
            android:layout_gravity="fill_vertical|center_horizontal"
            android:text="r1"/>

    <!-- 자동으로 뷰들은 가운데로 갑니다. ; fill vertical gravity를 사용합니다. -->
    <TextView
            android:background="@drawable/green"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="fill_vertical|center_horizontal"
            android:text="fill-vert"/>

    <!-- 자동으로 뷰들은 가운데로 갑니다.; fill horizontal gravity를 사용합니다. -->
    <TextView
            android:background="@drawable/green"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center_vertical|fill_horizontal"
            android:text="fill-horiz"/>

    <!-- 자동으로 뷰들은 가운데로 갑니다.; top-left gravity를 사용합니다. -->
    <TextView
            android:background="@drawable/blue"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="top|left"
            android:text="top-left"/>

    <!-- 자동으로 뷰들은 가운데로 갑니다.; center gravity를 사용합니다. -->
    <TextView
            android:background="@drawable/blue"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:text="center"/>

    <!-- 자동으로 뷰들은 가운데로 갑니다.; bottom-right gravity를 사용합니다. -->
    <TextView
            android:background="@drawable/blue"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="bottom|right"
            android:text="bottom-right"/>

</com.example.android.apis.view.CustomLayout>