CBaseControlWindow.put_Top-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die put_Top -Methode legt die Obere Fensterkoordinate fest.

Syntax

HRESULT put_Top(
   long Top
);

Parameter

Top

Neue obere Koordinate in Pixel.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Das Fenster hat eine Position auf dem Desktop. Dies wird in Pixeln durch vier Koordinaten (links, oben, rechts und unten) ausgedrückt. Schnittstellen, die von OLE automatisiert werden, drücken diese Position in der Regel über links, oben, Breite und Höhe aus. Dies ist die konvention, die in DirectShow verwendet wird. Alle Koordinaten werden in Pixeln ausgedrückt, und das Ändern einer Beliebigen Koordinate aktualisiert das Fenster sofort.

Durch festlegen der linken oder oberen Koordinaten wird das Fenster nach links bzw. nach oben verschoben. Diese Koordinaten haben keine Auswirkungen auf die Breite und Höhe des Fensters. Ebenso wirkt sich das Festlegen von Breite und Höhe nicht auf die linke und obere Koordinate aus.

Anforderungen

Anforderung	Wert
Header	Ctlutil.h (Streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseControlWindow-Klasse