VisualStyleRenderer.GetPartSize Метод

Определение

Пространство имен:

System.Windows.Forms.VisualStyles

Сборка:

System.Windows.Forms.dll

Возвращает значение заданного свойства размера для текущей части визуального стиля.

Перегрузки

GetPartSize(IDeviceContext, ThemeSizeType)	Возвращает значение заданного свойства размера для текущей части визуального стиля.
GetPartSize(IDeviceContext, Rectangle, ThemeSizeType)	Возвращает значение заданного свойства размера для текущей части визуального стиля, используя указанные границы рисования.

GetPartSize(IDeviceContext, ThemeSizeType)

Возвращает значение заданного свойства размера для текущей части визуального стиля.

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

Параметры

dc

IDeviceContext

Объект IDeviceContext, который будет использоваться при выполнении данной операции.

type

ThemeSizeType

Одно из свойств ThemeSizeType, указывающее, какое значение размера следует извлечь для части.

Возвращаемое значение

Size

Объект Size, содержащий размер, указанный параметром type для текущей части визуального стиля.

Исключения

ArgumentNullException

dc имеет значение null.

InvalidEnumArgumentException

prop не является одним из значений ThemeSizeType .

Примеры

В следующем примере кода показано, как использовать GetPartSize(IDeviceContext, ThemeSizeType) метод в пользовательском элементе управления для получения размеров строки заголовка окна, кнопки закрытия , границ и дескриптора размера, заданного визуальным стилем. Эти размеры используются для вычисления размеров Rectangle объектов, используемых для рисования VisualStyleElement объектов, представляющих эти части окна. Этот пример кода является частью более крупного примера, предоставленного VisualStyleRenderer для обзора класса.

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

Комментарии

Как правило, для type параметра этого метода должны использоваться только True значения и Minimum значения.

GetPartSize(IDeviceContext, Rectangle, ThemeSizeType)

Возвращает значение заданного свойства размера для текущей части визуального стиля, используя указанные границы рисования.

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

Параметры

dc

IDeviceContext

Объект IDeviceContext, который будет использоваться при выполнении данной операции.

bounds

Rectangle

Объект Rectangle представляющий область, в которой будет нарисована часть.

type

ThemeSizeType

Одно из свойств ThemeSizeType, указывающее, какое значение размера следует извлечь для части.

Возвращаемое значение

Size

Объект Size, содержащий размер, указанный параметром type для текущей части визуального стиля.

Исключения

ArgumentNullException

dc имеет значение null.

InvalidEnumArgumentException

prop не является одним из значений ThemeSizeType .