método CBaseControlWindow.put_Top

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El put_Top método establece la coordenada de la ventana superior.

Sintaxis

HRESULT put_Top(
   long Top
);

Parámetros

Top (Principales)

Nueva coordenada superior, en píxeles.

Valor devuelto

Devuelve un valor HRESULT .

Observaciones

La ventana tiene una posición en el escritorio. Esto se expresa en píxeles por cuatro coordenadas (izquierda, superior, derecha e inferior). Las interfaces automatizadas por OLE suelen expresar esta posición a través de izquierda, superior, ancho y alto; esta es la convención que se usa en DirectShow. Todas las coordenadas se expresan en píxeles y el cambio de cualquier coordenada actualizará la ventana inmediatamente.

Al establecer las coordenadas izquierda o superior, se mueve la ventana hacia la izquierda o hacia arriba, respectivamente; estas coordenadas no tienen ningún efecto en el ancho y alto de la ventana. Del mismo modo, establecer el ancho y el alto no afecta a las coordenadas izquierda y superior.

Requisitos

Requisito	Value
Encabezado	Ctlutil.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseControlWindow (clase)