IDataObject.GetDataPresent メソッド (String)

インスタンスに格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。

Function GetDataPresent( _
   ByVal format As String _) As Boolean
[C#]
bool GetDataPresent(
   stringformat);
[C++]
bool GetDataPresent(
   String* format);
[JScript]
function GetDataPresent(
   format : String) : Boolean;

パラメータ

• format
  確認対象の形式。定義済みの形式については、 DataFormats のトピックを参照してください。

戻り値

インスタンスに格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true 。それ以外の場合は false 。

解説

DataObject に形式が格納されているかどうかを確認するには、 GetData を呼び出す前に、このメソッドを呼び出します。インスタンスで使用できる形式を取得するには、 GetFormats を呼び出します。

メモ   形式変換を有効にしてデータが格納されている場合、要求した形式が、格納されている形式と互換性があれば、そのデータを別の形式に変換できます。たとえば、Unicode として格納されたデータをテキストに変換できます。

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

使用例

[Visual Basic, C#, C++] この例では、 IDataObject を実装する DataObject クラスを使用して GetDataPresent メソッドの使用法を示します。最初に、文字列および Text 形式を使用してデータ オブジェクトを作成します。次に、データが Text 形式で表されているかどうかを検査し、結果をメッセージ ボックスに表示します。この例は、 Form1 という名前の Form を作成済みであることを前提にしています。

 
Private Sub TestDataObject()
    ' Creates a new data object using a string and the Text format.
    Dim myString As New String("Hello World!")
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Checks whether the data is present in the Text format and displays the result.
    If (myDataObject.GetDataPresent(DataFormats.Text)) Then
        MessageBox.Show("The stored data is in the Text format.", "Test Result")
    Else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result")
    End If
End Sub 'TestDataObject

[C#] 
private void TestDataObject() 
{
    // Creates a new data object using a string and the Text format.
    string myString = "Hello World!";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Checks whether the data is present in the Text format and displays the result.
    if (myDataObject.GetDataPresent(DataFormats.Text))
        MessageBox.Show("The stored data is in the Text format." , "Test Result");
    else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result");
}

[C++] 
private:
    void TestDataObject() {
        // Creates a new data object using a string and the Text format.
        String* myString = S"Hello World!";
        DataObject* myDataObject = new DataObject(DataFormats::Text, myString);

        // Checks whether the data is present in the Text format and displays the result.
        if (myDataObject->GetDataPresent(DataFormats::Text))
            MessageBox::Show(S"The stored data is in the Text format." , S"Test Result");
        else
            MessageBox::Show(S"The stored data is not in the Text format.", S"Test Result");
    }

[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 インターフェイス | IDataObject メンバ | System.Windows.Forms 名前空間 | IDataObject.GetDataPresent オーバーロードの一覧 | IDataObject.SetData | IDataObject.GetData | DataObject.GetDataPresent