Comando colar

O comando colar copia o conteúdo da área de transferência para o workspace. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

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

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

Lpszitem

Um ou mais dos sinalizadores a seguir.

Valor	Significado
no retângulo	Especifica o local dentro do quadro em que os dados são colados. O canto superior esquerdo do retângulo corresponde ao canto superior esquerdo dos dados adicionados. Se o retângulo tiver um tamanho diferente de zero em X ou Y, o conteúdo da área de transferência será dimensionado nessas dimensões quando eles forem colados no quadro. Se omitido, o retângulo usará como padrão todo o quadro. Se esse sinalizador for especificado no modo "insert" (o padrão), qualquer região fora do retângulo será pintada com uma cor sólida.
fluxo de fluxo de áudio	Especifica o fluxo de áudio no workspace afetado pelo comando . Se apenas um fluxo de áudio existir na área de transferência, os dados de áudio serão colados no fluxo designado. Se houver mais de um fluxo de áudio na área de transferência, o fluxo indicará o número inicial das sequências de fluxo. Se você usar esse sinalizador e também quiser colar o vídeo, também deverá usar o sinalizador "fluxo de vídeo". (Se nenhum sinalizador for especificado, todos os fluxos de áudio e vídeo serão colados e manterão seus números de fluxo originais.)
insert	Especifica que os dados são inseridos no workspace. Todos os dados após o ponto de inserção são movidos para frente no workspace para abrir espaço. Esse é o valor padrão.
overwrite	Especifica que os dados são copiados para o workspace gravando todos os dados existentes após o ponto de inserção. Os sinalizadores "inserir" e "substituir" afetam se os quadros são destruídos ou movidos durante a operação de colagem, não como os dados são colados em cada quadro.
para posicionar	Especifica a posição no workspace no qual os dados são colados. Se omitido, ele usará como padrão a posição atual.
fluxo de vídeo	Especifica o fluxo de vídeo no workspace afetado pelo comando . Se apenas um fluxo de vídeo existir na área de transferência, os dados de vídeo serão colados no fluxo designado. Se houver mais de um fluxo de vídeo na área de transferência, o fluxo indicará o número inicial das sequências de fluxo. Se você usar esse sinalizador e também quiser colar áudio, também deverá usar o sinalizador "fluxo de áudio". (Se nenhum sinalizador for especificado, todos os fluxos de áudio e vídeo serão colados e manterão seus números de fluxo originais.)

lpszFlags

Pode ser "wait", "notify", "test" ou uma combinação delas. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

Nenhum sinal está presente nos dados copiados da área de transferência. A alteração se torna permanente somente quando os dados são salvos explicitamente; no entanto, a reprodução atua como se os dados foram adicionados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

MCI

Cadeias de caracteres de comando MCI