#include <WM_types.hh>

Public Attributes
wmDropBox *	next
wmDropBox *	prev
bool(*	poll )(bContext C, wmDrag drag, const wmEvent *event)
void(*	on_drag_start )(bContext C, wmDrag drag)
void(*	on_enter )(wmDropBox drop, wmDrag drag)
void(*	on_exit )(wmDropBox drop, wmDrag drag)
void(*	copy )(bContext C, wmDrag drag, wmDropBox *drop)
void(*	cancel )(Main bmain, wmDrag drag, wmDropBox *drop)
void(*	draw_droptip )(bContext C, wmWindow win, wmDrag *drag, const int xy[2])
void(*	draw_in_view )(bContext C, wmWindow win, wmDrag *drag, const int xy[2])
void *	draw_data
WMDropboxTooltipFunc	tooltip
wmOperatorType *	ot
char	opname [64]
IDProperty *	properties
PointerRNA *	ptr

Detailed Description

Drop-boxes are like key-maps, part of the screen/area/region definition. Allocation and free is on startup and exit.

The operator is polled and invoked with the current context (blender::wm::OpCallContext::InvokeDefault), there is no way to override that (by design, since drop-boxes should act on the exact mouse position). So the drop-boxes are supposed to check the required area and region context in their poll.

Definition at line 1359 of file WM_types.hh.

Member Data Documentation

◆ cancel

void(* wmDropBox::cancel) (Main *bmain, wmDrag *drag, wmDropBox *drop)

If the operator is canceled (returns OPERATOR_CANCELLED), this can be used for cleanup of copy() resources.

Definition at line 1384 of file WM_types.hh.

Referenced by WM_dropbox_add().

◆ copy

void(* wmDropBox::copy) (bContext *C, wmDrag *drag, wmDropBox *drop)

Before exec, this copies drag info to #wmDrop properties.

Definition at line 1378 of file WM_types.hh.

Referenced by wm_drop_prepare(), and WM_dropbox_add().

◆ draw_data

void* wmDropBox::draw_data

Custom data for drawing.

Definition at line 1402 of file WM_types.hh.

Referenced by blender::ed::vse::generic_drop_draw_handling(), blender::ed::vse::image_drop_on_enter(), blender::ed::vse::sequencer_drop_on_exit(), view3d_collection_drop_copy_external_asset(), view3d_drop_snap_exit(), view3d_drop_snap_init(), view3d_ob_drop_copy_external_asset(), and wm_drop_update_active().

◆ draw_droptip

void(* wmDropBox::draw_droptip) (bContext *C, wmWindow *win, wmDrag *drag, const int xy[2])

Override the default cursor overlay drawing function. Can be used to draw text or thumbnails. IE a tooltip for drag and drop.

Parameters

xy	Cursor location in window coordinates (wmEvent.xy compatible).

Definition at line 1391 of file WM_types.hh.

Referenced by blender::ed::vse::sequencer_dropboxes_add_to_lb(), view3d_dropboxes(), and wm_drags_draw().

◆ draw_in_view

void(* wmDropBox::draw_in_view) (bContext *C, wmWindow *win, wmDrag *drag, const int xy[2])

Called with the draw buffer (GPUViewport) set up for drawing into the region's view.

Note: Only setups the drawing buffer for drawing in view, not the GPU transform matrices. The callback has to do that itself, with for example UI_view2d_view_ortho.

Parameters

xy	Cursor location in window coordinates (wmEvent.xy compatible).

Definition at line 1399 of file WM_types.hh.

Referenced by blender::ed::vse::sequencer_dropboxes_add_to_lb(), and wm_drags_draw().

◆ next

wmDropBox* wmDropBox::next

Definition at line 1360 of file WM_types.hh.

◆ on_drag_start

void(* wmDropBox::on_drag_start) (bContext *C, wmDrag *drag)

Called when the drag action starts. Can be used to prefetch data for previews.

Note: The dropbox that will be called eventually is not known yet when starting the drag. So this callback is called on every dropbox that is registered in the current screen.

Definition at line 1368 of file WM_types.hh.

Referenced by blender::ed::vse::sequencer_dropboxes_add_to_lb(), and wm_dropbox_invoke().

◆ on_enter

void(* wmDropBox::on_enter) (wmDropBox *drop, wmDrag *drag)

Called when poll returns true the first time. Typically used to setup some drawing data.

Definition at line 1371 of file WM_types.hh.

Referenced by blender::ed::vse::sequencer_dropboxes_add_to_lb(), view3d_dropboxes(), and wm_drop_update_active().

◆ on_exit

void(* wmDropBox::on_exit) (wmDropBox *drop, wmDrag *drag)

Called when poll returns false the first time or when the drag event ends (successful drop or canceled). Typically used to cleanup resources or end drawing.

Definition at line 1375 of file WM_types.hh.

Referenced by blender::ed::vse::sequencer_dropboxes_add_to_lb(), view3d_dropboxes(), WM_drag_free(), and wm_drop_update_active().

◆ opname

char wmDropBox::opname[64]

wmOperatorType::idname, needed for re-registration.

Definition at line 1415 of file WM_types.hh.

Referenced by WM_dropbox_add(), and wm_dropbox_item_update_ot().

◆ ot

wmOperatorType* wmDropBox::ot

If poll succeeds, operator is called. Not saved in file, so can be pointer. This may be null when the operator has been unregistered, where opname can be used to re-initialize it.

Definition at line 1413 of file WM_types.hh.

Referenced by dropbox_active(), dropbox_tooltip(), wm_drop_prepare(), WM_dropbox_add(), and wm_dropbox_item_update_ot().