CaptionInactive プロパティ

含まれるフォームがアクティブでない場合、リボン キャプション領域に表示されるキャプションを返すか、設定します。

シンタックス

Visual Basic

public string CaptionInactive {get; set;}

C#

'宣言
 
Public Property CaptionInactive As String

 

解説

CaptionInactive プロパティは、リボンを含むフォームがアクティブでない場合、リボンのキャプション領域内に表示されるキャプションを決定するために使用されます。デフォルトで、このプロパティと Caption がデフォルト値である null に設定され、UltraToolbarsManager.FormDisplayStyle は標準のフォーム キャプションは表示されない時に、これは UltraToolbarsManager.DockWithinContainer の Text プロパティを使用して解決されます。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolBars

' Show the Ribbon
Me.UltraToolbarsManager1.Ribbon.Visible = True

' Set the ribbon caption
Me.UltraToolbarsManager1.Ribbon.Caption = "This is the ribbon caption when the form is active"
Me.UltraToolbarsManager1.Ribbon.CaptionInactive = "This is the ribbon caption when the form is inactive"

' Set the Ribbon IsMinimized to false
Me.UltraToolbarsManager1.Ribbon.IsMinimized = False

' Add some tabs
Me.UltraToolbarsManager1.Ribbon.Tabs.Clear()
Dim ribbonTab1 As RibbonTab = Me.UltraToolbarsManager1.Ribbon.Tabs.Add("ribbon1")
Dim ribbonTab2 As RibbonTab = Me.UltraToolbarsManager1.Ribbon.Tabs.Add("ribbon2")
Dim ribbonTab3 As RibbonTab = Me.UltraToolbarsManager1.Ribbon.Tabs.Add("ribbon3")
Dim ribbonTab4 As RibbonTab = Me.UltraToolbarsManager1.Ribbon.Tabs.Add("ribbon4")
Dim ribbonTab5 As RibbonTab = Me.UltraToolbarsManager1.Ribbon.Tabs.Add("ribbon5")
Dim ribbonTab6 As RibbonTab = Me.UltraToolbarsManager1.Ribbon.Tabs.Add("ribbon6")

' Add some groups
Dim ribbonGroupClipboard As RibbonGroup = ribbonTab1.Groups.Add("Clipboard")
Dim ribbonGroupFont As RibbonGroup = ribbonTab1.Groups.Add("Font")
Dim ribbonGroupStyles As RibbonGroup = ribbonTab1.Groups.Add("Styles")

' Create some Contextual Tab Groups and put some tabs into groups. 
Me.UltraToolbarsManager1.Ribbon.ContextualTabGroups.Clear()

Me.UltraToolbarsManager1.Ribbon.ContextualTabGroups.Add("contextualTabGroup1")
ribbonTab3.ContextualTabGroupKey = "contextualTabGroup1"
ribbonTab4.ContextualTabGroupKey = "contextualTabGroup1"

Me.UltraToolbarsManager1.Ribbon.ContextualTabGroups.Add("contextualTabGroup2")
ribbonTab5.ContextualTabGroupKey = "contextualTabGroup2"
ribbonTab6.ContextualTabGroupKey = "contextualTabGroup2"
Me.UltraToolbarsManager1.Ribbon.ContextualTabGroups("contextualTabGroup2").Visible = False

' Set the selected ribbon tab
Me.UltraToolbarsManager1.Ribbon.SelectedTab = ribbonTab1

' Set the border style for the Ribbon Groups
Me.UltraToolbarsManager1.Ribbon.GroupBorderStyle = UIElementBorderStyle.Dotted

'宣言
 
Public Property CaptionInactive As String

 

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinToolBars;


// Show the Ribbon
this.ultraToolbarsManager1.Ribbon.Visible = true;

// Set the ribbon caption
this.ultraToolbarsManager1.Ribbon.Caption = "This is the ribbon caption when the form is active";
this.ultraToolbarsManager1.Ribbon.CaptionInactive = "This is the ribbon caption when the form is inactive";

// Set the Ribbon IsMinimized to false
this.ultraToolbarsManager1.Ribbon.IsMinimized = false;

// Add some tabs
this.ultraToolbarsManager1.Ribbon.Tabs.Clear();
RibbonTab ribbonTab1 = this.ultraToolbarsManager1.Ribbon.Tabs.Add("ribbon1");
RibbonTab ribbonTab2 = this.ultraToolbarsManager1.Ribbon.Tabs.Add("ribbon2");
RibbonTab ribbonTab3 = this.ultraToolbarsManager1.Ribbon.Tabs.Add("ribbon3");
RibbonTab ribbonTab4 = this.ultraToolbarsManager1.Ribbon.Tabs.Add("ribbon4");
RibbonTab ribbonTab5 = this.ultraToolbarsManager1.Ribbon.Tabs.Add("ribbon5");
RibbonTab ribbonTab6 = this.ultraToolbarsManager1.Ribbon.Tabs.Add("ribbon6");

// Add some groups
RibbonGroup ribbonGroupClipboard = ribbonTab1.Groups.Add("Clipboard");
RibbonGroup ribbonGroupFont = ribbonTab1.Groups.Add("Font");
RibbonGroup ribbonGroupStyles = ribbonTab1.Groups.Add("Styles");

// Create some Contextual Tab Groups and put some tabs into groups. 
this.ultraToolbarsManager1.Ribbon.ContextualTabGroups.Clear();

this.ultraToolbarsManager1.Ribbon.ContextualTabGroups.Add("contextualTabGroup1");
ribbonTab3.ContextualTabGroupKey = "contextualTabGroup1";
ribbonTab4.ContextualTabGroupKey = "contextualTabGroup1";

this.ultraToolbarsManager1.Ribbon.ContextualTabGroups.Add("contextualTabGroup2");
ribbonTab5.ContextualTabGroupKey = "contextualTabGroup2";
ribbonTab6.ContextualTabGroupKey = "contextualTabGroup2";
this.ultraToolbarsManager1.Ribbon.ContextualTabGroups["contextualTabGroup2"].Visible = false;

// Set the selected ribbon tab
this.ultraToolbarsManager1.Ribbon.SelectedTab = ribbonTab1;

// Set the border style for the Ribbon Groups
this.ultraToolbarsManager1.Ribbon.GroupBorderStyle = UIElementBorderStyle.Dotted;

'宣言
 
Public Property CaptionInactive As String