Struct WinPlatformServices 

pub struct WinPlatformServices { /* private fields */ }

Available on crate feature win only.

Implementations

impl WinPlatformServices

pub fn new() -> Self

Trait Implementations

impl Default for WinPlatformServices

fn default() -> Self

Returns the “default value” for a type.

impl PlatformServices for WinPlatformServices

fn show_folder_open_dialog(&self, opts: FileDialogOptions) -> Option<PathBuf>

The shell folder-picker (IFileOpenDialog + FOS_PICKFOLDERS).

fn show_message_dialog( &self, opts: MessageDialogOptions, ) -> Option<MessageDialogChoice>

TaskDialogIndirect — see this module’s doc comment for why TaskDialog over the legacy MessageBoxW.

fn open_url_result(&self, url: &str) -> ServiceResult<()>

Fallible twin of Self::open_url: reports ShellExecuteW’s real outcome via [crate::desktop::open_with_default] instead of open_url’s discarded one — before this override, open_url_result fell to crate::backend::PlatformServices::open_url_result’s default (open_url then always Ok(())), so a failed ShellExecuteW call (e.g. SE_ERR_FNF — the target does not exist) was silently reported as success.

Note what this still cannot promise: ShellExecuteW reports whether it handed the target off, not whether anything subsequently opened. An unregistered URI scheme, for instance, returns success (42) because the shell accepted it and will sort out the missing handler asynchronously — see this module’s open_url_result_and_open_path_report_a_real_shell_execute_failure test for the failure this can honestly detect.

fn reveal_in_file_manager(&self, path: &Path) -> ServiceResult<()>

SHOpenFolderAndSelectItems — see win_reveal_in_file_manager’s doc for the ILCreateFromPathW/ ILClone/ILRemoveLastID PIDL dance it takes.

fn open_path(&self, path: &Path) -> ServiceResult<()>

ShellExecuteW(NULL, "open", path, ...) via [crate::desktop::open_with_default] — the exact same call Self::open_url_result makes above, just fed a filesystem path instead of a URL string; ShellExecuteW’s "open" verb already accepts either.

fn move_to_trash(&self, path: &Path) -> ServiceResult<()>

[crate::desktop::move_to_trash] — see that function’s doc for why every backend, Win-GUI included, shares this one trash-crate-backed implementation rather than hand-rolling SHFileOperationW(FOF_ALLOWUNDO) here.

fn beep(&self) -> ServiceResult<()>

MessageBeep(MB_OK) — the default system notification sound (Windows’ Settings maps MB_OK’s alias, “Asterisk”/ “Default Beep” depending on the Windows version, to whichever sound scheme the user picked; there is no dedicated “just beep” API distinct from this legacy MessageBoxW-family sound-alias mechanism).

fn system_theme(&self) -> ServiceResult<SystemTheme>

UISettings::GetColorValue (Background/Accent) + AccessibilitySettings::HighContrast — see this module’s WinRT import comment for why the latter comes from the same namespace rather than a separate Win32 SPI call.

fn displays(&self) -> ServiceResult<Vec<Display>>

EnumDisplayMonitors + GetMonitorInfoW for bounds/work_area/ primary (rcMonitor/rcWork/MONITORINFOF_PRIMARY), GetDpiForMonitor for scale.

fn cursor_screen_point(&self) -> ServiceResult<Point>

GetCursorPos — the global cursor position in virtual-screen coordinates, the same coordinate space Self::displays’s bounds/work_area use.

fn platform_name(&self) -> &'static str

Platform identifier — matches the BackendNative.backend field. One of "tui", "gtk", "win-gui", "macos".

fn clipboard(&self) -> &dyn Clipboard

fn show_file_open_dialog(&self, opts: FileDialogOptions) -> Option<PathBuf>

Show a native file-open dialog (blocking). Returns None if the user cancelled. TUI backends have no native dialog to show and unconditionally return None (no stderr hint is written); apps should provide an in-TUI picker instead.

fn show_file_save_dialog(&self, opts: FileDialogOptions) -> Option<PathBuf>

Show a native file-save dialog.

fn send_notification(&self, n: Notification)

Dispatch a system notification — see Notification’s doc for icon/actions/silent/tag.

fn open_url(&self, url: &str)

Open a URL in the platform’s default browser.

fn secret_store(&self) -> &dyn SecretStore

The OS credential store — Keychain (macOS), Secret Service (Linux), Windows Credential Manager — for apps that hold an API token, a password, or an OAuth refresh token and would otherwise have no choice but to invent their own storage or write it to plaintext config.