DataFormats.GetFormat Methode

Definition

Gibt eine DataFormats.Format mit der numerischen ID und dem Namen der Windows Zwischenablage zurück.

Überlädt

Name Beschreibung
GetFormat(Int32)

Gibt eine DataFormats.Format mit der numerischen WINDOWS-ID der Zwischenablage und dem Namen für die angegebene ID zurück.

GetFormat(String)

Gibt eine DataFormats.Format mit der numerischen WINDOWS-ID und dem Namen der Zwischenablage für das angegebene Format zurück.

GetFormat(Int32)

Quelle:
DataFormats.cs
Quelle:
DataFormats.cs
Quelle:
DataFormats.cs
Quelle:
DataFormats.cs
Quelle:
DataFormats.cs

Gibt eine DataFormats.Format mit der numerischen WINDOWS-ID der Zwischenablage und dem Namen für die angegebene ID zurück.

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

Parameter

id
Int32

Die Format-ID.

Gibt zurück

Eine DataFormats.Format mit der numerischen WINDOWS-ID der Zwischenablage und dem Namen des Formats.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Elements veranschaulicht.

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

Hinweise

Dieses Element wird in der Regel verwendet, um systemeigene Zwischenablageformate zu registrieren.

Rufen Sie einen Anruf GetFormat mit einer ID-Nummer auf, wenn Sie eine DataFormats.Format Instanz abrufen möchten, die das ID/Format-Namenspaar enthält. In der Regel wird der ID-Name und die Nummer vom Ersteller der Anwendung veröffentlicht, mit der Sie die Clipboard Schnittstelle verwenden. Beispielsweise ist die ID-Nummer für DDE-Unterhaltungsinformationen (Dynamic Data Exchange) in Visual Basic &HBF00, und der Formatname ist vbCFLink.

Rufen Sie diese Methode mit einer beliebigen eindeutigen ID-Nummer auf, um das ID/Format-Namenspaar der static Liste der Formatnamen/ID-Paare in der DataFormats Klasse hinzuzufügen. Der neue Name wird erstellt, indem "Format" und die ID-Nummer verkettet werden. Dieses Paar wird nicht als neues Clipboard Format registriert, da Sie keinen Namen angegeben haben.

Weitere Informationen

Gilt für:

GetFormat(String)

Quelle:
DataFormats.cs
Quelle:
DataFormats.cs
Quelle:
DataFormats.cs
Quelle:
DataFormats.cs
Quelle:
DataFormats.cs

Gibt eine DataFormats.Format mit der numerischen WINDOWS-ID und dem Namen der Zwischenablage für das angegebene Format zurück.

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

Parameter

format
String

Der Formatname.

Gibt zurück

Eine DataFormats.Format mit der numerischen WINDOWS-ID der Zwischenablage und dem Namen des Formats.

Ausnahmen

.NET 5 und höhere Versionen: format ist null, Empty oder Leerzeichen.

Fehler beim Registrieren eines neuen Clipboard Formats.

Beispiele

Das folgende Codebeispiel zeigt, wie ein DataFormats.Format Formatname/ID-Paar abgerufen wird. Das UnicodeText Format wird angefordert, und der Inhalt des abgerufenen DataFormats.Format Elements wird in einem Textfeld angezeigt.

Dieser Code muss textBox1 instanziiert werden.

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

Hinweise

Rufen Sie GetFormat mit dem Formatnamen auf, wenn Sie eine Windows numerische ID der Zwischenablage für ein vorhandenes Format benötigen.

Rufen Sie diese Methode mit Ihrem eigenen Formatnamen auf, um einen neuen Clipboard Formattyp zu erstellen. Wenn das angegebene Format nicht vorhanden ist, registriert diese Methode den Namen als Zwischenablageformat bei der Windows Registrierung und ruft einen eindeutigen Formatbezeichner ab. Dieses neue Name/ID-Paar wird der static Liste der Formatnamen/ID-Paare in der DataFormats Klasse hinzugefügt.

Weitere Informationen

Gilt für: