Grabber::setDefaultWindowPosition Method

Enables or disables the default window size lock of the video window.

Syntax:

bool setDefaultWindowPosition( bool bDefault );

Parameter		Description


bDefault		If bDefault is set to true, the grabber adjusts the live video window display to the width and height of the current video format. In this mode, it is not possible to change the grabber's video window size. If bDefault is set to false, the size of the window for the live video display is independent from the width and height of the current video format. In this mode, the size and position of the live video window may be set by calling setDefaultWindowPosition. The default value is true.

Return value:

true on success, false otherwise.

Remarks:

This Method is used to enable or disable automatic resizing of the live video window to the width and height of the current video format. The size of the live video window can only be set independently from the width and height of the current video format, if automatic resizing is disabled.

If an application needs to fit the video window into a control's window, the parameter bDefault must be set to false.

Setting pDefault to true, sets the size of the video window immediately to the width and height of the current video format. A subsequent call to Grabber::setWindowPosition fails, because the size of the video window is dependent on the current video format.

<< Grabber