Struct ItemFlags 

pub struct ItemFlags(/* private fields */);

A bitset of per-item behavior flags.

Use ItemFlags::default for the standard “interactive, visible, selectable” baseline. Compose flags with | and toggle them with ItemFlags::set / ItemFlags::contains.

Implementations

impl ItemFlags

pub const NONE: Self

Empty bitset — no flags set.

pub const IS_VISIBLE: Self

Item paints and is hit-tested. Default on. Clearing this is the equivalent of Qt’s setVisible(false) — the item is neither painted nor hit-tested. Children of an invisible item are also effectively invisible.

pub const IS_ENABLED: Self

Item dispatches pointer events. Default on. Disabled items are still painted but pass clicks through to items beneath.

pub const IS_DRAGGABLE: Self

Item participates in drag-to-move. Default off.

pub const IS_SELECTABLE: Self

Item is included in marquee box-select results. Default on.

pub const IS_FOCUSABLE: Self

Item can take keyboard focus. Default off; the focus_order callback considers only items with this flag set.

pub const ACCEPTS_HOVER: Self

Item dispatches hover events (Qt setAcceptHoverEvents). Default off; hover handlers wired via ItemBuilder::on_hover flip this on automatically.

pub const CLIPS_TO_SHAPE: Self

Item’s paint output is clipped to its local_bounds. Default off.

pub const CLIPS_CHILDREN_TO_SHAPE: Self

Children are clipped to this item’s local_bounds. Default off; mirrors Qt’s ItemClipsChildrenToShape.

pub const IGNORES_TRANSFORMATIONS: Self

Item paints and hit-tests at a fixed pixel size, independent of the view’s zoom and rotation. Its anchor (the item’s parent-relative scene point) is projected through the view transform like any other point, so the visible position follows pan/zoom and tracks the underlying scene data — but the item itself does not grow with zoom or rotate with the view. Mirrors Qt’s ItemIgnoresTransformations. Annotation pins for graph editors, fixed-pixel-size badges over moving content, chart axis labels. Default off.

pub const HAS_NO_CONTENTS: Self

Item has nothing to paint — the paint walk skips it entirely. Pure logical-only containers (used for AT grouping or hit-test routing) set this. Default off.

pub const NEGATIVE_Z_BEHIND_PARENT: Self

Children with z < 0 paint behind this item rather than in front. Mirrors Qt’s ItemNegativeZStacksBehindParent. Default off.

pub const fn contains(&self, other: Self) -> bool

Whether the bitset contains every flag in other.

pub const fn intersects(&self, other: Self) -> bool

Whether the bitset shares any flags with other.

pub fn set(&mut self, flag: Self, on: bool)

Set (when on) or clear (when !on) the bits in flag.

pub const fn with(self, flag: Self) -> Self

Set the bits in flag, returning the new bitset.

pub const fn without(self, flag: Self) -> Self

Clear the bits in flag, returning the new bitset.

pub const fn bits(self) -> u32

Raw u32 bits (debug / serialization).

pub const fn from_bits(bits: u32) -> Self

Construct from raw bits.

Trait Implementations

impl BitAnd for ItemFlags

type Output = ItemFlags

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self

Performs the & operation.

impl BitOr for ItemFlags

type Output = ItemFlags

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl BitOrAssign for ItemFlags

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl Clone for ItemFlags

fn clone(&self) -> ItemFlags

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ItemFlags

impl Debug for ItemFlags

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ItemFlags

fn default() -> Self

IS_VISIBLE | IS_ENABLED | IS_SELECTABLE.

impl Eq for ItemFlags

impl Hash for ItemFlags

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ItemFlags

fn eq(&self, other: &ItemFlags) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ItemFlags