DataFormats.GetFormat メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

Windows クリップボード数値 ID および名前と共に DataFormats.Format を返します。

オーバーロード

GetFormat(Int32)	Windows クリップボード数値 ID および指定された ID の名前と共に DataFormats.Format を返します。
GetFormat(String)	Windows クリップボード数値 ID および指定されたフォーマット名と共に DataFormats.Format を返します。

GetFormat(Int32)

Windows クリップボード数値 ID および指定された ID の名前と共に DataFormats.Format を返します。

public:
 static System::Windows::Forms::DataFormats::Format ^ GetFormat(int id);

public static System.Windows.Forms.DataFormats.Format GetFormat (int id);

static member GetFormat : int -> System.Windows.Forms.DataFormats.Format

Public Shared Function GetFormat (id As Integer) As DataFormats.Format

パラメーター

id

Int32

形式 ID

戻り値

DataFormats.Format

Windows クリップボード数値 ID と形式名を持つ DataFormats.Format。

例

次のコード例では、このメンバーの使用方法を示します。

using namespace System;
using namespace System::Windows::Forms;
int main()
{
   
   // Create a DataFormats::Format for the Unicode data format.
   DataFormats::Format^ myFormat = DataFormats::GetFormat( 13 );
   
   // Display the contents of myFormat.
   Console::WriteLine( "The Format Name corresponding to the ID {0} is :", myFormat->Id );
   Console::WriteLine( myFormat->Name );
}

using System;
using System.Windows.Forms;

   public class DataFormat_GetFormat
   {
      static void Main()
      {

         // Create a DataFormats.Format for the Unicode data format.
         DataFormats.Format myFormat = DataFormats.GetFormat(13);

         // Display the contents of myFormat.
         Console.WriteLine("The Format Name corresponding to the ID "+myFormat.Id+" is :");
         Console.WriteLine(myFormat.Name);
      }
   }

Imports System.Windows.Forms

Public Class DataFormat_GetFormat
   
   Shared Sub Main()
      
     ' Create a DataFormats.Format for the Unicode data format.

      Dim myFormat As DataFormats.Format = DataFormats.GetFormat(13)

      ' Display the contents of myFormat.

      Console.WriteLine(("The Format Name corresponding to the ID " + myFormat.Id.ToString + " is :"))
      Console.WriteLine(myFormat.Name)

   End Sub

End Class

注釈

このメンバーは、通常、ネイティブのクリップボード形式を登録するために使用されます。

ID/形式名のペアを含むインスタンスを取得DataFormats.Formatする場合は、ID 番号を使用して を呼び出GetFormatします。 通常、ID 名と番号は、 を使用してインターフェイスを設定 Clipboard しているアプリケーションの作成者によって発行されます。 たとえば、Visual Basic の動的データ交換 (DDE) 会話情報の ID 番号は &HBF00で、形式名は です vbCFLink。

このメソッドを任意の一意の ID 番号で呼び出して、 クラスの形式名と ID のペアの一覧に static ID/形式名のペアを DataFormats 追加します。 新しい名前は、"Format" と ID 番号を連結して作成されます。 名前を指定していないため、このペアは新しい Clipboard 形式として登録されません。

こちらもご覧ください

• DataFormats.Format

GetFormat(String)

Windows クリップボード数値 ID および指定されたフォーマット名と共に DataFormats.Format を返します。

public:
 static System::Windows::Forms::DataFormats::Format ^ GetFormat(System::String ^ format);

public static System.Windows.Forms.DataFormats.Format GetFormat (string format);

static member GetFormat : string -> System.Windows.Forms.DataFormats.Format

Public Shared Function GetFormat (format As String) As DataFormats.Format

パラメーター

format

String

形式名

戻り値

DataFormats.Format

Windows クリップボード数値 ID と形式名を持つ DataFormats.Format。

例外

ArgumentException

.NET 5 以降のバージョン: format は null、、 Emptyまたは空白です。

Win32Exception

新しい Clipboard 形式の登録に失敗しました。

例

次のコード例は、形式名と ID のペアを表す を取得 DataFormats.Format する方法を示しています。 UnicodeText形式が要求され、取得した DataFormats.Format の内容がテキスト ボックスに表示されます。

このコードがインスタンス化されている必要 textBox1 があります。

private:
   void GetMyFormatInfomation()
   {
      // Creates a DataFormats.Format for the Unicode data format.
      DataFormats::Format^ myFormat = DataFormats::GetFormat(
         DataFormats::UnicodeText );
      
      // Displays the contents of myFormat.
      textBox1->Text = String::Format( "ID value: {0}\nFormat name: {1}",
         myFormat->Id, myFormat->Name );
   }

private void GetMyFormatInfomation() {
   // Creates a DataFormats.Format for the Unicode data format.
   DataFormats.Format myFormat = DataFormats.GetFormat(DataFormats.UnicodeText);

   // Displays the contents of myFormat.
   textBox1.Text = "ID value: " + myFormat.Id + '\n' +
      "Format name: " + myFormat.Name;
}

Private Sub GetMyFormatInfomation()
    ' Creates a DataFormats.Format for the Unicode data format.
    Dim myFormat As DataFormats.Format = _
       DataFormats.GetFormat(DataFormats.UnicodeText)
       
    ' Displays the contents of myFormat.
    textBox1.Text = "ID value: " + myFormat.Id.ToString() + ControlChars.Cr _
                  + "Format name: " + myFormat.Name
End Sub

注釈

既存の形式に Windows クリップボードの数値 ID が必要な場合は、形式名で を呼び出 GetFormat します。

このメソッドを独自の形式名で呼び出して、新 Clipboard しい書式の種類を作成します。 指定した形式が存在しない場合、このメソッドは名前をクリップボード形式として Windows レジストリに登録し、一意の形式識別子を取得します。 この新しい名前と ID のペアは、 クラスの static 形式名と ID のペアの一覧に DataFormats 追加されます。

こちらもご覧ください

• DataFormats.Format