WinPhotoAcquireOptionsDialogMBS.Constructor

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The constructor.

Please call Initialize.

WinPhotoAcquireOptionsDialogMBS.Create(Window as DesktopWindow) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	22.0	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The Create method creates and displays a modeless instance of the photo options dialog box, hosted within a parent window.

This method is for advanced users, which can position the new window via declares.

Window: The parent window.

Returns the handle for the created dialog box.

The Initialize method should be called prior to the Create method.
The parent window provides OK and Cancel buttons to the new dialog box instance.

See also:

• Create(Window as Window) as Integer
• Create(WindowHandle as Integer) as Integer

WinPhotoAcquireOptionsDialogMBS.Create(Window as Window) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The Create method creates and displays a modeless instance of the photo options dialog box, hosted within a parent window.

This method is for advanced users, which can position the new window via declares.

Window: The parent window.

Returns the handle for the created dialog box.

The Initialize method should be called prior to the Create method.
The parent window provides OK and Cancel buttons to the new dialog box instance.

See also:

• Create(Window as DesktopWindow) as Integer
• Create(WindowHandle as Integer) as Integer

WinPhotoAcquireOptionsDialogMBS.Create(WindowHandle as Integer) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The Create method creates and displays a modeless instance of the photo options dialog box, hosted within a parent window.

This method is for advanced users, which can position the new window via declares.

WindowHandle: Handle to the parent window.

Returns the handle for the created dialog box.

The Initialize method should be called prior to the Create method.
The parent window provides OK and Cancel buttons to the new dialog box instance.

See also:

• Create(Window as DesktopWindow) as Integer
• Create(Window as Window) as Integer

WinPhotoAcquireOptionsDialogMBS.Destroy

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The Destroy method closes and destroys the modeless dialog box created with the Create method.

If you destroy the parent window, the child window will automatically be destroyed.

WinPhotoAcquireOptionsDialogMBS.Initialize(RegistryRoot as String = "")

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

Initializes the options dialog box and reads any saved options from the registry.

Initialize must be called prior to calling Create or DoModal. Failure to do so will cause Create or DoModal to fail.
If Initialize is called while the options dialog box is already displayed, an error will be returned.

RegistryRoot: (optional) String containing the registry root of a custom location to read the acquisition settings from. If this parameter is set to "", the default location will be used.

WinPhotoAcquireOptionsDialogMBS.SaveData

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The SaveData method saves acquisition settings from the options dialog box to the registry so that a subsequent instance of the dialog can be initialized with the same settings.

Some examples using this method:

• /WinFrameworks/Windows Photo Acquire

WinPhotoAcquireOptionsDialogMBS.ShowModal(Window as Window) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The DoModal method creates and displays the options dialog box as a modal dialog box.

Window: The dialog's parent window.
Returns the code returned when the window is closed.

The modal dialog displayed by DoModal will have OK and Cancel buttons, whereas the OK and Cancel buttons of the modeless dialog displayed by Create must be provided by the parent window.

See also:

• ShowModal(WindowHandle as Integer) as Integer

WinPhotoAcquireOptionsDialogMBS.ShowModal(WindowHandle as Integer) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Windows Photos	MBS WinFrameworks Plugin	20.3	❌ No	✅ Yes	❌ No	❌ No	Desktop only

The DoModal method creates and displays the options dialog box as a modal dialog box.

WindowHandle: Handle to the dialog's parent window.
Returns the code returned when the window is closed.

The modal dialog displayed by DoModal will have OK and Cancel buttons, whereas the OK and Cancel buttons of the modeless dialog displayed by Create must be provided by the parent window.

See also:

• ShowModal(Window as Window) as Integer