comando incolla

Il comando incolla copia il contenuto degli Appunti nell'area di lavoro. I dispositivi digital-video riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

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

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato quando il dispositivo viene aperto.

lpszItem

Uno o più flag seguenti.

Valore	Significato
in rettangolo	Specifica la posizione all'interno del frame in cui vengono incollati i dati. L'angolo superiore sinistro del rettangolo corrisponde all'angolo superiore sinistro dei dati aggiunti. Se il rettangolo ha una dimensione diversa da zero in X o Y, il contenuto degli Appunti viene ridimensionato in tali dimensioni quando vengono incollati nella cornice. Se omesso, il rettangolo viene predefinito per l'intero frame. Se questo flag viene specificato in modalità "insert" (impostazione predefinita), qualsiasi area all'esterno del rettangolo viene dipinta un colore a tinta unita.
Flusso di flusso audio	Specifica il flusso audio nell'area di lavoro interessato dal comando. Se esiste un solo flusso audio negli Appunti, i dati audio vengono incollati nel flusso designato. Se sono presenti più flussi audio negli Appunti, il flusso indica il numero iniziale per le sequenze di flusso. Se si usa questo flag e si vuole anche incollare il video, è necessario usare anche il flag "flusso video". Se non viene specificato alcun flag, tutti i flussi audio e video vengono incollati e mantengono i numeri di flusso originali.
insert	Specifica che i dati vengono inseriti nell'area di lavoro. Tutti i dati dopo lo spostamento del punto di inserimento nell'area di lavoro per rendere la stanza. Si tratta del valore predefinito.
overwrite	Specifica che i dati vengono copiati nell'area di lavoro scrivendo su tutti i dati esistenti dopo il punto di inserimento. I flag "insert" e "overwrite" influiscono sul fatto che i fotogrammi vengano eliminati o spostati durante l'operazione di incolla, non il modo in cui i dati vengono incollati all'interno di ogni frame.
per posizionare	Specifica la posizione nell'area di lavoro in cui vengono incollati i dati. Se omesso, il valore predefinito viene impostato sulla posizione corrente.
flusso video	Specifica il flusso video nell'area di lavoro interessato dal comando. Se esiste un solo flusso video negli Appunti, i dati video vengono incollati nel flusso designato. Se sono presenti più flussi video negli Appunti, il flusso indica il numero iniziale per le sequenze di flusso. Se si usa questo flag e si vuole anche incollare l'audio, è necessario usare anche il flag "flusso audio". Se non viene specificato alcun flag, tutti i flussi audio e video vengono incollati e mantengono i numeri di flusso originali.

lpszFlags

Può essere "wait", "notify", "test" o una combinazione di queste. Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Non sono presenti segnali nei dati copiati dagli Appunti. La modifica diventa permanente solo quando i dati vengono salvati in modo esplicito; tuttavia, la riproduzione agisce come se i dati siano stati aggiunti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI