• English

      • Framework Capabilities

      Framework capabilities section specifically introduces flor's optional capabilities. They are mostly enabled through Cargo features, and after enabling they expose the corresponding API, event builder or platform behavior.

      If you just want to look up all feature names, first see Quick Overview. This section explains platform capabilities in detail: what you can do after enabling, where the entry point is, and which tutorials/APIs are related.

      [dependencies]
flor = { version = "0.1.0", features = ["direct2d", "clipboard", "drag-drop"] }

      Platform Capabilities

      FeatureCapabilityEntry
      clipboardRead/write system clipboard.Clipboard
      drag-dropReceive system drag-drop enter, hover, leave, release events.Drag-Drop
      trayAdd, update, delete system tray icon, and receive tray mouse events.System Tray
      theme-changeExpose system theme change related event entry.Theme Change
      monitorQuery monitor list, work area, DPI, scaling etc. info.Monitor Information
      hi-dpiEnable process-level DPI awareness, paired with DPI change event to update layout units.High DPI
      cross-thread-window-creationAllow requesting window creation outside event loop thread.Cross-thread Window Creation
      cross-thread-window-commandsAllow cross-thread submission of deferred window commands and wake the event loop for processing.Cross-thread Window Commands
      resize-layout-coalescingExpose the layout refresh policy during window resize.Resize Layout Policy

      event-loop-wakeup is the base feature for event loop wake-up. Applications typically don't need to enable it separately; cross-thread-window-creation depends on it, and cross-thread-window-commands uses the same wake-up capability.

      Event-type capabilities usually also need to be paired with Event Builder use; complete handler signature and current dispatch status see Handler API.