ToolStripManager.RenderModeとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ToolStripManager.RenderMode プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

フォームの既定のテーマを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Shared Property RenderMode
 As ToolStripManagerRenderMode

Visual Basic (使用法)

Dim value As ToolStripManagerRenderMode

value = ToolStripManager.RenderMode

ToolStripManager.RenderMode = value

public static ToolStripManagerRenderMode RenderMode
 { get; set; }

C++

public:
static property ToolStripManagerRenderMode RenderMode {
    ToolStripManagerRenderMode get ();
    void set (ToolStripManagerRenderMode value);
}

/** @property */
public static ToolStripManagerRenderMode get_RenderMode
 ()

/** @property */
public static void set_RenderMode
 (ToolStripManagerRenderMode value)

JScript

public static function get
 RenderMode () : ToolStripManagerRenderMode

public static function set
 RenderMode (value : ToolStripManagerRenderMode)

プロパティ値
ToolStripManagerRenderMode 値の 1 つ。

例外

例外の種類	条件
InvalidEnumArgumentException	設定された値が、ToolStripManagerRenderMode 値のいずれでもありませんでした。
NotSupportedException	ToolStripManagerRenderMode が Custom に設定されています。代わりに、Renderer プロパティを使用してください。

解説

アプリケーションの描画に使用するレンダラ (ToolStripProfessionalRenderer、ToolStripSystemRenderer、カスタマイズされた ToolStripRenderer のいずれか) を取得または設定するには、RenderMode プロパティを使用します。

使用例

RenderMode プロパティの使用方法を次のコード例に示します。このコード例は、Renderer プロパティのトピックで取り上げているコード例の一部分です。

Visual Basic

' This event handler is invoked when 
' the "Apply Renderers" button is clicked.
' Depending on the value selected in a ComboBox 
' control, it applies a custom renderer selectively
' to individual MenuStrip or ToolStrip controls,
' or it applies a custom renderer to the 
' application as a whole.
Sub applyButton_Click(ByVal sender As
 Object, ByVal e As EventArgs)
    Dim ms As ToolStrip = ToolStripManager.FindToolStrip("MenuStrip")
    Dim ts As ToolStrip = ToolStripManager.FindToolStrip("ToolStrip")

    If targetComboBox.SelectedItem IsNot Nothing
 Then

        Select Case targetComboBox.SelectedItem.ToString()
            Case "Reset"
                ms.RenderMode = ToolStripRenderMode.ManagerRenderMode
                ts.RenderMode = ToolStripRenderMode.ManagerRenderMode

                ' Set the default RenderMode to Professional.
                ToolStripManager.RenderMode = ToolStripManagerRenderMode.Professional

                Exit Select

            Case "All"
                ms.RenderMode = ToolStripRenderMode.ManagerRenderMode
                ts.RenderMode = ToolStripRenderMode.ManagerRenderMode

                ' Assign the custom renderer at the application level.
                ToolStripManager.Renderer = New CustomProfessionalRenderer()

                Exit Select

            Case "MenuStrip"
                ' Assign the custom renderer to the MenuStrip control
 only.
                ms.Renderer = New CustomProfessionalRenderer()

                Exit Select

            Case "ToolStrip"
                ' Assign the custom renderer to the ToolStrip control
 only.
                ts.Renderer = New CustomProfessionalRenderer()

                Exit Select
        End Select

    End If
End Sub

// This event handler is invoked when 
// the "Apply Renderers" button is clicked.
// Depending on the value selected in a ComboBox control,
// it applies a custom renderer selectively to
// individual MenuStrip or ToolStrip controls,
// or it applies a custom renderer to the 
// application as a whole.
void applyButton_Click(object sender, EventArgs e)
{
    ToolStrip ms = ToolStripManager.FindToolStrip("MenuStrip");
    ToolStrip ts = ToolStripManager.FindToolStrip("ToolStrip");

    if (targetComboBox.SelectedItem != null)
    {
        switch (targetComboBox.SelectedItem.ToString())
        {
            case "Reset":
            {
                ms.RenderMode = ToolStripRenderMode.ManagerRenderMode;
                ts.RenderMode = ToolStripRenderMode.ManagerRenderMode;

                // Set the default RenderMode to Professional.
                ToolStripManager.RenderMode = ToolStripManagerRenderMode.Professional;

                break;
            }

            case "All":
            {
                ms.RenderMode = ToolStripRenderMode.ManagerRenderMode;
                ts.RenderMode = ToolStripRenderMode.ManagerRenderMode;

                // Assign the custom renderer at the application level.
                ToolStripManager.Renderer = new CustomProfessionalRenderer();

                break;
            }

            case "MenuStrip":
            {
                // Assign the custom renderer to the MenuStrip control
 only.
                ms.Renderer = new CustomProfessionalRenderer();

                break;
            }

            case "ToolStrip":
            {
                // Assign the custom renderer to the ToolStrip control
 only.
                ts.Renderer = new CustomProfessionalRenderer();

                break;
            }
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripManager クラス
ToolStripManager メンバ
System.Windows.Forms 名前空間

ToolStripManagerRenderMode 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

フォームに含まれる複数の ToolStrip オブジェクトに適用される描画スタイルを指定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Enumeration ToolStripManagerRenderMode

Visual Basic (使用法)

Dim instance As ToolStripManagerRenderMode

public enum ToolStripManagerRenderMode

C++

public enum class ToolStripManagerRenderMode

public enum ToolStripManagerRenderMode

JScript

public enum ToolStripManagerRenderMode

メンバ

	メンバ名	説明
	Custom	ToolStripProfessionalRenderer または ToolStripSystemRenderer 以外の ToolStripRenderer を使用することを示します。
	Professional	ToolStripProfessionalRenderer を使用して描画することを示します。
	System	ToolStripSystemRenderer を使用して描画することを示します。

解説

ToolStripManagerRenderMode は、ToolStripManager クラスによって使用され、ToolStrip.RenderMode プロパティが ToolStripRenderMode.ManagerRenderMode に設定された ToolStrip オブジェクトの描画スタイルを設定します。

ToolStripManager.RenderMode を明示的に Custom に設定することはできませんが、ToolStripManager.Renderer が、ToolStripProfessionalRenderer または ToolStripSystemRenderer 以外の ToolStripRenderer クラスの拡張クラスに設定されると、ToolStripManager.RenderMode は Custom を返します。