DataFormats.GetFormat 메서드

정의

Windows 클립보드 숫자 ID 및 이름을 포함하는 DataFormats.Format을 반환합니다.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name.

오버로드

GetFormat(Int32)

Windows 클립보드 숫자 ID 및 지정된 ID의 이름을 포함하는 DataFormats.Format을 반환합니다.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified ID.

GetFormat(String)

Windows 클립보드 숫자 ID 및 지정된 형식의 이름을 포함하는 DataFormats.Format을 반환합니다.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified format.

GetFormat(Int32)

Windows 클립보드 숫자 ID 및 지정된 ID의 이름을 포함하는 DataFormats.Format을 반환합니다.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified ID.

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입니다.The format ID.

반환

Windows 클립보드 숫자 ID 및 해당 형식의 이름을 포함하는 DataFormats.Format입니다.A DataFormats.Format that has the Windows Clipboard numeric ID and the name of the format.

예제

다음 코드 예제에서는이 멤버를 사용 하는 방법을 보여 줍니다.The following code example demonstrates the use of this member.

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

설명

이 멤버는 대개 기본 클립보드 형식을 등록 사용 합니다.This member is typically used to register native Clipboard formats.

호출 GetFormat 를 검색 하려는 경우 ID 번호를 사용 하 여를 DataFormats.Format ID/형식 이름 쌍이 포함 된 인스턴스.Call GetFormat with an ID number when you want to retrieve a DataFormats.Format instance that contains the ID/format name pair. ID 이름 및 번호를 사용 하는 애플리케이션의 작성자에 의해 게시 되는 일반적으로 Clipboard 와 인터페이스입니다.Typically, the ID name and number is published by the creator of the application that you are using the Clipboard to interface with. Visual Basic의 데이터 교환 DDE (동적) 대화 정보에 대 한 ID 번호는 예를 들어 &HBF00, 형식 이름은 vbCFLink합니다.For example, the ID number for Dynamic Data Exchange (DDE) conversation information in Visual Basic is &HBF00, and the format name is vbCFLink.

ID/형식 이름 쌍을 추가 하려면 모든 고유한 ID 번호를 사용 하 여이 메서드를 호출 합니다 static 형식 이름/i D 목록에서 쌍을 DataFormats 클래스입니다.Call this method with any unique ID number to add the ID/format name pair to the static list of format name/ID pairs in the DataFormats class. 새 이름은 "Format" 및 ID 번호를 연결 하 여 생성 됩니다.The new name will be created by concatenating "Format" and the ID number. 이 쌍을 새 등록 되지 않은 Clipboard 이름을 제공 하지 않은 때문에 형식을 지정 합니다.This pair is not registered as a new Clipboard format because you have not provided a name.

추가 정보

GetFormat(String)

Windows 클립보드 숫자 ID 및 지정된 형식의 이름을 포함하는 DataFormats.Format을 반환합니다.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified 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

매개 변수

format
String

형식 이름입니다.The format name.

반환

Windows 클립보드 숫자 ID 및 해당 형식의 이름을 포함하는 DataFormats.Format입니다.A DataFormats.Format that has the Windows Clipboard numeric ID and the name of the format.

예외

Clipboard 형식을 등록하지 못한 경우Registering a new Clipboard format failed.

예제

다음 코드 예제를 검색 하는 방법을 보여 줍니다는 DataFormats.Format 형식 이름/i D 쌍을 나타내는입니다.The following code example shows how to retrieve a DataFormats.Format representing a format name/ID pair. 합니다 UnicodeText 형식이 요청 되 고 검색 하 고 검색 내용을 DataFormats.Format 텍스트 상자에 표시 됩니다.The UnicodeText format is requested, and the contents of the retrieved DataFormats.Format are displayed in a text box.

이 코드를 실행 하려면 textBox1 을 인스턴스화해야 합니다.This code requires textBox1 has been instantiated.

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

설명

호출 GetFormat 는 기존 형식에 대 한 Windows 클립보드 숫자 ID를 사용 해야 하는 경우 해당 형식 이름을 사용 합니다.Call GetFormat with the format name when you need a Windows Clipboard numeric ID for an existing format.

이 메서드를 새 형식 이름을 사용자 고유의 Clipboard 형식의 서식을 지정 합니다.Call this method with your own format name to create a new Clipboard format type. 지정된 된 형식의 존재 하지 않는 경우이 메서드는 Windows 레지스트리를 사용 하 여 클립보드 형식으로 이름을 등록 하 고 고유 형식 식별자를 가져옵니다.If the specified format does not exist, this method will register the name as a Clipboard format with the Windows registry and get a unique format identifier. 이 새 이름/i D 쌍에 추가 됩니다는 static 형식 이름/i D 목록에서 쌍을 DataFormats 클래스입니다.This new name/ID pair will be added to the static list of format name/ID pairs in the DataFormats class.

추가 정보

적용 대상