syncfusion-winforms-office2007form

Office2007Form の実装

Syncfusion の Office2007Form は、Microsoft Office 2007 に着想を得た UI と外観を提供する高度な Windows Forms コントロールです。組み込みの配色、キャプションのカスタマイズ、Office スタイルのテーマ機能により、標準的なフォームをモダンで視覚的に魅力的なインターフェイスに変えます。

このスキルを使用するタイミング

次のような場合に、このスキルを使用してください。

• Microsoft Office 2007 の外観を持つ Windows Forms を作成する
• 組み込みの配色（Blue、Silver、Black、Managed）を適用する
• フォームのキャプションバー（配置、フォント、色、高さ）をカスタマイズする
• デスクトップアプリケーションに Office スタイルの視覚的な洗練を加える
• カスタム描画コードを使わずに、モダンなフォーム UI を実装する
• アプリケーション全体でテーマ設定と視覚的な一貫性をサポートする
• 標準の Windows Forms を、外観を強化したフォームに置き換える
• 角丸（Windows 11）をサポートする
• 国際化に向けて RTL（右から左）レイアウトを設定する

コンポーネントの概要

Office2007Form は、標準の System.Windows.Forms.Form を継承によって置き換え、次の機能を提供します。

• 組み込みテーマ：Blue、Silver、Black、Managed の配色
• キャプションのカスタマイズ：キャプションバーの外観を全面的に制御
• モダンな外観：Office 2007 に着想を得たビジュアルデザイン
• 簡単な統合：シンプルな継承モデルで、コードの変更は最小限
• AeroTheme のサポート：Windows Vista/7 の Aero 効果に対応
• 高度な機能：RTL サポート、角丸（Windows 11）、スタイルの切り替え

パッケージ要件

必須パッケージ：

• Syncfusion.Shared.Base - Office2007Form コントロールとコア機能を含みます

NuGet からのインストール：

Install-Package Syncfusion.Shared.Base

または、Visual Studio の NuGet パッケージ マネージャーで「Syncfusion.Shared.Base」を検索してください。

必須のアセンブリ参照：

• Syncfusion.Shared.Base.dll

必須の名前空間：

using Syncfusion.Windows.Forms;

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

• アセンブリの配置と NuGet パッケージのインストール
• 必要な依存関係とアセンブリ参照
• 名前空間のインポートと基本設定
• 標準の Form を Office2007Form に変換する
• Office2007Form クラスを継承する
• 初回の描画と初期設定

配色とテーマ設定

📄 参照： references/color-schemes.md

• 使用可能な配色（Blue、Silver、Black、Managed）
• ColorScheme プロパティの設定
• カスタムカラーによる Managed カラーの適用
• スキームに合わせた背景色の同期
• AeroTheme のサポートと設定
• UseOffice2007SchemeBackColor プロパティ
• OS バージョン間でのテーマの互換性

キャプションのカスタマイズ

📄 参照： references/caption-customization.md

• キャプションテキストの配置（左、中央、右）
• キャプションのカスタムフォントの設定
• キャプションテキストの色のカスタマイズ
• キャプションバーの高さの調整
• 最大化モードでの高さの維持
• キャプションバーでのヘルプボタンのサポート

高度な機能

📄 参照： references/advanced-features.md

• 右から左（RTL）レイアウトのサポート
• Windows 11 向けの角丸
• 必要に応じて Office2007 スタイルを無効にする
• OS の互換性とバージョン要件
• 特殊なケースとプラットフォームの制限

クイックスタートの例

前提条件：

• Syncfusion.Shared.Base NuGet パッケージをインストールする
• プロジェクトで Syncfusion.Shared.Base.dll を参照する
• using Syncfusion.Windows.Forms; 名前空間を追加する

基本的な Office2007Form の設定

using System;
using System.Drawing;
using System.Windows.Forms;
using Syncfusion.Windows.Forms;  // Required: Syncfusion.Shared.Base package

namespace MyApplication
{
    // Inherit from Office2007Form instead of Form
    public partial class MainForm : Office2007Form
    {
        public MainForm()
        {
            InitializeComponent();
            
            // Set basic properties
            this.Text = "My Office 2007 Application";
            this.Size = new Size(800, 600);
            
            // Apply Blue color scheme
            this.ColorScheme = Office2007Theme.Blue;
            
            // Optional: Use scheme background color
            this.UseOffice2007SchemeBackColor = true;
        }
    }
}

キャプションをカスタマイズする場合

public partial class CustomForm : Office2007Form
{
    public CustomForm()
    {
        InitializeComponent();
        
        this.Text = "Customized Office Form";
        
        // Apply color scheme
        this.ColorScheme = Office2007Theme.Silver;
        
        // Customize caption
        this.CaptionAlign = HorizontalAlignment.Center;
        this.CaptionFont = new Font("Segoe UI", 12F, FontStyle.Bold);
        this.CaptionForeColor = Color.DarkBlue;
        this.CaptionBarHeight = 40;
    }
}

Managed 配色を使用する場合

public partial class ManagedColorForm : Office2007Form
{
    public CustomForm()
    {
        InitializeComponent();
        
        this.Text = "Custom Color Theme";
        
        // Apply managed scheme with custom color
        this.ColorScheme = Office2007Theme.Managed;
        Office2007Colors.ApplyManagedColors(this, Color.DarkMagenta);
        
        this.UseOffice2007SchemeBackColor = true;
    }
}

よくあるパターン

パターン 1：標準的な Office テーマのフォーム

最も一般的なユースケースです。組み込みの Office テーマを適用します。

