| /* |
| * Copyright (C) 2011 The Android Open Source Project |
| * |
| * Licensed under the Eclipse Public License, Version 1.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.eclipse.org/org/documents/epl-v10.php |
| * |
| * 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.android.ide.common.layout; |
| |
| import static com.android.SdkConstants.ANDROID_URI; |
| import static com.android.SdkConstants.ATTR_LAYOUT_GRAVITY; |
| import static com.android.SdkConstants.GRAVITY_VALUE_BOTTOM; |
| import static com.android.SdkConstants.GRAVITY_VALUE_CENTER; |
| import static com.android.SdkConstants.GRAVITY_VALUE_CENTER_HORIZONTAL; |
| import static com.android.SdkConstants.GRAVITY_VALUE_CENTER_VERTICAL; |
| import static com.android.SdkConstants.GRAVITY_VALUE_FILL; |
| import static com.android.SdkConstants.GRAVITY_VALUE_FILL_HORIZONTAL; |
| import static com.android.SdkConstants.GRAVITY_VALUE_FILL_VERTICAL; |
| import static com.android.SdkConstants.GRAVITY_VALUE_LEFT; |
| import static com.android.SdkConstants.GRAVITY_VALUE_RIGHT; |
| import static com.android.SdkConstants.GRAVITY_VALUE_TOP; |
| |
| import org.w3c.dom.Element; |
| |
| /** Helper class for looking up the gravity masks of gravity attributes */ |
| public class GravityHelper { |
| // From SDK constants; temporary |
| public static final String GRAVITY_VALUE_START = "start"; //$NON-NLS-1$ |
| public static final String GRAVITY_VALUE_END = "end"; //$NON-NLS-1$ |
| |
| /** Bitmask for a gravity which includes left */ |
| @SuppressWarnings("PointlessBitwiseExpression") // for symmetry with other fields |
| public static final int GRAVITY_LEFT = 1 << 0; |
| |
| /** Bitmask for a gravity which includes right */ |
| public static final int GRAVITY_RIGHT = 1 << 1; |
| |
| /** Bitmask for a gravity which includes center horizontal */ |
| public static final int GRAVITY_CENTER_HORIZ = 1 << 2; |
| |
| /** Bitmask for a gravity which includes fill horizontal */ |
| public static final int GRAVITY_FILL_HORIZ = 1 << 3; |
| |
| /** Bitmask for a gravity which includes center vertical */ |
| public static final int GRAVITY_CENTER_VERT = 1 << 4; |
| |
| /** Bitmask for a gravity which includes fill vertical */ |
| public static final int GRAVITY_FILL_VERT = 1 << 5; |
| |
| /** Bitmask for a gravity which includes top */ |
| public static final int GRAVITY_TOP = 1 << 6; |
| |
| /** Bitmask for a gravity which includes bottom */ |
| public static final int GRAVITY_BOTTOM = 1 << 7; |
| |
| /** Bitmask for a gravity which includes start */ |
| public static final int GRAVITY_START = 1 << 8; |
| |
| /** Bitmask for a gravity which includes end */ |
| public static final int GRAVITY_END = 1 << 9; |
| |
| /** Bitmask for a gravity which includes any horizontal constraint */ |
| public static final int GRAVITY_HORIZ_MASK = GRAVITY_CENTER_HORIZ | GRAVITY_FILL_HORIZ |
| | GRAVITY_LEFT | GRAVITY_RIGHT | GRAVITY_START | GRAVITY_END; |
| |
| /** Bitmask for a gravity which any vertical constraint */ |
| public static final int GRAVITY_VERT_MASK = GRAVITY_CENTER_VERT | GRAVITY_FILL_VERT |
| | GRAVITY_TOP | GRAVITY_BOTTOM; |
| |
| /** |
| * Returns the gravity of the given element |
| * |
| * @param element the element to look up the gravity for |
| * @return a bit mask corresponding to the selected gravities |
| */ |
| public static int getGravity(Element element) { |
| String gravityString = element.getAttributeNS(ANDROID_URI, ATTR_LAYOUT_GRAVITY); |
| return getGravity(gravityString, GRAVITY_LEFT | GRAVITY_TOP); |
| } |
| |
| /** |
| * Returns the gravity bitmask for the given gravity string description |
| * |
| * @param gravityString the gravity string description |
| * @param defaultMask the default/initial bitmask to start with |
| * @return a bitmask corresponding to the gravity description |
| */ |
| public static int getGravity(String gravityString, int defaultMask) { |
| int gravity = defaultMask; |
| if (gravityString != null && !gravityString.isEmpty()) { |
| String[] anchors = gravityString.split("\\|"); //$NON-NLS-1$ |
| for (String anchor : anchors) { |
| if (GRAVITY_VALUE_CENTER.equals(anchor)) { |
| gravity = GRAVITY_CENTER_HORIZ | GRAVITY_CENTER_VERT; |
| } else if (GRAVITY_VALUE_FILL.equals(anchor)) { |
| gravity = GRAVITY_FILL_HORIZ | GRAVITY_FILL_VERT; |
| } else if (GRAVITY_VALUE_CENTER_VERTICAL.equals(anchor)) { |
| gravity = (gravity & GRAVITY_HORIZ_MASK) | GRAVITY_CENTER_VERT; |
| } else if (GRAVITY_VALUE_CENTER_HORIZONTAL.equals(anchor)) { |
| gravity = (gravity & GRAVITY_VERT_MASK) | GRAVITY_CENTER_HORIZ; |
| } else if (GRAVITY_VALUE_FILL_VERTICAL.equals(anchor)) { |
| gravity = (gravity & GRAVITY_HORIZ_MASK) | GRAVITY_FILL_VERT; |
| } else if (GRAVITY_VALUE_FILL_HORIZONTAL.equals(anchor)) { |
| gravity = (gravity & GRAVITY_VERT_MASK) | GRAVITY_FILL_HORIZ; |
| } else if (GRAVITY_VALUE_TOP.equals(anchor)) { |
| gravity = (gravity & GRAVITY_HORIZ_MASK) | GRAVITY_TOP; |
| } else if (GRAVITY_VALUE_BOTTOM.equals(anchor)) { |
| gravity = (gravity & GRAVITY_HORIZ_MASK) | GRAVITY_BOTTOM; |
| } else if (GRAVITY_VALUE_LEFT.equals(anchor)) { |
| gravity = (gravity & (GRAVITY_VERT_MASK|GRAVITY_START)) | GRAVITY_LEFT; |
| } else if (GRAVITY_VALUE_RIGHT.equals(anchor)) { |
| gravity = (gravity & (GRAVITY_VERT_MASK|GRAVITY_END)) | GRAVITY_RIGHT; |
| } else if (GRAVITY_VALUE_START.equals(anchor)) { |
| gravity = (gravity & (GRAVITY_VERT_MASK|GRAVITY_LEFT)) | GRAVITY_START; |
| } else if (GRAVITY_VALUE_END.equals(anchor)) { |
| gravity = (gravity & (GRAVITY_VERT_MASK|GRAVITY_RIGHT)) | GRAVITY_END; |
| } // else: "clip" not supported |
| } |
| } |
| |
| return gravity; |
| } |
| |
| /** |
| * Returns true if the given gravity bitmask is constrained horizontally |
| * |
| * @param gravity the gravity bitmask |
| * @return true if the given gravity bitmask is constrained horizontally |
| */ |
| public static boolean isConstrainedHorizontally(int gravity) { |
| return (gravity & GRAVITY_HORIZ_MASK) != 0; |
| } |
| |
| /** |
| * Returns true if the given gravity bitmask is constrained vertically |
| * |
| * @param gravity the gravity bitmask |
| * @return true if the given gravity bitmask is constrained vertically |
| */ |
| public static boolean isConstrainedVertically(int gravity) { |
| return (gravity & GRAVITY_VERT_MASK) != 0; |
| } |
| |
| /** |
| * Returns true if the given gravity bitmask is left aligned |
| * |
| * @param gravity the gravity bitmask |
| * @return true if the given gravity bitmask is left aligned |
| */ |
| public static boolean isLeftAligned(int gravity) { |
| return (gravity & (GRAVITY_LEFT|GRAVITY_START)) != 0; |
| } |
| |
| /** |
| * Returns true if the given gravity bitmask is top aligned |
| * |
| * @param gravity the gravity bitmask |
| * @return true if the given gravity bitmask is aligned |
| */ |
| public static boolean isTopAligned(int gravity) { |
| return (gravity & GRAVITY_TOP) != 0; |
| } |
| |
| /** Returns a gravity value string from the given gravity bitmask |
| * |
| * @param gravity the gravity bitmask |
| * @return the corresponding gravity string suitable as an XML attribute value |
| */ |
| public static String getGravity(int gravity) { |
| if (gravity == 0) { |
| return ""; |
| } |
| |
| if ((gravity & (GRAVITY_CENTER_HORIZ | GRAVITY_CENTER_VERT)) == |
| (GRAVITY_CENTER_HORIZ | GRAVITY_CENTER_VERT)) { |
| return GRAVITY_VALUE_CENTER; |
| } |
| |
| StringBuilder sb = new StringBuilder(30); |
| int horizontal = gravity & GRAVITY_HORIZ_MASK; |
| int vertical = gravity & GRAVITY_VERT_MASK; |
| |
| if ((horizontal & (GRAVITY_LEFT|GRAVITY_START)) != 0) { |
| if ((horizontal & GRAVITY_LEFT) != 0) { |
| sb.append(GRAVITY_VALUE_LEFT); |
| } |
| if ((horizontal & GRAVITY_START) != 0) { |
| if (sb.length() > 0) { |
| sb.append('|'); |
| } |
| sb.append(GRAVITY_VALUE_START); |
| } |
| } else if ((horizontal & (GRAVITY_RIGHT|GRAVITY_END)) != 0) { |
| if ((horizontal & GRAVITY_RIGHT) != 0) { |
| sb.append(GRAVITY_VALUE_RIGHT); |
| } |
| if ((horizontal & GRAVITY_END) != 0) { |
| if (sb.length() > 0) { |
| sb.append('|'); |
| } |
| sb.append(GRAVITY_VALUE_END); |
| } |
| } else if ((horizontal & GRAVITY_CENTER_HORIZ) != 0) { |
| sb.append(GRAVITY_VALUE_CENTER_HORIZONTAL); |
| } else if ((horizontal & GRAVITY_FILL_HORIZ) != 0) { |
| sb.append(GRAVITY_VALUE_FILL_HORIZONTAL); |
| } |
| |
| if (sb.length() > 0 && vertical != 0) { |
| sb.append('|'); |
| } |
| |
| if ((vertical & GRAVITY_TOP) != 0) { |
| sb.append(GRAVITY_VALUE_TOP); |
| } else if ((vertical & GRAVITY_BOTTOM) != 0) { |
| sb.append(GRAVITY_VALUE_BOTTOM); |
| } else if ((vertical & GRAVITY_CENTER_VERT) != 0) { |
| sb.append(GRAVITY_VALUE_CENTER_VERTICAL); |
| } else if ((vertical & GRAVITY_FILL_VERT) != 0) { |
| sb.append(GRAVITY_VALUE_FILL_VERTICAL); |
| } |
| |
| return sb.toString(); |
| } |
| } |
