befehl MCI_PASTE
Der befehl MCI_PASTE fügt Daten aus der Zwischenablage in eine Datei ein. Digital-Videogeräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_PASTE,
DWORD dwFlags,
(DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT oder MCI_TEST. Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.
-
lpPaste
-
Zeiger auf eine MCI_ DGV_ PASTE_ PARMS-Struktur .
Rückgabewert
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
Bemerkungen
Die folgenden zusätzlichen Flags gelten für Digital-Video-Geräte:
-
MCI_DGV_PASTE_AT
-
Ein Rechteck ist im rc-Member der durch lpPaste identifizierten Struktur enthalten. Die ersten beiden Werte des Rechtecks geben den Punkt innerhalb des Rahmens an, um die Zwischenablageinformationen zu platzieren. Wenn die Höhe und Breite des Rechtecks nicht zero sind, werden die Zwischenablageinhalte auf diese Dimensionen skaliert, wenn sie in den Rahmen eingefügt werden. Wenn das Flag nicht angegeben wird, wird MCI_PASTE standardmäßig auf das gesamte Framerechteck festgelegt.
-
MCI_DGV_PASTE_AUDIO_STREAM
-
Eine Audiostreamnummer ist im dwAudioStream-Member der durch lpPaste identifizierten Struktur enthalten. Wenn nur ein Audiostream in der Zwischenablage vorhanden ist, werden die Audiodaten in den angegebenen Stream eingefügt. Wenn mehr als ein Audiostream in der Zwischenablage vorhanden ist, gibt der Stream die Startnummer für die Streamsequenzen an. Wenn Sie dieses Flag verwenden und auch ein Video einfügen möchten, müssen Sie auch das MCI_DGV_PASTE_VIDEO_STREAM-Flag verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme ab dem ersten Audio- und Videostream eingefügt. Jeder eingefügte Stream behält seine ursprüngliche Streamnummer bei.)
-
MCI_DGV_PASTE_INSERT
-
Zwischenablagedaten sollten in den vorhandenen Arbeitsbereich an der durch das flag MCI_TO angegebenen Position eingefügt werden. Alle nach der Einfügemarke vorhandenen Daten werden in den Arbeitsbereich verschoben, um Platz zu schaffen. Dies ist die Standardeinstellung.
-
MCI_DGV_PASTE_OVERWRITE
-
Zwischenablagedaten sollten daten ersetzen, die bereits im Arbeitsbereich vorhanden sind. Die ersetzten Arbeitsbereichsdaten folgen der Einfügemarke.
-
MCI_DGV_PASTE_VIDEO_STREAM
-
Eine Videostreamnummer ist im dwVideoStream-Member der durch lpPaste identifizierten Struktur enthalten. Wenn nur ein Videostream in der Zwischenablage vorhanden ist, werden die Videodaten in den angegebenen Stream eingefügt. Wenn mehr als ein Videostream in der Zwischenablage vorhanden ist, gibt der Stream die Startnummer für die Streamsequenzen an. Wenn Sie dieses Flag verwenden und auch Audio einfügen möchten, müssen Sie auch das MCI_DGV_PASTE_AUDIO_STREAM-Flag verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme ab dem ersten Audio- und Videostream eingefügt. Jeder eingefügte Stream behält seine ursprüngliche Streamnummer bei.)
-
MCI_TO
-
Ein Positionswert ist im dwTo-Element der durch lpPaste identifizierten Struktur enthalten. Der Positionswert gibt die Position an, an der Daten in den Arbeitsbereich eingefügt werden sollen. Wenn dieses Flag weggelassen wird, wird die Position standardmäßig auf die aktuelle Position festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|