xtd::forms::style_sheets::length Class Reference

Inheritance diagram for xtd::forms::style_sheets::length:

Definition

The xtd::forms::style_sheets::length specifies the legth and unit of many properties of the xtd::forms::style_sheets::ibox_model.

class forms_export_ length : public xtd::iequatable<length>, public xtd::object

Inheritance

xtd::object → xtd::forms::style_sheets::length

Implements

xtd::iequatable <>

Header

#include <xtd/forms/style_sheets/lenght>

Namespace

xtd::forms::style_sheets

Library

xtd.forms

Remarks

CSS has several different units for expressing a length.

Many CSS properties take "length" values, such as width, margin, padding, font-size, etc.

Length is a number followed by a length unit, such as 10px, 2em, etc.CSS has several different units for expressing a length.

Example

Set different length values, using px (pixels):

control {
  border-width: 3px;
}
 
button {
  border-width: 1px;
  border-radius: 5px;
}

Note

A whitespace cannot appear between the number and the unit. However, if the value is 0, the unit can be omitted.

Remarks

For some CSS properties, negative lengths are allowed.

There are two types of length units: absolute and relative.

Absolute lengths

The absolute length units are fixed and a length expressed in any of these will appear as exactly that size.

Enum class value	Css potfix	Description
centimeters	cm	centimeters
millimeters	mm	millimeters
inches	in	inches (1in = 96px = 2.54cm)
pixels	px	pixels (1px = 1/96th of 1in)
points	pt	points (1pt = 1/72 of 1in)
picas	pc	picas (1pc = 12 pt)

Relative lengths

Relative length units specify a length relative to another length property. Relative length units scales better between different rendering mediums.

Enum class value	Css potfix	Description
element	em	Relative to the font-size of the element (2em means 2 times the size of the current font)
element_x_height	ex	Relative to the x-height of the current font (rarely used)
chase	ch	Relative to width of the "0" (zero)
root_element	rem	Relative to font-size of the root element
viewport_width	vw	Relative to 1% of the width of the viewport(*)
viewport_height	vh	Relative to 1% of the height of the viewport(*)
viewport_min	vmin	Relative to 1% of viewport's* smaller dimension
viewport_max	vmax	Relative to 1% of viewport's* larger dimension
percent	%	Relative to the parent element

Note

The element(em) and root_element(rem) units are practical in creating perfectly scalable layout! (*) Viewport = the bounds of the element. If the viewport is 50cm wide, 1vw = 0.5cm.

Public Fields
static const length	empty
	Provides a xtd::forms::style_sheets::length object with 0 pixels.

Public Constructors
	length ()=default
	Initializes a new instance of the xtd::forms::style_sheets::length class.
	length (double value)
	Initializes a new instance of the xtd::forms::style_sheets::length class with specifed value in pixels.
	length (double value, length_unit unit)
	Initializes a new instance of the xtd::forms::style_sheets::length class with specifed value and unit.

Peorperties
double	value () const noexcept
	Gets the xtd::forms::style_sheets::length value.
void	value (double value) noexcept
	Sets the xtd::forms::style_sheets::length value.
length_unit	unit () const noexcept
	Gets the xtd::forms::style_sheets::length unit.
void	unit (length_unit value) noexcept
	Sets the xtd::forms::style_sheets::length unit.

Public Methods
bool	equals (const length &other) const noexcept override
int32	get_pixels (const xtd::drawing::rectangle &rect) const noexcept
	Gets the legnth in pixels.
xtd::string	to_string () const noexcept override
	Returns a xtd::string that represents the current object.
virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.
template<typename object_a_t , typename object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.

Additional Inherited Members
Public Member Functions inherited from xtd::iequatable< length >
virtual bool	equals (const length &) const noexcept=0
	Indicates wheth er the current object is equal to another object of the same type.
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.
virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.
virtual type_object	get_type () const noexcept
	Gets the type of the current instance.
template<typename object_t >
xtd::uptr< object_t >	memberwise_clone () const
	Creates a shallow copy of the current object.
Static Public Member Functions inherited from xtd::object
template<typename object_a_t , typename object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.
template<typename object_a_t , typename object_b_t >
static bool	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are the same instance.

---

The documentation for this class was generated from the following file:

• xtd.forms/include/xtd/forms/style_sheets/length.h