CloseButtonAlign プロパティ (GcTabBase)

タブ上での閉じるボタンの配置を示す値を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property CloseButtonAlign As CloseButtonAlignment

public CloseButtonAlignment CloseButtonAlign {get; set;}

プロパティ値

CloseButtonAlignment値の1つ。デフォルトはCloseButtonAlignment.AfterContentです。

例外

例外	解説
System.ComponentModel.InvalidEnumArgumentException	指定された値がCloseButtonAlignment値の1つではありません。

解説

このプロパティを使用すると、閉じるボタンがタブに表示される場合に、閉じるボタンが配置される位置（タブ項目のイメージとテキストの前または後）を確認できます。

使用例

次のサンプルコードは、GcTabControlを作成して使用する方法を示します。また、CloseButtonAlignプロパティを使用してタブ上に閉じるボタンを配置する方法も示します。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

C#
Visual Basic

public void CreateMyGcTabControl()
{
    // Create a GcTabControl.
    GcTabControl gcTabControl = new GcTabControl();

    // Set the size and location of gcTabControl.
    gcTabControl.Size = new Size(200, 200);
    gcTabControl.Location = new Point(10, 10);

    // Add some tab pages to gcTabControl.
    gcTabControl.TabPages.AddRange(new GcTabPage[]
    { 
        new GcTabPage("page1"),
        new GcTabPage("page2"),
        new GcTabPage("page3"),
    });

    // Always show the close button of all tabs.
    gcTabControl.CloseButtonVisibility = CloseButtonVisibility.Always;

    // Set a new size for all the tabs.
    gcTabControl.CloseButtonSize = new Size(20, 20);

    // Position the close button before the image and text of the tab.
    gcTabControl.CloseButtonAlign = CloseButtonAlignment.BeforeContent;

    // Show and set ToolTip for every tab.
    gcTabControl.ShowToolTips = true;
    gcTabControl.CloseButtonToolTipText = "Close this tab";

    this.Controls.Add(gcTabControl);
}

Public Sub CreateMyGcTabControl()
    ' Create a GcTabControl.
    Dim gcTabControl As New GcTabControl()

    ' Set the size and location of gcTabControl.
    gcTabControl.Size = New Size(200, 200)
    gcTabControl.Location = New Point(10, 10)

    ' Add some tab pages to gcTabControl.
    gcTabControl.TabPages.AddRange(New GcTabPage() {New GcTabPage("page1"), New GcTabPage("page2"), New GcTabPage("page3")})

    ' Always show the close button of all tabs.
    gcTabControl.CloseButtonVisibility = CloseButtonVisibility.Always

    ' Set a new size for all the tabs.
    gcTabControl.CloseButtonSize = New Size(20, 20)

    ' Position the close button before the image and text of the tab.
    gcTabControl.CloseButtonAlign = CloseButtonAlignment.BeforeContent

    ' Show and set ToolTip for every tab.
    gcTabControl.ShowToolTips = True
    gcTabControl.CloseButtonToolTipText = "Close this tab"

    Me.Controls.Add(gcTabControl)
End Sub

プラットフォーム

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

GcTabBase クラス
 GcTabBase メンバ