---
title: "pointerHoverIcon"
description: "Modifier that lets a developer define a pointer icon to display when the cursor is hovered over
the element. When [overrideDescendants] is set to true, descendants cannot override the pointer
icon using this modifier."
type: "modifier"
---

<div class='type'>Compose Modifier</div>

<a id='references'></a>
<div class='sourceset sourceset-common'>Common</div>


```kotlin
fun Modifier.pointerHoverIcon(icon: PointerIcon, overrideDescendants: Boolean = false) =
    this then
        PointerHoverIconModifierElement(icon = icon, overrideDescendants = overrideDescendants)
```


Modifier that lets a developer define a pointer icon to display when the cursor is hovered over
the element. When `overrideDescendants` is set to true, descendants cannot override the pointer
icon using this modifier.

#### Parameters

| | |
| --- | --- |
| icon | the icon to set |
| overrideDescendants | when false (by default), descendants are able to set their own pointer icon. If true, no descendants under this parent are eligible to change the icon (it will be set to the this (the parent's) icon). |




## Code Examples
### PointerIconSample
```kotlin
@Composable
fun PointerIconSample() {
    Column(Modifier.pointerHoverIcon(PointerIcon.Crosshair)) {
        SelectionContainer {
            Column {
                Text("Selectable text")
                Text(
                    modifier = Modifier.pointerHoverIcon(PointerIcon.Hand, true),
                    text = "Selectable text with hand",
                )
            }
        }
        Text("Just text with global pointerIcon")
    }
}
```