VisualStyleRenderer.GetPartSize Methode

Definition

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

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

Überlädt

GetPartSize(IDeviceContext, ThemeSizeType)	Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Stilteils zurück.
GetPartSize(IDeviceContext, Rectangle, ThemeSizeType)	Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Stilteils unter Verwendung der angegebenen Begrenzungen für das Zeichnen zurück.

GetPartSize(IDeviceContext, ThemeSizeType)

Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Stilteils 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

Die IDeviceContext, die von diesem Vorgang verwendet wird.

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 vom type-Parameter für den aktuellen visuellen Stilteil 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, der Schaltfläche Schließen , der Rahmen und des Größenziehpunkts abzurufen, die vom visuellen Stil angegeben werden. Diese Größen werden verwendet, um die Größen der Objekte zu berechnen, die Rectangle zum Zeichnen der Objekte verwendet werden, die VisualStyleElement diese Fensterteile darstellen. Dieses Codebeispiel ist Teil eines größeren Beispiels für die VisualStyleRenderer Klassenübersicht.

    // 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

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

GetPartSize(IDeviceContext, Rectangle, ThemeSizeType)

Gibt den Wert der angegebenen Größeneigenschaft des aktuellen visuellen Stilteils unter Verwendung der angegebenen Begrenzungen für das Zeichnen 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

Parameter

dc

IDeviceContext

Die IDeviceContext, die von diesem Vorgang verwendet wird.

bounds

Rectangle

Ein Rectangle, das den Bereich enthält, in dem der Teil gezeichnet wird.

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 vom type-Parameter für den aktuellen visuellen Stilteil angegebene Größe enthält.

Ausnahmen

ArgumentNullException

dc ist null.

InvalidEnumArgumentException

prop ist keiner der ThemeSizeType -Werte.