DataFormats.GetFormat Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.