ref_iface_IVDXFilterPreview_InitButton - shekh/VirtualDub2 GitHub Wiki

VirtualDub Plugin SDK 1.2

IVDXFilterPreview interface

IVDXFilterPreview:: InitButton

Specifies a button to automatically be updated when the filter preview window is opened or closed.

void InitButton(VDXHWND hwndButton);

Parameters

hwndButton	Button to update when the filter preview window state changes.

Thread safety

This method is not thread-safe.

Errors

Errors may not be returned from this function (see SetError()).

Remarks

InitButton() reduces the work a filter has to do to support filter preview by having the host automatically change the button label between Hide/Show Preview and to disable it if filter previewing is not enabled.

In cases where the automatic update performed by InitButton() is not suitable, a button callback can be used instead.

VirtualDub specific: Starting with 1.7.0, any keyboard accelerator on the button is preserved if possible.