Freigeben über


CBaseControlWindow.put_Caption-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_Caption -Methode legt den Fenstertitel oder die Untertitel fest.

Syntax

HRESULT put_Caption(
   BSTR strCaption
);

Parameter

strCaption

Neues Fenster Untertitel.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Den meisten Fenstern auf oberster Ebene auf einem Windows-basierten Desktop ist ein Titel (Untertitel) zugeordnet. Diese Eigenschaft kann über die IVideoWindow-Schnittstelle abgefragt und festgelegt werden. Alle Untertitel Sätze sind nur sichtbar, wenn auf das Fenster der WS_CAPTION Stil angewendet wurde. Wenn dies nicht der Fall ist, kann die Untertitel weiterhin festgelegt (und abgerufen) werden, obwohl sie für den Benutzer nicht sichtbar ist.

Anforderungen

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

Siehe auch

CBaseControlWindow-Klasse