Enum IconError 

pub enum IconError {
    Unsupported {
        reason: &'static str,
    },
    Load {
        path: PathBuf,
        source: Error,
    },
    Apply(Error),
    DegradedSourceUnsupported {
        reason: &'static str,
    },
    Decode(IcoError),
}

Why setting an icon failed.

Variants

Unsupported

The host cannot accept an icon at all.

Distinct from an I/O failure: retrying or supplying a different file will not help, and the caller should stop asking.

Fields

reason: &'static str

Why the host is unsupported.

Load

The icon source could not be loaded.

Fields

path: PathBuf

Path that failed to load.

source: Error

Underlying OS error.

Apply(Error)

The OS refused to build an icon from otherwise well-formed data.

Removed in #720 because nothing constructed it; reinstated here because CreateIconFromResourceEx can fail on data this crate has already validated the shape of — the image itself may still be something the OS will not decode.

DegradedSourceUnsupported

The host accepts only a symbolic name, and this source is not one.

Distinct from IconError::Unsupported: the host would accept a stock icon, so the remedy is to pass one rather than to give up.

Fields

reason: &'static str

What the host will and will not accept.

Decode(IcoError)

The supplied bytes are not a usable icon.

Separate from IconError::Load because the remedy differs: a bad path is fixed by pointing somewhere else, malformed bytes by fixing what was embedded.

Trait Implementations

impl Debug for IconError

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

Formats the value using the given formatter.

impl Display for IconError

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

Formats the value using the given formatter.

impl Error for IconError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.