Editor

ClippingBasicFragment.java

/*
 * Copyright 2014 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.example.android.clippingbasic;

import com.example.android.common.logger.Log;

import android.graphics.Outline;
import android.support.v4.app.Fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.view.ViewOutlineProvider;
import android.widget.Button;
import android.widget.TextView;

/**
 * This sample shows how to clip a {@link View} using an {@link Outline}.
 */
public class ClippingBasicFragment extends Fragment {

private final static String TAG = "ClippingBasicFragment";

/* Store the click count so that we can show a different text on every click. */
    private int mClickCount = 0;

/* The {@Link Outline} used to clip the image with. */
    private ViewOutlineProvider mOutlineProvider;

/* An array of texts. */
    private String[] mSampleTexts;

/* A reference to a {@Link TextView} that shows different text strings when clicked. */
    private TextView mTextView;

@Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setHasOptionsMenu(true);
        mOutlineProvider = new ClipOutlineProvider();
        mSampleTexts = getResources().getStringArray(R.array.sample_texts);
    }

@Override
    public View onCreateView(
            LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        return inflater.inflate(R.layout.clipping_basic_fragment, container, false);
    }

@Override
    public void onViewCreated(final View view, Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);

/* Set the initial text for the TextView. */
        mTextView = (TextView) view.findViewById(R.id.text_view);
        changeText();

final View clippedView = view.findViewById(R.id.frame);

/* Sets the OutlineProvider for the View. */
        clippedView.setOutlineProvider(mOutlineProvider);

/* When the button is clicked, the text is clipped or un-clipped. */
        view.findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View bt) {
                // Toggle whether the View is clipped to the outline
                if (clippedView.getClipToOutline()) {
                    /* The Outline is set for the View, but disable clipping. */
                    clippedView.setClipToOutline(false);

Log.d(TAG, String.format("Clipping to outline is disabled"));
                    ((Button) bt).setText(R.string.clip_button);
                } else {
                    /* Enables clipping on the View. */
                    clippedView.setClipToOutline(true);

Log.d(TAG, String.format("Clipping to outline is enabled"));
                    ((Button) bt).setText(R.string.unclip_button);
                }
            }
        });

/* When the text is clicked, a new string is shown. */
        view.findViewById(R.id.text_view).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                mClickCount++;

// Update the text in the TextView
                changeText();

// Invalidate the outline just in case the TextView changed size
                clippedView.invalidateOutline();
            }
        });
    }

private void changeText() {
        // Compute the position of the string in the array using the number of strings
        //  and the number of clicks.
        String newText = mSampleTexts[mClickCount % mSampleTexts.length];

/* Once the text is selected, change the TextView */
        mTextView.setText(newText);
        Log.d(TAG, String.format("Text was changed."));

}

/**
     * A {@link ViewOutlineProvider} which clips the view with a rounded rectangle which is inset
     * by 10%
     */
    private class ClipOutlineProvider extends ViewOutlineProvider {

@Override
        public void getOutline(View view, Outline outline) {
            final int margin = Math.min(view.getWidth(), view.getHeight()) / 10;
            outline.setRoundRect(margin, margin, view.getWidth() - margin,
                    view.getHeight() - margin, margin / 2);
        }

}
}