Gravity.java revision 935ae463d495d41155e27feb849768ad2b8b16db
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.view; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Rect; 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard constants and tools for placing an object within a potentially 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * larger container. 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Gravity 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Constant indicating that no gravity has been set **/ 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int NO_GRAVITY = 0x0000; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Raw bit indicating the gravity for an axis has been specified. */ 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AXIS_SPECIFIED = 0x0001; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Raw bit controlling how the left/top edge is placed. */ 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AXIS_PULL_BEFORE = 0x0002; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Raw bit controlling how the right/bottom edge is placed. */ 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AXIS_PULL_AFTER = 0x0004; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Raw bit controlling whether the right/bottom edge is clipped to its 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * container, based on the gravity direction being applied. */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AXIS_CLIP = 0x0008; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Bits defining the horizontal axis. */ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AXIS_X_SHIFT = 0; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Bits defining the vertical axis. */ 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AXIS_Y_SHIFT = 4; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Push object to the top of its container, not changing its size. */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int TOP = (AXIS_PULL_BEFORE|AXIS_SPECIFIED)<<AXIS_Y_SHIFT; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Push object to the bottom of its container, not changing its size. */ 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BOTTOM = (AXIS_PULL_AFTER|AXIS_SPECIFIED)<<AXIS_Y_SHIFT; 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Push object to the left of its container, not changing its size. */ 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LEFT = (AXIS_PULL_BEFORE|AXIS_SPECIFIED)<<AXIS_X_SHIFT; 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Push object to the right of its container, not changing its size. */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RIGHT = (AXIS_PULL_AFTER|AXIS_SPECIFIED)<<AXIS_X_SHIFT; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Place object in the vertical center of its container, not changing its 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size. */ 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CENTER_VERTICAL = AXIS_SPECIFIED<<AXIS_Y_SHIFT; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Grow the vertical size of the object if needed so it completely fills 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its container. */ 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FILL_VERTICAL = TOP|BOTTOM; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Place object in the horizontal center of its container, not changing its 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size. */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CENTER_HORIZONTAL = AXIS_SPECIFIED<<AXIS_X_SHIFT; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Grow the horizontal size of the object if needed so it completely fills 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its container. */ 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FILL_HORIZONTAL = LEFT|RIGHT; 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Place the object in the center of its container in both the vertical 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and horizontal axis, not changing its size. */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CENTER = CENTER_VERTICAL|CENTER_HORIZONTAL; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Grow the horizontal and vertical size of the object if needed so it 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely fills its container. */ 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FILL = FILL_VERTICAL|FILL_HORIZONTAL; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Flag to clip the edges of the object to its container along the 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertical axis. */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_VERTICAL = AXIS_CLIP<<AXIS_Y_SHIFT; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Flag to clip the edges of the object to its container along the 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * horizontal axis. */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_HORIZONTAL = AXIS_CLIP<<AXIS_X_SHIFT; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binary mask to get the horizontal gravity of a gravity. 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HORIZONTAL_GRAVITY_MASK = (AXIS_SPECIFIED | 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AXIS_PULL_BEFORE | AXIS_PULL_AFTER) << AXIS_X_SHIFT; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binary mask to get the vertical gravity of a gravity. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VERTICAL_GRAVITY_MASK = (AXIS_SPECIFIED | 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AXIS_PULL_BEFORE | AXIS_PULL_AFTER) << AXIS_Y_SHIFT; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Special constant to enable clipping to an overall display along the 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertical dimension. This is not applied by default by 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #apply(int, int, int, Rect, int, int, Rect)}; you must do so 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * yourself by calling {@link #applyDisplay}. 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int DISPLAY_CLIP_VERTICAL = 0x10000000; 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Special constant to enable clipping to an overall display along the 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * horizontal dimension. This is not applied by default by 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #apply(int, int, int, Rect, int, int, Rect)}; you must do so 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * yourself by calling {@link #applyDisplay}. 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int DISPLAY_CLIP_HORIZONTAL = 0x01000000; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Apply a gravity constant to an object. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gravity The desired placement of the object, as defined by the 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * constants in this class. 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param w The horizontal size of the object. 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h The vertical size of the object. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param container The frame of the containing space, in which the object 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be placed. Should be large enough to contain the 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width and height of the object. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param outRect Receives the computed frame of the object in its 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * container. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void apply(int gravity, int w, int h, Rect container, 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect outRect) { 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project apply(gravity, w, h, container, 0, 0, outRect); 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Apply a gravity constant to an object. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gravity The desired placement of the object, as defined by the 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * constants in this class. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param w The horizontal size of the object. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h The vertical size of the object. 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param container The frame of the containing space, in which the object 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be placed. Should be large enough to contain the 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width and height of the object. 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param xAdj Offset to apply to the X axis. If gravity is LEFT this 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pushes it to the right; if gravity is RIGHT it pushes it to 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the left; if gravity is CENTER_HORIZONTAL it pushes it to the 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * right or left; otherwise it is ignored. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param yAdj Offset to apply to the Y axis. If gravity is TOP this pushes 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it down; if gravity is BOTTOM it pushes it up; if gravity is 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * CENTER_VERTICAL it pushes it down or up; otherwise it is 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ignored. 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param outRect Receives the computed frame of the object in its 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * container. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void apply(int gravity, int w, int h, Rect container, 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int xAdj, int yAdj, Rect outRect) { 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (gravity&((AXIS_PULL_BEFORE|AXIS_PULL_AFTER)<<AXIS_X_SHIFT)) { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 0: 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.left = container.left 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + ((container.right - container.left - w)/2) + xAdj; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.right = outRect.left + w; 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&(AXIS_CLIP<<AXIS_X_SHIFT)) 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project == (AXIS_CLIP<<AXIS_X_SHIFT)) { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.left < container.left) { 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.left = container.left; 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.right > container.right) { 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.right = container.right; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AXIS_PULL_BEFORE<<AXIS_X_SHIFT: 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.left = container.left + xAdj; 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.right = outRect.left + w; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&(AXIS_CLIP<<AXIS_X_SHIFT)) 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project == (AXIS_CLIP<<AXIS_X_SHIFT)) { 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.right > container.right) { 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.right = container.right; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AXIS_PULL_AFTER<<AXIS_X_SHIFT: 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.right = container.right - xAdj; 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.left = outRect.right - w; 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&(AXIS_CLIP<<AXIS_X_SHIFT)) 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project == (AXIS_CLIP<<AXIS_X_SHIFT)) { 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.left < container.left) { 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.left = container.left; 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.left = container.left + xAdj; 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.right = container.right + xAdj; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (gravity&((AXIS_PULL_BEFORE|AXIS_PULL_AFTER)<<AXIS_Y_SHIFT)) { 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 0: 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.top = container.top 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + ((container.bottom - container.top - h)/2) + yAdj; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.bottom = outRect.top + h; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&(AXIS_CLIP<<AXIS_Y_SHIFT)) 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project == (AXIS_CLIP<<AXIS_Y_SHIFT)) { 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.top < container.top) { 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.top = container.top; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.bottom > container.bottom) { 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.bottom = container.bottom; 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AXIS_PULL_BEFORE<<AXIS_Y_SHIFT: 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.top = container.top + yAdj; 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.bottom = outRect.top + h; 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&(AXIS_CLIP<<AXIS_Y_SHIFT)) 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project == (AXIS_CLIP<<AXIS_Y_SHIFT)) { 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.bottom > container.bottom) { 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.bottom = container.bottom; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AXIS_PULL_AFTER<<AXIS_Y_SHIFT: 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.bottom = container.bottom - yAdj; 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.top = outRect.bottom - h; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&(AXIS_CLIP<<AXIS_Y_SHIFT)) 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project == (AXIS_CLIP<<AXIS_Y_SHIFT)) { 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (outRect.top < container.top) { 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.top = container.top; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.top = container.top + yAdj; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outRect.bottom = container.bottom + yAdj; 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 234935ae463d495d41155e27feb849768ad2b8b16dbDianne Hackborn * Apply additional gravity behavior based on the overall "display" that an 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object exists in. This can be used after 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #apply(int, int, int, Rect, int, int, Rect)} to place the object 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within a visible display. By default this moves or clips the object 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to be visible in the display; the gravity flags 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #DISPLAY_CLIP_HORIZONTAL} and {@link #DISPLAY_CLIP_VERTICAL} 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can be used to change this behavior. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gravity Gravity constants to modify the placement within the 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * display. 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param display The rectangle of the display in which the object is 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * being placed. 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param inoutObj Supplies the current object position; returns with it 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modified if needed to fit in the display. 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void applyDisplay(int gravity, Rect display, Rect inoutObj) { 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&DISPLAY_CLIP_VERTICAL) != 0) { 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.top < display.top) inoutObj.top = display.top; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.bottom > display.bottom) inoutObj.bottom = display.bottom; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int off = 0; 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.top < display.top) off = display.top-inoutObj.top; 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else if (inoutObj.bottom > display.bottom) off = display.bottom-inoutObj.bottom; 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (off != 0) { 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.height() > (display.bottom-display.top)) { 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.top = display.top; 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.bottom = display.bottom; 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.top += off; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.bottom += off; 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((gravity&DISPLAY_CLIP_HORIZONTAL) != 0) { 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.left < display.left) inoutObj.left = display.left; 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.right > display.right) inoutObj.right = display.right; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int off = 0; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.left < display.left) off = display.left-inoutObj.left; 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else if (inoutObj.right > display.right) off = display.right-inoutObj.right; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (off != 0) { 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (inoutObj.width() > (display.right-display.left)) { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.left = display.left; 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.right = display.right; 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.left += off; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inoutObj.right += off; 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Indicate whether the supplied gravity has a vertical pull.</p> 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gravity the gravity to check for vertical pull 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the supplied gravity has a vertical pull 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isVertical(int gravity) { 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return gravity > 0 && (gravity & VERTICAL_GRAVITY_MASK) != 0; 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Indicate whether the supplied gravity has an horizontal pull.</p> 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gravity the gravity to check for horizontal pull 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the supplied gravity has an horizontal pull 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isHorizontal(int gravity) { 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return gravity > 0 && (gravity & HORIZONTAL_GRAVITY_MASK) != 0; 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 307