Befehl "einfügen"

Artikel
06/13/2023

Der Befehl zum Einfügen kopiert den Inhalt der Zwischenablage in den Arbeitsbereich. Digital-Video-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("paste %s %s %s"), 
  lpszDeviceID, 
  lpszItem, 
  lpszFlags
);

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszItem

Mindestens eins der folgenden Flags.

Wert	Bedeutung
im Rechteck	Gibt den Speicherort innerhalb des Frames an, an dem die Daten eingefügt werden. Die obere linke Ecke des Rechtecks entspricht der oberen linken Ecke der hinzugefügten Daten. Wenn das Rechteck eine Größe ungleich Null in X oder Y aufweist, wird der Inhalt der Zwischenablage in diesen Dimensionen skaliert, wenn sie in den Frame eingefügt werden. Wenn die Angabe weggelassen wird, ist das Rechteck standardmäßig auf den gesamten Frame festgelegt. Wenn dieses Flag im "Einfügen"-Modus (Standard) angegeben wird, wird jeder Bereich außerhalb des Rechtecks mit einer Volltonfarbe gezeichnet.
Audiostreamstream	Gibt den Audiodatenstrom im Arbeitsbereich an, der vom Befehl betroffen ist. Wenn nur ein Audiodatenstrom in der Zwischenablage vorhanden ist, werden die Audiodaten in den angegebenen Stream eingefügt. Wenn mehrere Audiodatenströme in der Zwischenablage vorhanden sind, gibt der Stream die Startnummer für die Streamsequenzen an. Wenn Sie dieses Flag verwenden und auch Video einfügen möchten, müssen Sie auch das Flag "Videostream" verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme eingefügt und behalten ihre ursprünglichen Datenstromnummern bei.)
insert	Gibt an, dass die Daten in den Arbeitsbereich eingefügt werden. Alle Daten nach der Einfügemarke werden im Arbeitsbereich nach vorne verschoben, um Platz zu schaffen. Dies ist der Standardwert.
overwrite	Gibt an, dass die Daten in den Arbeitsbereich kopiert werden, indem alle vorhandenen Daten nach der Einfügemarke überschreiben. Die Flags "einfügen" und "überschreiben" beeinflussen, ob Frames während des Einfügevorgangs zerstört oder verschoben werden, und nicht, wie die Daten in jeden Frame eingefügt werden.
zu positionieren	Gibt die Position im Arbeitsbereich an, an der die Daten eingefügt werden. Wenn sie nicht angegeben wird, wird standardmäßig die aktuelle Position verwendet.
Videostreamstream	Gibt den Videostream im Arbeitsbereich an, der vom Befehl betroffen ist. 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 Flag "Audiostream" verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme eingefügt und behalten ihre ursprünglichen Datenstromnummern bei.)

lpszFlags

Dies kann "Wait", "notify", "test" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

In den aus der Zwischenablage kopierten Daten sind keine Signale vorhanden. Die Änderung wird nur dann dauerhaft, wenn die Daten explizit gespeichert werden; Die Wiedergabe funktioniert jedoch so, als ob die Daten hinzugefügt wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI
MCI-Befehlszeichenfolgen

Freigeben über