Struct winsafe::guard::SelectObjectGuard

pub struct SelectObjectGuard<'a, H, G>
where
    H: gdi_Hdc,
    G: GdiObject,
{ /* private fields */ }

Available on crate features kernel and gdi only.

RAII implementation for HDC::SelectObject calls, which automatically selects the previous GDI object at the end of the scope.

Implementations

impl<'a, H, G> SelectObjectGuard<'a, H, G>

where H: gdi_Hdc, G: GdiObject,

pub const unsafe fn new( hdc: &'a H, prev_hgdi: G, region: Option<REGION> ) -> Self

Constructs the guard by taking ownership of the handle.

Safety

Be sure the handle must be again passed to HDC::SelectObject at the end of scope.

pub const fn prev_object(&self) -> &G

Returns a handle to the object that has been replaced.

pub const fn region(&self) -> Option<REGION>

Returns the region information returned by the source HDC::SelectObject call, if the GdiObject was an HRGN; otherwise returns None.

pub fn leak(&mut self) -> G

Ejects the underlying handle, leaving a Handle::INVALID in its place.

Since the internal handle will be invalidated, the destructor will not run. It’s your responsability to run it, otherwise you’ll cause a resource leak.

Trait Implementations

impl<'a, H, G> Drop for SelectObjectGuard<'a, H, G>

where H: gdi_Hdc, G: GdiObject,

fn drop(&mut self)

Executes the destructor for this type.