xamOutlookBar™ のグループはコンテンツのコンテナーとして機能するヘッダー付きのコンテンツ コントロールです。OutlookBarGroup オブジェクトのヘッダーにテキストと画像を表示するには、その Header プロパティおよび LargeImage プロパティをそれぞれ設定します。また、OutlookBarGroup オブジェクトの SmallImage プロパティを設定すると、グループがオーバーフロー領域に到達したときに画像を表示できます。SmallImage プロパティを設定しない場合、xamOutlookBar コントロールはオーバーフロー領域でデフォルトのエンベロープ画像を自動的に使用します。
上記のプロパティのほかに、以下のプロパティがよく使用されます。
Key - xamOutlookBar の グループ コレクション にインデックス設定できるようにするために設定するオプションのプロパティです。Key プロパティを設定する場合、各グループの一意の値を提供する必要があります。
IsSelected - 特定のグループを選択するために XAML またはコードでこのプロパティを設定できます。一度に選択できるグループはひとつだけです。
Location - 実行時に、エンド ユーザーはグループを異なる場所に移動できます。配置される場所を決定するためにグループの Location プロパティをクエリできます。
以下のコード例は、xamOutlookBar にグループを追加する方法を示します。アプリケーションで実際の画像を指し示す URI で LargeImage プロパティと SmallImage プロパティのサンプル URI を置き換えることが必要となります。
XAML の場合:
<igOutlookBar:XamOutlookBar Name="xamOutlookBar1" HorizontalAlignment="Left">
<igOutlookBar:XamOutlookBar.Groups>
<igOutlookBar:OutlookBarGroup
Header="Group 1"
LargeImage="ReplaceWithYourLargeImage.png"
SmallImage="ReplaceWithYourSmallImage.png"
Key="group1">
<!-- TODO: ここでパネルを追加します -->
</igOutlookBar:OutlookBarGroup>
</igOutlookBar:XamOutlookBar.Groups>
</igOutlookBar:XamOutlookBar>
Visual Basic の場合:
Imports Infragistics.Windows.OutlookBar
...
Dim group1 As New OutlookBarGroup()
group1.Header = "Group 1"
group1.LargeImage = New BitmapImage(New Uri("pack://application:,,,/ReplaceWithYourLargeImage.png"))
group1.SmallImage = New BitmapImage(New Uri("pack://application:,,,/ReplaceWithYourSmallImage.png"))
group1.Key = "group1"
Me.xamOutlookBar1.Groups.Add(group1)
C# の場合:
using Infragistics.Windows.OutlookBar;
...
OutlookBarGroup group1 = new OutlookBarGroup();
group1.Header = "Group 1";
group1.LargeImage = new BitmapImage(new Uri("pack://application:,,,/ReplaceWithYourLargeImage.png"));
group1.SmallImage = new BitmapImage(new Uri("pack://application:,,,/ReplaceWithYourSmallImage.png"));
group1.Key = "group1";
this.xamOutlookBar1.Groups.Add(group1);