Length

Length structure

Representa un valor de longitud de CSS en cualquier unidad compatible, incluido el porcentaje y el tipo sin unidades. Los valores pueden ser enteros o flotantes, negativos, cero y positivos. Estructura inmutable.

public struct Length : ICloneable, ICssDataType, IEquatable<Length>

Propiedades

Nombre Descripción
FloatValue { get; } Devuelve un valor numérico flotante de la instancia de Longitud. Nunca arroja una excepción: convierte el valor entero en flotante si es necesario.
IntegerValue { get; } Devuelve un valor numérico entero de esta instancia de Longitud, si se almacena internamente como un número entero, o genera una excepción, si se almacenó originalmente como un número flotante.
IsAbsolute { get; } Se obtiene si la longitud se da en unidades absolutas. Dicha longitud se puede convertir en píxeles.
IsFloat { get; } Indica si el valor numérico de esta instancia de Longitud se especificó y almacenó originalmente como un flotante (FP32) número
IsInteger { get; } Indica si el valor numérico de esta instancia de longitud se especificó y almacenó originalmente como un número entero (INT32) number
IsNegative { get; } Determina si el valor numérico de esta longitud es un número negativo
IsPositive { get; } Determina si el valor numérico de esta longitud es un número positivo
IsRelative { get; } Se obtiene si la longitud se da en unidades relativas. Tal longitud no se puede convertir a píxeles.
IsUnitlessNonZero { get; } El valor tiene tipo sin unidad, pero no es un cero - número positivo o negativo
IsUnitlessZero { get; } Determina si esta instancia es un cero sin unidades o no. El cero sin unidades es el valor predeterminado de este tipo. Igual que la propiedad IsDefault.
IsZero { get; } Determina si el valor numérico de esta longitud es un número cero
UnitType { get; } Devuelve un tipo de unidad de esta instancia de Longitud.

Métodos

Nombre Descripción
static FromValueWithUnit(double, Unit) Crea y devuelve una instancia de tipo Longitud por número doble especificado y unidad
static FromValueWithUnit(float, Unit) Crea y devuelve una instancia de tipo Longitud por número flotante especificado y unidad
static FromValueWithUnit(int, Unit) Crea y devuelve una instancia de tipo Longitud por número entero especificado y unidad
static Parse(string) Analiza y devuelve la cadena especificada como un valor de Longitud, incluido su valor numérico y el nombre de la unidad, o lanza una excepción en caso de falla
Clone() Devuelve una copia completa de esta instancia de Longitud
Equals(Length) Define si este valor es igual a la otra longitud especificada
override Equals(object) Determina si esta longitud es igual al objeto especificado
override GetHashCode() Calcula y devuelve un código hash de esta instancia de Longitud combinando códigos hash del valor y tipo de unidad
SerializeDefault() Devuelve una representación de cadena de esta longitud en su forma nativa original (tal como está almacenada), sin convertir el valor de longitud a alguna otra unidad type
To(Unit) Convierte la longitud a la unidad dada, si es posible. Si el current o la unidad dada es relativa, se lanzará una excepción.
ToPixel() Convierte la longitud a un número de píxeles, si es posible. Si la unidad actual es relativa, se lanzará una excepción.
ToStringSpecified(Unit) Devuelve una representación de cadena de esta longitud en el tipo de unidad especificado. El valor numérico se convertirá en el correspondiente al cambio de tipo de unidad.
static GetUnitFromName(string) Intenta analizar el nombre de unidad especificado y devuelve el valor correspondiente de una enumeración de unidad. Devuelve Unit.Unitless si no puede encontrar la unidad adecuada.
static TryParse(string, out Length) Intenta analizar una cadena especificada como un valor de Longitud, incluido su valor numérico y el nombre de la unidad
operator == Comprueba la igualdad de las dos longitudes dadas.
operator != Comprueba la desigualdad de las dos longitudes dadas.
operator * Multiplica la Longitud dada por el factor dado

Campos

Nombre Descripción
static readonly FiftyPercents 50%
static readonly OneHundredPercents 100%
static readonly UnitlessZero Número entero sin unidades cero: valor predeterminado, igual que el constructor sin parámetros predeterminado
static readonly ZeroPercents 0%

Otros miembros

Nombre Descripción
enum Unit Todas las unidades de longitud admitidas

Observaciones

Este tipo cubre los siguientes tipos de datos CSS: https://developer.mozilla.org/en-US/docs/Web/CSS/length https://developer.mozilla.org/en-US/docs/Web/ CSS/porcentaje

Ver también

ICssDataType Length.Unit