CBaseControlWindow.get_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 in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 get_Top méthode récupère la coordonnée de la fenêtre supérieure.

Syntaxe

HRESULT get_Top(
   long *pTop
);

Paramètres

pTop

Pointeur vers la 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 la gauche, le haut, la largeur et la hauteur ; il s’agit de la convention utilisée dans DirectShow. Toutes les coordonnées sont exprimées en pixels, et la modification de n’importe quelle 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