public class MyForm : Office2007Form
{
    public MyForm()
    {
        InitializeComponent();
        this.Text = "My Application";
        this.ColorScheme = Office2007Theme.Blue; // or Silver, Black
        this.UseOffice2007SchemeBackColor = true;
    }
}

パターン 2：キャプションの外観をカスタマイズする

ブランディングに合わせてキャプションバーをカスタマイズします。

public class BrandedForm : Office2007Form
{
    public BrandedForm()
    {
        InitializeComponent();
        
        // Apply theme
        this.ColorScheme = Office2007Theme.Black;
        
        // Brand the caption
        this.CaptionAlign = HorizontalAlignment.Center;
        this.CaptionFont = new Font("Arial", 14F, FontStyle.Bold);
        this.CaptionForeColor = Color.Gold;
        this.CaptionBarHeight = 45;
        this.CaptionBarHeightMode = 
            Syncfusion.Windows.Forms.Enums.CaptionBarHeightMode.SameAlwaysOnMaximize;
    }
}

パターン 3：カスタム Managed カラー

ブランドカラーを使用します。

public class CustomBrandForm : Office2007Form
{
    public CustomBrandForm()
    {
        InitializeComponent();
        
        this.Text = "Brand Color Application";
        
        // Use company brand color
        this.ColorScheme = Office2007Theme.Managed;
        Color brandColor = Color.FromArgb(0, 120, 215); // Custom blue
        Office2007Colors.ApplyManagedColors(this, brandColor);
        
        this.UseOffice2007SchemeBackColor = true;
    }
}

パターン 4：カスタムスキームで AeroTheme を無効にする

Aero が有効な Vista/7 で配色を使用する必要がある場合：

public class NoAeroForm : Office2007Form
{
    public NoAeroForm()
    {
        InitializeComponent();
        
        // Disable Aero to allow color scheme
        this.ApplyAeroTheme = false;
        
        // Now apply your color scheme
        this.ColorScheme = Office2007Theme.Silver;
    }
}

パターン 5：角丸（Windows 11）

Windows 11 でモダンな角丸の外観にします：

public class ModernForm : Office2007Form
{
    public ModernForm()
    {
        InitializeComponent();
        
        this.Text = "Modern Application";
        this.ColorScheme = Office2007Theme.Blue;
        
        // Enable rounded corners (Windows 11 only)
        this.AllowRoundedCorners = true;
    }
}

パターン 6：RTL サポート

右から左に記述する言語の場合：

public class RtlForm : Office2007Form
{
    public RtlForm()
    {
        InitializeComponent();
        
        this.Text = "تطبيق"; // Arabic text
        this.ColorScheme = Office2007Theme.Blue;
        
        // Enable RTL
        this.RightToLeft = RightToLeft.Yes;
        this.RightToLeftLayout = true;
    }
}

主なプロパティ

プロパティ	型	説明
ColorScheme	Office2007Theme	カラースキームを設定します：Blue、Silver、Black、Managed
CaptionAlign	HorizontalAlignment	キャプションテキストの配置（Left、Center、Right）
CaptionFont	Font	キャプションバーのフォントスタイル
CaptionForeColor	Color	キャプションテキストの色
CaptionBarHeight	int	キャプションバーの高さ（ピクセル単位）
CaptionBarHeightMode	CaptionBarHeightMode	最大化時の高さの動作
UseOffice2007SchemeBackColor	bool	フォームの背景色をカラースキームに合わせます
ApplyAeroTheme	bool	Aero グラス効果を有効／無効にします
AllowRoundedCorners	bool	角丸にします（Windows 11 のみ）
RightToLeft	RightToLeft	RTL のテキスト方向
RightToLeftLayout	bool	RTL レイアウトのミラーリング
DisableOffice2007Style	bool	標準的なフォームの外観に戻します
HelpButton	bool	キャプションバーにヘルプボタンを表示します

よくある使用例

1. エンタープライズアプリケーション - ビジネスソフトウェア向けの、プロフェッショナルな Office スタイルの外観
2. データ入力フォーム - データ収集インターフェイスにモダンな外観を適用
3. ダッシュボードアプリケーション - 複数パネルのダッシュボード向けに、テーマを適用した親フォームを使用
4. 設定ダイアログ - 洗練された設定ウィンドウや環境設定ウィンドウ
5. ブランディング要件 - 企業ブランドに合わせた独自の Managed カラー
6. 多言語アプリ - 国際展開向けの RTL サポート
7. Windows 11 アプリ - 最新の OS 向けのモダンな角丸

標準フォームからの移行

変更前（標準フォーム）

public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.Text = "My Application";
    }
}

変更後（Office2007Form）

public partial class MyForm : Office2007Form
{
    public MyForm()
    {
        InitializeComponent();
        this.Text = "My Application";
        this.ColorScheme = Office2007Theme.Blue;
        this.UseOffice2007SchemeBackColor = true;
    }
}

必要な変更：

1. 継承元を Form から Office2007Form に変更します
2. using Syncfusion.Windows.Forms; を追加します
3. Syncfusion.Shared.Base.dll のアセンブリ参照を追加します
4. ColorScheme プロパティを設定します（任意ですが、推奨されます）

トラブルシューティング早見表

• カラースキームが適用されない：ApplyAeroTheme が有効か確認します。Vista／7 でカラースキームを使用するには false に設定します
• 最大化時にキャプションバーの高さが変わる：CaptionBarHeightMode = SameAlwaysOnMaximize を設定します
• 角丸が表示されない：Windows 11 でのみサポートされています。OS のバージョンを確認します
• アセンブリが見つからない：Syncfusion.Shared.Base.dll が参照され、NuGet パッケージがインストールされていることを確認します
• 他のコントロールとテーマが一致しない：すべての Syncfusion コントロールが同じカラースキームを使用していることを確認します