Placeable

Artifact: androidx.compose.ui:ui

View Source

Added in 1.0.0

Common/AllAndroid/JVM

• Cmn

  abstract class Placeable : Measured

---

A Placeable corresponds to a child layout that can be positioned by its parent layout. Most Placeables are the result of a Measurable.measure call.

A Placeable should never be stored between measure calls.

Summary

Nested types
@PlacementScopeMarker abstract class Placeable.PlacementScope : Density Receiver scope that permits explicit placement of a Placeable.

Public constructors
Placeable()	Cmn

Protected functions
abstract Unit	placeAt(position: IntOffset, zIndex: Float, layerBlock: (GraphicsLayerScope.() -> Unit)?) Place a Placeable at position in its parent's coordinate system.	Cmn
open Unit	placeAt(position: IntOffset, zIndex: Float, layer: GraphicsLayer) Place a Placeable at position in its parent's coordinate system.	Cmn

Public properties
Int	height The height, in pixels, of the measured layout, as seen by the parent.	Cmn
open Int	measuredHeight The measured height of the layout.	Cmn
open Int	measuredWidth The measured width of the layout.	Cmn
Int	width The width, in pixels, of the measured layout, as seen by the parent.	Cmn

Protected properties
IntOffset	apparentToRealOffset The offset to be added to an apparent position assigned to this Placeable to make it real.	Cmn
IntSize	measuredSize The measured size of this Placeable.	Cmn
Constraints	measurementConstraints The constraints used for the measurement made to obtain this Placeable.	Cmn

Inherited functions
From androidx.compose.ui.layout.Measured abstract operator Int get(alignmentLine: AlignmentLine) Returns the position of an alignment line, or AlignmentLine.Unspecified if the line is not provided. Cmn

Inherited properties
From androidx.compose.ui.layout.Measured open Any? parentData Data provided by the ParentDataModifier applied to the layout. Cmn

Public constructors

Placeable

Cmn

Added in 1.0.0

Placeable()

Protected functions

placeAt

Cmn

protected abstract fun placeAt(position: IntOffset, zIndex: Float, layerBlock: (GraphicsLayerScope.() -> Unit)?): Unit

Place a Placeable at position in its parent's coordinate system.

Parameters
position: IntOffset	position in the parent's coordinate system.
zIndex: Float	controls the drawing order for the Placeable. A Placeable with larger zIndex will be drawn on top of all the children with smaller zIndex. When children have the same zIndex the order in which the items were placed is used.
layerBlock: (GraphicsLayerScope.() -> Unit)?	when non-null this Placeable should be placed with an introduced graphic layer. You can configure any layer property available on GraphicsLayerScope via this block. Also if the Placeable will be placed with a new position next time only the graphic layer will be moved without requiring to redrawn the Placeable content.

placeAt

Cmn

protected open fun placeAt(position: IntOffset, zIndex: Float, layer: GraphicsLayer): Unit

Place a Placeable at position in its parent's coordinate system.

Parameters
position: IntOffset	position in the parent's coordinate system.
zIndex: Float	controls the drawing order for the Placeable. A Placeable with larger zIndex will be drawn on top of all the children with smaller zIndex. When children have the same zIndex the order in which the items were placed is used.
layer: GraphicsLayer	GraphicsLayer to place this placeable with. If the Placeable will be placed with a new position next time only the graphic layer will be moved without requiring to redrawn the Placeable content.

Public properties

height

Cmn

Added in 1.0.0

val height: Int

The height, in pixels, of the measured layout, as seen by the parent. This will usually coincide with the measured height of the layout (aka the height value passed into MeasureScope.layout), but can be different if the layout does not respect its incoming constraints: in these cases the height will be coerced inside the min and max height constraints - to access the actual height that the layout measured itself to, use measuredHeight.

measuredHeight

Cmn

open val measuredHeight: Int

The measured height of the layout. This might not respect the measurement constraints.

measuredWidth

Cmn

open val measuredWidth: Int

The measured width of the layout. This might not respect the measurement constraints.

width

Cmn

Added in 1.0.0

val width: Int

The width, in pixels, of the measured layout, as seen by the parent. This will usually coincide with the measured width of the layout (aka the width value passed into MeasureScope.layout), but can be different if the layout does not respect its incoming constraints: in these cases the width will be coerced inside the min and max width constraints - to access the actual width that the layout measured itself to, use measuredWidth.

Protected properties

apparentToRealOffset

Cmn

Added in 1.0.0

protected val apparentToRealOffset: IntOffset

The offset to be added to an apparent position assigned to this Placeable to make it real. The real layout will be centered on the space assigned by the parent, which computed the child's position only seeing its apparent size.

measuredSize

Cmn

Added in 1.0.0

protected var measuredSize: IntSize

The measured size of this Placeable. This might not respect measurementConstraints.

measurementConstraints

Cmn

Added in 1.0.0

protected var measurementConstraints: Constraints

The constraints used for the measurement made to obtain this Placeable.