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)

ソース:

DataFormats.cs

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)

ソース:

DataFormats.cs

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