VisualStyleRenderer.GetPartSize Methode

Definition

Namespace:: System.Windows.Forms.VisualStyles

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.

Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Formatvorlagenteils zurück.

Überlädt

Name	Beschreibung
GetPartSize(IDeviceContext, ThemeSizeType)	Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Formatvorlagenteils zurück.
GetPartSize(IDeviceContext, Rectangle, ThemeSizeType)	Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Formatvorlagenteils mithilfe der angegebenen Zeichnungsgrenzen zurück.

GetPartSize(IDeviceContext, ThemeSizeType)

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Formatvorlagenteils zurück.

public:
 System::Drawing::Size GetPartSize(System::Drawing::IDeviceContext ^ dc, System::Windows::Forms::VisualStyles::ThemeSizeType type);

public System.Drawing.Size GetPartSize(System.Drawing.IDeviceContext dc, System.Windows.Forms.VisualStyles.ThemeSizeType type);

member this.GetPartSize : System.Drawing.IDeviceContext * System.Windows.Forms.VisualStyles.ThemeSizeType -> System.Drawing.Size

Public Function GetPartSize (dc As IDeviceContext, type As ThemeSizeType) As Size

Parameter

dc: IDeviceContext

Dieser IDeviceContext Vorgang wird verwendet.

type: ThemeSizeType

Einer der ThemeSizeType Werte, der angibt, welcher Größenwert für den Teil abgerufen werden soll.

Gibt zurück

Size

Eine Size , die die durch den type Parameter für den aktuellen visuellen Formatvorlagenteil angegebene Größe enthält.

Ausnahmen

ArgumentNullException

dc ist null.

InvalidEnumArgumentException

prop ist keiner der ThemeSizeType Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetPartSize(IDeviceContext, ThemeSizeType) Methode in einem benutzerdefinierten Steuerelement verwendet wird, um die Größen einer Fenstertitelleiste, schaltfläche schließen , Rahmen und Ziehpunkt abzurufen, die durch die visuelle Formatvorlage angegeben werden. Diese Größen werden verwendet, um die Größen der Rectangle Objekte zu berechnen, die zum Zeichnen der Objekte verwendet werden, die VisualStyleElement diese Fensterteile darstellen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die VisualStyleRenderer Klassenübersicht bereitgestellt wird.

    // Get the sizes and offsets for the window parts as specified
    // by the visual style.
private:
    void GetPartDetails()
    {
        // Do nothing further if visual styles are not enabled.
        if (!Application::RenderWithVisualStyles)
        {
            return;
        }

        Graphics^ g = this->CreateGraphics();

        // Get the size and offset of the close button.
        if (SetRenderer(windowElements["windowClose"]))
        {
            closeButtonSize =
                renderer->GetPartSize(g, ThemeSizeType::True);
            closeButtonOffset =
                renderer->GetPoint(PointProperty::Offset);
        }

        // Get the height of the window caption.
        if (SetRenderer(windowElements["windowCaption"]))
        {
            captionHeight = renderer->GetPartSize(g,
                ThemeSizeType::True).Height;
        }

        // Get the thickness of the left, bottom,
        // and right window frame.
        if (SetRenderer(windowElements["windowLeft"]))
        {
            frameThickness = renderer->GetPartSize(g,
                ThemeSizeType::True).Width;
        }

        // Get the size of the resizing gripper.
        if (SetRenderer(windowElements["statusGripper"]))
        {
            gripperSize = renderer->GetPartSize(g,
                ThemeSizeType::True);
        }

    }

// Get the sizes and offsets for the window parts as specified  
// by the visual style.
private void GetPartDetails()
{
    // Do nothing further if visual styles are not enabled.
    if (!Application.RenderWithVisualStyles)
    {
        return;
    }

    using (Graphics g = this.CreateGraphics())
    {
        // Get the size and offset of the close button.
        if (SetRenderer(windowElements["windowClose"]))
        {
            closeButtonSize =
                renderer.GetPartSize(g, ThemeSizeType.True);
            closeButtonOffset =
                renderer.GetPoint(PointProperty.Offset);
        }

        // Get the height of the window caption.
        if (SetRenderer(windowElements["windowCaption"]))
        {
            captionHeight = renderer.GetPartSize(g,
                ThemeSizeType.True).Height;
        }

        // Get the thickness of the left, bottom, 
        // and right window frame.
        if (SetRenderer(windowElements["windowLeft"]))
        {
            frameThickness = renderer.GetPartSize(g,
                ThemeSizeType.True).Width;
        }

        // Get the size of the resizing gripper.
        if (SetRenderer(windowElements["statusGripper"]))
        {
            gripperSize = renderer.GetPartSize(g,
                ThemeSizeType.True);
        }
    }
}

' Get the sizes and offsets for the window parts as specified 
' by the visual style.
Private Sub GetPartDetails()
    ' Do nothing further if visual styles are not enabled.
    If Not Application.RenderWithVisualStyles Then
        Return
    End If

    Using g As Graphics = Me.CreateGraphics()
        ' Get the size and offset of the close button.
        If SetRenderer(windowElements("windowClose")) Then
            closeButtonSize = _
                renderer.GetPartSize(g, ThemeSizeType.True)
            closeButtonOffset = _
                renderer.GetPoint(PointProperty.Offset)
        End If

        ' Get the height of the window caption.
        If SetRenderer(windowElements("windowCaption")) Then
            captionHeight = renderer.GetPartSize(g, _
                ThemeSizeType.True).Height
        End If

        ' Get the thickness of the left, bottom, and right 
        ' window frame.
        If SetRenderer(windowElements("windowLeft")) Then
            frameThickness = renderer.GetPartSize(g, _
                ThemeSizeType.True).Width
        End If

        ' Get the size of the resizing gripper.
        If SetRenderer(windowElements("statusGripper")) Then
            gripperSize = renderer.GetPartSize(g, _
                ThemeSizeType.True)
        End If
    End Using
End Sub

Hinweise

Normalerweise sollten nur die True Werte und Minimum Werte für den type Parameter dieser Methode verwendet werden.

Gilt für:

GetPartSize(IDeviceContext, Rectangle, ThemeSizeType)

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Formatvorlagenteils mithilfe der angegebenen Zeichnungsgrenzen zurück.

public:
 System::Drawing::Size GetPartSize(System::Drawing::IDeviceContext ^ dc, System::Drawing::Rectangle bounds, System::Windows::Forms::VisualStyles::ThemeSizeType type);

public System.Drawing.Size GetPartSize(System.Drawing.IDeviceContext dc, System.Drawing.Rectangle bounds, System.Windows.Forms.VisualStyles.ThemeSizeType type);

member this.GetPartSize : System.Drawing.IDeviceContext * System.Drawing.Rectangle * System.Windows.Forms.VisualStyles.ThemeSizeType -> System.Drawing.Size

Public Function GetPartSize (dc As IDeviceContext, bounds As Rectangle, type As ThemeSizeType) As Size