Clipboard.SetAudio メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

クリップボードをクリアし、データを WaveAudio 形式で追加して、既存のデータを置き換えます。

オーバーロード

SetAudio(Byte[])	クリップボードをクリアし、Byte 配列を WaveAudio に変換してから、Stream 形式で追加します。
SetAudio(Stream)	クリップボードをクリアし、Stream を WaveAudio 形式で追加します。

SetAudio(Byte[])

クリップボードをクリアし、Byte 配列を WaveAudio に変換してから、Stream 形式で追加します。

public:
 static void SetAudio(cli::array <System::Byte> ^ audioBytes);

public static void SetAudio (byte[] audioBytes);

static member SetAudio : byte[] -> unit

Public Shared Sub SetAudio (audioBytes As Byte())

パラメーター

audioBytes

Byte[]

オーディオ データを含んだ Byte 配列。

例外

ExternalException

クリップボードをクリアできませんでした。 この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。

ThreadStateException

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。 アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

ArgumentNullException

audioBytes が nullです。

例

次の例では、このオーバーロードに似た メソッドの SetAudio オーバーロードを示します。

// Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
public System.IO.Stream SwapClipboardAudio(
    System.IO.Stream replacementAudioStream)
{
    System.IO.Stream returnAudioStream = null;
    if (Clipboard.ContainsAudio())
    {
        returnAudioStream = Clipboard.GetAudioStream();
        Clipboard.SetAudio(replacementAudioStream);
    }
    return returnAudioStream;
}

' Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
Public Function SwapClipboardAudio( _
    ByVal replacementAudioStream As System.IO.Stream) _
    As System.IO.Stream

    Dim returnAudioStream As System.IO.Stream = Nothing

    If (Clipboard.ContainsAudio()) Then
        returnAudioStream = Clipboard.GetAudioStream()
        Clipboard.SetAudio(replacementAudioStream)
    End If

    Return returnAudioStream

End Function

注釈

クリップボードからオーディオ データを取得するには、 メソッドを ContainsAudio 使用して取得 GetAudioStream する前に、 メソッドを使用してクリップボードにオーディオ データが含まれているかどうかを判断します。

注意

Clipboard クラスは、STA (シングル スレッド アパートメント) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、お使いの Main メソッドが STAThreadAttribute 属性でマークされているようにします。

こちらもご覧ください

• WaveAudio
• ContainsAudio()
• GetAudioStream()

SetAudio(Stream)

クリップボードをクリアし、Stream を WaveAudio 形式で追加します。

public:
 static void SetAudio(System::IO::Stream ^ audioStream);

public static void SetAudio (System.IO.Stream audioStream);

static member SetAudio : System.IO.Stream -> unit

Public Shared Sub SetAudio (audioStream As Stream)

パラメーター

audioStream

Stream

オーディオ データを含んだ Stream。

例外

ExternalException

クリップボードをクリアできませんでした。 この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。

ThreadStateException

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。 アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

ArgumentNullException

audioStream が nullです。

例

次の例では、このメンバーを示します。

// Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
public System.IO.Stream SwapClipboardAudio(
    System.IO.Stream replacementAudioStream)
{
    System.IO.Stream returnAudioStream = null;
    if (Clipboard.ContainsAudio())
    {
        returnAudioStream = Clipboard.GetAudioStream();
        Clipboard.SetAudio(replacementAudioStream);
    }
    return returnAudioStream;
}

' Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
Public Function SwapClipboardAudio( _
    ByVal replacementAudioStream As System.IO.Stream) _
    As System.IO.Stream

    Dim returnAudioStream As System.IO.Stream = Nothing

    If (Clipboard.ContainsAudio()) Then
        returnAudioStream = Clipboard.GetAudioStream()
        Clipboard.SetAudio(replacementAudioStream)
    End If

    Return returnAudioStream

End Function

注釈

クリップボードからオーディオ データを取得するには、 メソッドを ContainsAudio 使用して取得 GetAudioStream する前に、 メソッドを使用してクリップボードにオーディオ データが含まれているかどうかを判断します。

注意

Clipboard クラスは、STA (シングル スレッド アパートメント) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、お使いの Main メソッドが STAThreadAttribute 属性でマークされているようにします。

こちらもご覧ください

• WaveAudio
• ContainsAudio()
• GetAudioStream()