CBaseControlVideo.SetTargetRect-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die SetTargetRect
-Methode legt das aktuelle Zielrechteck (rein virtuell) fest. Dies ist eine interne Memberfunktion, die aufgerufen wird, wenn sich das Zielrechteck ändert.
Syntax
virtual HRESULT SetTargetRect(
RECT *pTargetRect
) = 0;
Parameter
-
pTargetRect
-
Zeiger auf das Zielrechteck.
Rückgabewert
Gibt einen HRESULT-Wert zurück.
Bemerkungen
Abgeleitete Klassen sollten dies überschreiben, um zu wissen, wann sich das Zielrechteck ändert. Sie wird von den folgenden Memberfunktionen aufgerufen.
- CBaseControlVideo::SetDestinationPosition
- CBaseControlVideo::p ut_DestinationLeft
- CBaseControlVideo::p ut_DestinationWidth
- CBaseControlVideo::p ut_DestinationTop
- CBaseControlVideo::p ut_DestinationHeight
Im folgenden Beispiel wird eine Implementierung dieser Funktion in einer abgeleiteten Klasse veranschaulicht.
HRESULT CVideoText::SetTargetRect(RECT *pTargetRect)
{
m_pRenderer->m_DrawImage.SetTargetRect(pTargetRect);
return NOERROR;
}
In diesem Beispiel ist CVideoText eine von CBaseControlVideo abgeleitete Klasse, m_pRenderer ein Objekt einer klasse enthält, die von CBaseVideoRenderer abgeleitet ist, und der m_DrawImage Datenmember, der in der abgeleiteten Klasse definiert ist, enthält ein CDrawImage-Objekt .
Anforderungen
Anforderung | Wert |
---|---|
Header |
|
Bibliothek |
|