OSFeature.IsPresent(SystemParameter) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Ruft einen Wert ab, der angibt, ob das Betriebssystem das angegebene Feature oder die angegebene Metrik unterstützt.

public:
 static bool IsPresent(System::Windows::Forms::SystemParameter enumVal);

public static bool IsPresent (System.Windows.Forms.SystemParameter enumVal);

static member IsPresent : System.Windows.Forms.SystemParameter -> bool

Public Shared Function IsPresent (enumVal As SystemParameter) As Boolean

Parameter

enumVal: SystemParameter

Ein SystemParameter, der das zu suchende Feature darstellt.

Gibt zurück

Boolean

true, wenn das Feature im System verfügbar ist, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die IsPresent Methode mit der SystemParameter Enumeration verwenden. Das Beispiel bestimmt, ob das Betriebssystem die Metrik unterstützt, bevor die CaretWidth SystemInformation.CaretWidth Eigenschaft aufgerufen wird.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Gets the caret width based upon the operating system or default value.
int GetCaretWidth()
{
   // Check to see if the operating system supports the caret width metric. 
   if ( OSFeature::Feature->IsPresent( SystemParameter::CaretWidthMetric ) )
   {
      // If the operating system supports this metric,
      // return the value for the caret width metric. 
      return SystemInformation::CaretWidth;
   }
   else
         1;

   // If the operating system does not support this metric,
   // return a custom default value for the caret width.
}

// Gets the caret width based upon the operating system or default value.
private int GetCaretWidth ()
{    

    // Check to see if the operating system supports the caret width metric. 
    if (OSFeature.IsPresent(SystemParameter.CaretWidthMetric))
    {

        // If the operating system supports this metric,
        // return the value for the caret width metric. 

        return SystemInformation.CaretWidth;
    } else
    {

        // If the operating system does not support this metric,
        // return a custom default value for the caret width.

        return 1;
    }
}

' Gets the caret width based upon the operating system or default value.
Private Function GetCaretWidth() As Integer

    ' Check to see if the operating system supports the caret width metric. 
    If OSFeature.IsPresent(SystemParameter.CaretWidthMetric) Then

        ' If the operating system supports this metric,
        ' return the value for the caret width metric. 

        Return SystemInformation.CaretWidth
    Else

        ' If the operating system does not support this metric,
        ' return a custom default value for the caret width.

        Return 1
    End If
End Function

Hinweise

In der Regel verwenden Sie die Methode, um festzustellen, ob das Betriebssystem die IsPresent spezifische Funktion oder Metrik unterstützt, die durch enumValueidentifiziert wird. Basierend auf dem von Ihnen zurückgegebenen IsPresentWert würden Sie bedingte Aktionen in Ihrem Code ausführen. Wenn Sie diese Methode beispielsweise mit einem Parameterwert von FlatMenu Rückgaben trueaufrufen, können Sie besitzergezeichnete Menüs in Ihrer Anwendung in einer flachen Formatvorlage erstellen.

Der Zugriff auf einige Systemfeatures oder Metriken kann Ausnahmen auslösen, wenn sie auf einer bestimmten Betriebssystemversion nicht verfügbar sind. In diesem Fall verwenden Sie zuerst den entsprechenden SystemParameter Enumerationswert zusammen mit IsPresent, um festzustellen, ob die Metrik unterstützt wird. Rufen Sie IsPresent CaretWidth beispielsweise vor dem Abrufen des Eigenschaftswerts auf SystemInformation.CaretWidth .

Gilt für

Teilen über