com.android.ide.common.resources.configuration

Class DensityQualifier

java.lang.Object

com.android.ide.common.resources.configuration.ResourceQualifier

com.android.ide.common.resources.configuration.DensityQualifier

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<ResourceQualifier>

public final class DensityQualifier
extends ResourceQualifier

Resource Qualifier for Screen Pixel Density.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAME

Constructor Summary

Constructors

Constructor and Description
DensityQualifier()
DensityQualifier(com.android.resources.Density value)

Method Summary

Modifier and Type	Method and Description
boolean	checkAndSet(java.lang.String value, FolderConfiguration config) Check if the value is valid for this qualifier, and if so sets the value into a Folder Configuration.
boolean	equals(java.lang.Object qualifier) Returns true if both objects are equal.
java.lang.String	getFolderSegment() Returns the string used to represent this qualifier in the folder name.
java.lang.String	getLongDisplayValue() Returns a string formatted for display purpose.
java.lang.String	getName() Returns the human readable name of the qualifier.
DensityQualifier	getNullQualifier() Returns the qualifier that can be used in ResourceQualifier.isBetterMatchThan(ResourceQualifier, ResourceQualifier) when no qualifier is present in the config.
java.lang.String	getShortDisplayValue() Returns a string formatted for display purpose.
java.lang.String	getShortName() Returns a shorter human readable name for the qualifier.
com.android.resources.Density	getValue()
boolean	hasFakeValue() Returns whether the qualifier has a fake value.
int	hashCode() Returns a hash code value for the object.
boolean	isBetterMatchThan(ResourceQualifier compareTo, ResourceQualifier reference) Returns true if the receiver (this) is a better match for the given reference than the given compareTo comparable.
boolean	isMatchFor(ResourceQualifier qualifier) Returns whether the given qualifier is a match for the receiver.
boolean	isValid() Returns whether the qualifier has a valid filter value.
int	since() Returns the API level when this qualifier was added to Android.

Methods inherited from class com.android.ide.common.resources.configuration.ResourceQualifier

compareTo, deprecated, isValid, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

NAME

public static final java.lang.String NAME

See Also:

Constant Field Values

Constructor Detail

DensityQualifier

public DensityQualifier()

DensityQualifier

public DensityQualifier(@NonNull
                        com.android.resources.Density value)

Method Detail

getValue

public com.android.resources.Density getValue()

getName

public java.lang.String getName()

Description copied from class: ResourceQualifier

Returns the human readable name of the qualifier.

Specified by:

getName in class ResourceQualifier

getShortName

public java.lang.String getShortName()

Description copied from class: ResourceQualifier

Returns a shorter human readable name for the qualifier.

Specified by:

getShortName in class ResourceQualifier

See Also:

ResourceQualifier.getName()

since

public int since()

Description copied from class: ResourceQualifier

Returns the API level when this qualifier was added to Android.

Specified by:

since in class ResourceQualifier

checkAndSet

public boolean checkAndSet(java.lang.String value,
                           FolderConfiguration config)

Description copied from class: ResourceQualifier

Check if the value is valid for this qualifier, and if so sets the value into a Folder Configuration.

Specified by:

checkAndSet in class ResourceQualifier

Parameters:

value - The value to check and set. Must not be null.

config - The folder configuration to receive the value. Must not be null.

Returns:

true if the value was valid and was set.

isValid

public boolean isValid()

Description copied from class: ResourceQualifier

Returns whether the qualifier has a valid filter value.

getNullQualifier

public DensityQualifier getNullQualifier()

Description copied from class: ResourceQualifier

Returns the qualifier that can be used in ResourceQualifier.isBetterMatchThan(ResourceQualifier, ResourceQualifier) when no qualifier is present in the config. null has a special meaning when trying to match the best config (it's the worst qualifier, unless not other alternative matches). If a qualifier type has a different definition of best in regards to the null qualifier, this method should be subclassed and a special value should be returned from here, which can then be used to call (ResourceQualifier, ResourceQualifier) which can implement the custom logic.

Overrides:

getNullQualifier in class ResourceQualifier

isMatchFor

public boolean isMatchFor(ResourceQualifier qualifier)

Description copied from class: ResourceQualifier

Returns whether the given qualifier is a match for the receiver. The default implementation returns the result of ResourceQualifier.equals(Object). Children class that re-implements this must implement (ResourceQualifier, ResourceQualifier) too.

Overrides:

isMatchFor in class ResourceQualifier

Parameters:

qualifier - the reference qualifier

Returns:

true if the receiver is a match.

isBetterMatchThan

public boolean isBetterMatchThan(@Nullable
                                 ResourceQualifier compareTo,
                                 @NonNull
                                 ResourceQualifier reference)

Description copied from class: ResourceQualifier

Returns true if the receiver (this) is a better match for the given reference than the given compareTo comparable.

Overrides:

isBetterMatchThan in class ResourceQualifier

Parameters:

compareTo - The ResourceQualifier to compare to.

reference - The reference qualifier value for which the match is (from phone's folderConfig).

hasFakeValue

public boolean hasFakeValue()

Description copied from class: ResourceQualifier

Returns whether the qualifier has a fake value. Fake values are used internally and should not be used as real qualifier value.

Specified by:

hasFakeValue in class ResourceQualifier

equals

public boolean equals(java.lang.Object qualifier)

Description copied from class: ResourceQualifier

Returns true if both objects are equal. This is declared as abstract to force children classes to implement it.

Specified by:

equals in class ResourceQualifier

hashCode

public int hashCode()

Description copied from class: ResourceQualifier

Returns a hash code value for the object. This is declared as abstract to force children classes to implement it.

Specified by:

hashCode in class ResourceQualifier

getFolderSegment

public final java.lang.String getFolderSegment()

Returns the string used to represent this qualifier in the folder name.

Specified by:

getFolderSegment in class ResourceQualifier

getShortDisplayValue

public java.lang.String getShortDisplayValue()

Description copied from class: ResourceQualifier

Returns a string formatted for display purpose.

Specified by:

getShortDisplayValue in class ResourceQualifier

getLongDisplayValue

public java.lang.String getLongDisplayValue()

Description copied from class: ResourceQualifier

Returns a string formatted for display purpose.

Specified by:

getLongDisplayValue in class ResourceQualifier