Edit

CBaseControlWindow.put_WindowStyleEx method

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The put_WindowStyleEx method sets the extended window styles.

Syntax

HRESULT put_WindowStyleEx(
  [in] long WindowStyleEx
);

Parameters

WindowStyleEx [in]

Value that specifies the style of the control window.

Return value

Returns NOERROR.

Remarks

This method uses extended window styles. For a complete list of extended window styles, see the Microsoft Win32 CreateWindowEx function. To change the window style, retrieve the current window style, and then add or remove the necessary bit fields.

Do not use the following window styles because they are not validated.

  • WS_DISABLED
  • WS_HSCROLL
  • WS_ICONIC
  • WS_MAXIMIZE
  • WS_MINIMIZE
  • WS_VSCROLL

With some exceptions (noted here), the acceptable flags are the same as those allowed by the Win32 CreateWindow function.

Requirements

Requirement Value
Header
Ctlutil.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CBaseControlWindow Class