CloseButtonVisibility 列挙体

閉じるボタンをタブ項目にいつ表示するかを指定します。

構文

Visual Basic (宣言)
C#

Public Enum CloseButtonVisibility 
   Inherits System.Enum

public enum CloseButtonVisibility : System.Enum

メンバ

メンバ	解説
Always	閉じるボタンが常に表示されることを示します。
Never	閉じるボタンがタブに表示されないことを示します。
OnActive	タブがアクティブになったときにのみ閉じるボタンが表示されることを示します。
OnActiveOrHover	タブがアクティブになったとき、またはマウスがタブの上に置かれたときに閉じるボタンが表示されることを示します。
OnHover	マウスがタブの上に置かれたときにのみ閉じるボタンが表示されることを示します。

解説

この列挙体を使用して、GcTabControlのタブの閉じるボタンがいつ表示されるかを指定できます。この列挙体は、GcTabControl.CloseButtonVisibilityプロパティで使用されます。GcTabControl.CloseButtonVisibilityがOnHoverまたはOnActiveOrHoverの場合、閉じるボタンはGcTabControl.HotTrackプロパティがtrueになるまで表示されません。

使用例

次のサンプルコードは、閉じるボタンのあるGcTabControlを作成する方法を示します。また、閉じるボタンの表示を設定する方法も示します。この例を実行するには、以下のコードを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

継承階層

System.Object
   System.ValueType
      System.Enum
         GrapeCity.Win.Containers.CloseButtonVisibility

プラットフォーム

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

参照

GrapeCity.Win.Containers 名前空間
 CloseButtonVisibility プロパティ
 CloseButtonVisibility プロパティ