IDataObject.SetData メソッド (String, Boolean, Object)

2008-03-28

指定されているデータおよびそのデータに関連付けられている形式をインスタンスに格納します。データを別の形式に変換できるかどうかを確認するためにブール値を使用します。

Sub SetData( _
   ByVal format As String, _   ByVal autoConvert As Boolean, _   ByVal data As Object _)
[C#]
void SetData(
   stringformat,boolautoConvert,objectdata);
[C++]
void SetData(
   String* format,boolautoConvert,Object* data);
[JScript]
function SetData(
   format : String,autoConvert : Boolean,data : Object);

パラメータ

format
データに関連付けられている形式。定義済みの形式については、 DataFormats のトピックを参照してください。
autoConvert
データを別の形式に変換できるようにする場合は true 。それ以外の場合は false 。
data
格納するデータ。

解説

データを取り出す側のアプリケーションの形式が不明な場合は、このメソッドを使用して、データを複数の形式で格納しておくことができます。

このメソッドの実装については、 DataObject.SetData のトピックを参照してください。

使用例

[Visual Basic, C#, C++] この例では、 IDataObject を実装する DataObject クラスを使用して、 SetData メソッドの使用法を示します。最初に、データオブジェクト (myDataObject) を作成し、 autoConvert パラメータを false に設定して、 UnicodeText 文字列をこのデータオブジェクトに格納します。次に、オブジェクトに格納されているデータに関連付けられている形式を取得し、結果をメッセージボックスに表示します。データに関連付けられている形式は UnicodeText 形式だけです。この例は、 Form1 という名前の Form を作成済みであることを前提にしています。

 
Private Sub SetData4()
    ' Creates a new data object.
    Dim myDataObject As New DataObject()

    ' Adds UnicodeText string to the object, and set the autoConvert
    ' parameter to false.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My text string")

    ' Gets the data format(s) in the data object.
    Dim arrayOfFormats As [String]() = myDataObject.GetFormats()

    ' Stores the results in a string.
    Dim theResult As String = "The format(s) associated with the data are:" + _
            ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        theResult += arrayOfFormats(i) + ControlChars.Cr
    Next i
    ' Show the results in a message box. 
    MessageBox.Show(theResult)
End Sub 'SetData4 

[C#] 
private void SetData4() 
{
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds UnicodeText string to the object, and set the autoConvert 
    // parameter to false.
    myDataObject.SetData(DataFormats.UnicodeText, false, "My text string");
 
    // Gets the data format(s) in the data object.
    String[] arrayOfFormats = myDataObject.GetFormats();
 
    // Stores the results in a string.
    string theResult = "The format(s) associated with the data are:" + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
        theResult += arrayOfFormats[i] + '\n';
    
    // Show the results in a message box. 
    MessageBox.Show(theResult);

}

[C++] 
private:
    void SetData4() {
        // Creates a new data object.
        DataObject* myDataObject = new DataObject();

        // Adds UnicodeText string to the object, and set the autoConvert
        // parameter to false.
        myDataObject->SetData(DataFormats::UnicodeText, false, S"My text String*");

        // Gets the data format(s) in the data object.
        String*  arrayOfFormats[] = myDataObject->GetFormats();

        // Stores the results in a string.
        String* theResult = S"The format(s) associated with the data are: \n";
        for (int i=0; i<arrayOfFormats->Length; i++)
            theResult = String::Concat(theResult, 
                arrayOfFormats->Item[i], S" \n");

        // Show the results in a message box.
        MessageBox::Show(theResult);

    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

次の方法で共有

IDataObject.SetData メソッド (String, Boolean, Object)

パラメータ

解説

使用例

必要条件

参照

その他のリソース