CBaseControlWindow.put_Top méthode

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La put_Top méthode définit les coordonnées de la fenêtre supérieure.

Syntaxe

HRESULT put_Top(
   long Top
);

Paramètres

Top

Nouvelle coordonnée supérieure, en pixels.

Valeur renvoyée

Retourne une valeur HRESULT .

Notes

La fenêtre a une position sur le bureau. Il est exprimé en pixels par quatre coordonnées (gauche, haut, droite et bas). Les interfaces automatisées par OLE expriment généralement cette position par le biais de la gauche, du haut, de la largeur et de la hauteur ; il s’agit de la convention utilisée dans DirectShow. Toutes les coordonnées sont exprimées en pixels, et la modification d’une coordonnée met immédiatement à jour la fenêtre.

La définition des coordonnées gauche ou supérieure déplace la fenêtre vers la gauche ou vers le haut, respectivement ; ces coordonnées n’ont aucun effet sur la largeur et la hauteur de la fenêtre. De même, la définition de la largeur et de la hauteur n’affecte pas les coordonnées gauche et supérieure.

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBaseControlWindow, classe