Struct winsafe::gui::TreeView

pub struct TreeView<T: 'static = ()>(/* private fields */);

Available on crate feature gui only.

Native tree view control.

The generic parameter specifies the type of the object that will be embedded on each item – if you don’t want to store anything, just use () as the type. Internally, this storage is implemented with pointers in the item’s LPARAM fields.

Implementations

impl<T> TreeView<T>

pub fn new(parent: &impl GuiParent, opts: TreeViewOpts) -> Self

Instantiates a new TreeView object, to be created on the parent window with HWND::CreateWindowEx.

Panics

Panics if the parent window was already created – that is, you cannot dynamically create a TreeView in an event closure.

pub fn new_dlg( parent: &impl GuiParent, ctrl_id: u16, resize_behavior: (Horz, Vert) ) -> Self

Instantiates a new TreeView object, to be loaded from a dialog resource with HWND::GetDlgItem.

Panics

Panics if the parent dialog was already created – that is, you cannot dynamically create a TreeView in an event closure.

pub fn image_list(&self, kind: TVSIL) -> Option<&HIMAGELIST>

Retrieves a reference to one of the associated image lists by sending a tvm::GetImageList message.

The image list is owned by the control.

pub const fn items(&self) -> TreeViewItems<'_, T>

Exposes the item methods.

pub fn set_extended_style(&self, set: bool, ex_style: TVS_EX)

Sets or unsets the given extended list view styles by sending a tvm::SetExtendedStyle message.

pub fn set_image_list( &self, kind: TVSIL, himagelist: ImageListDestroyGuard ) -> Option<ImageListDestroyGuard>

Sets the one of the associated image lists by sending a tvm::SetImageList message.

The image list will be owned by the control. Returns the previous one, if any.

Trait Implementations

impl<T> Clone for TreeView<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> GuiChild for TreeView<T>

fn ctrl_id(&self) -> u16

Returns the control ID, which is defined at control creation.

impl<T> GuiChildFocus for TreeView<T>

fn focus(&self)

In a raw, ordinary window, simply calls HWND:SetFocus.

impl<T> GuiNativeControl for TreeView<T>

fn on_subclass(&self) -> &WindowEvents

Exposes the subclass events. If at least one event exists, the control will be subclassed.

impl<T> GuiNativeControlEvents<TreeViewEvents> for TreeView<T>

fn on(&self) -> &TreeViewEvents

Exposes the specific control events.

impl<T> GuiWindow for TreeView<T>

fn hwnd(&self) -> &HWND

Returns the underlying handle for this control.

fn as_any(&self) -> &dyn Any

Converts a reference to the Any trait. This is useful when storing a collection of polymorphic controls, because Any allows downcasting.

impl<T> Send for TreeView<T>