セクションレポートのLabelコントロールは、Visual Studioの標準のLabelコントロールと同等のものです。本コントロールは、ARControlオブジェクトから継承され、DataFieldプロパティによってデータに連結することができます。静的なテキストの入力はTextBoxコントロールでも可能ですので、これらの2つのコントロールの主な違いは、LabelコントロールのAngleプロパティ、TextBoxコントロールのCanGrow、CanShrink、CountNullValues、Culture、DistinctField、OutputFormat、SummaryFunc、SummaryGroup、SummaryRunning、SummaryTypeの各プロパティの有無になります。

主なプロパティ

プロパティ	解説
Angle	コントロール領域のテキストの角度（傾き）を取得、または設定します。テキストを縦方向に表示するには、Angleプロパティを「900」に設定します。
CharacterSpacing	文字ピッチを取得、または設定します。単位はポイントです。
DataField	データソースのコントロールに連結するフィールドの名前を取得、または設定します。
HyperLink	ユーザーが実行時にラベルをクリックした時、ビューワのHyperLinkイベントで指定したリンク先に移動するためのURLを取得、または設定します。HTMLやPDFにエクスポートした場合、URLは自動的にアンカータグやハイパーリンクに変換されます。
LineSpacing	行間を取得、または設定します。単位はポイントです。
MinCondenseRate	テキストを水平方向に縮小する際の最小縮小率をパーセンテージで指定します。値は10～100の間である必要があります。
MultiLine	コントロール内に複数行表示するかどうかを取得、または設定します。
ShrinkToFit	テキストをコントロール領域内に表示するためにフォントサイズを自動で小さくするかどうかを取得、または設定します。
Style	スタイル文字列を取得、または設定します。
Text	レポートで表示するテキストを取得、または設定します。
TextJustify	Alignmentプロパティが「Justify」に設定された場合に、テキストの配置（位置揃え）を取得、または設定します。他の設定の場合は、このプロパティは無視されます。
VerticalAlignment	コントロールの境界内におけるラベルテキストの垂直方向の配置を取得、または設定します。
VerticalText	ラベルのテキストを縦書きに表示するかどうかを表します。
WrapMode	ラベルコントロールで複数行表示する際に、必要に応じて自動的に折り返しを行うかどうかを表します。

Labelコントロールをダブルクリックすると編集モードに入り、テキストを直接入力することができるようになります。［プロパティ］ウィンドウ、またはコード上でTextプロパティを指定して、テキストを入力することも可能です。

テキストの書式はActiveReportsツールバー、または［プロパティ］ウィンドウから設定可能です。書式設定は、コントロールのテキスト全体に適用されます。［プロパティ］ウィンドウで変更した書式はコントロールに即時反映されます。ツールバーから書式を設定した場合は、［プロパティ］ウィンドウの値も変更されます。

メモ: LabelのAlignmentプロパティが「Justify」に設定されている場合は、編集モードに入ると、テキストは一時的に左揃えに表示されます。編集モードを終了すると、自動的に両端揃えに戻ります。

ショートカットキー

直接編集モードでは、以下のキーコマンドを使用することができます。

キーシーケンス	動作
Enter	改行
Alt + Enter	変更を保存し、編集モードを終了します。
Esc	変更を保存せずに、編集モードを終了します。

エンドユーザデザイナでこの機能を無効にしたい場合は、EditModeEnteringイベントおよびEditModeExitイベントを使用してください。

縦書き

以下の1.および2.の手順により、文字列を縦書きで出力することができます。

注意: 複数行文字列の縦書きには対応していません。

文字列を縦方向に１行で出力するように調整する

LabelコントロールのMultiLineプロパティを「True」に設定した上で、以下のいずれかの方法により、文字列を縦方向に１行で出力するように調整します。

コントロールの幅を狭める
Paddingプロパティを使用してコントロール内の余白を調整する

1文字ごとに改行する

改行は、直接編集や［プロパティ］ウィンドウから入力可能です。または、以下のサンプルコードのように、コードで設定することもできます。

Visual Basic	コードのコピー
Dim Tmp As String 　Tmp = "グ" & vbCrLf 　Tmp = Tmp & "レ" & vbCrLf 　Tmp = Tmp & "―" & vbCrLf 　Tmp = Tmp & "プ" 　Label1.Text = Tmp

文字の方向を縦書き用に設定する
LabelコントロールのVerticalTextプロパティを「True」に設定することで、特定文字（長音記号や括弧など）の描画が縦書き用に最適化されます。

制限事項

VerticalTextプロパティを「True」に設定して縦書きを出力する場合には、制限事項がいくつか存在します。以下の内容をご確認ください。

複数行には対応していません。コントロールの幅やPaddingプロパティを使用して、１行で表示されるように調整する必要があります。
1. Paddingプロパティを使用する
2. コントロールの幅を調整する
結合文字や半角文字など、一部の文字については正しく表示されません。
Alignmentプロパティ（文字出力の水平位置）は、「Left」（左揃え）に設定する必要があります。
均等割付には対応していません。
プロポーショナルフォントを使用した場合、表示位置が揃いません。等幅フォントの使用をお勧めします。
6.0J以上のバージョンでは、レポートのデザイナ上でLabelコントロールをダブルクリックすると、文字列をデザイナ上から直接編集することが可能です。しかしながら、縦書きを設定したコントロールの文字をデザイン時に変更する場合は、上記の方法を使用することはできません。デザイン時に文字を編集する場合には、［プロパティ］ウィンドウを使用する必要があります。
斜体は正しく表示されません。
左端（黒文字）：VerticalText = True、Font.Italic = Falseの場合

中央（赤文字）：VerticalText = True、Font.Italic = Trueの場合

右端（青文字）：VerticalText = False、Font.Italic = Trueの場合
現時点では、下記の文字について、正しく出力されないことが確認されています。
ⅠⅡⅢⅣⅤⅥⅦⅧⅨⅩⅰⅱⅲⅳⅴⅵⅶⅷⅸⅹ

エクスポート

縦書きは、以下のエクスポートでサポートされます。

注意: Excel、Text、RTFの各エクスポートについては、縦書きは無効になりますので、あらかじめご注意ください。

PDF

注意:

Labelコントロールの幅が１行の幅よりも大きい場合、文字列が正しく出力されません。
Labelコントロールを使用して、Angleプロパティに「0」以外の値を設定した場合、文字列が正しく出力されません。
斜体の文字列は正しく出力されません。
丸付き文字（①など）や矢印（→など）は正しく出力されません。
縦書きに使用するフォントは、PDFファイルに埋め込む必要があります。

TIFF

HTML

注意: 出力形式はDynamicHtml形式でのみサポートされます。また、ブラウザはMicrosoft Internet Explorerでのみサポートされます。

対応文字一覧

文字	ユニコード	名称
‘	2018	LEFT SINGLE QUOTATION MARK
“	201C>	LEFT DOUBLE QUOTATION MARK
（	0028	LEFT PARENTHESIS
〔	3014	LEFT TORTOISE SHELL BRACKET>
［	005B	LEFT SQUARE BRACKET
｛	007B	LEFT CURLY BRACKET
〈	3008	LEFT ANGLE BRACKET
《	300A	LEFT DOUBLE ANGLE BRACKET
「	300C	LEFT CORNER BRACKET
『	300E	LEFT WHITE CORNER BRACKET
【	3010	LEFT BLACK LENTICULAR BRACKET
?	2985	LEFT WHITE PARENTHESIS
?	3018	LEFT WHITE TORTOISE SHELL BRACKET
?	3016	LEFT WHITE LENTICULAR BRACKET
≪	00AB	LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
〝	301D	REVERSED DOUBLE PRIME QUOTATION MARK
’	2019	RIGHT SINGLE QUOTATION MARK
”	201D	RIGHT DOUBLE QUOTATION MARK
）	0029	RIGHT PARENTHESIS
〕	3015	RIGHT TORTOISE SHELL BRACKET
］	005D	RIGHT SQUARE BRACKET
｝	007D	RIGHT CURLY BRACKET
〉	3009	RIGHT ANGLE BRACKET
》	300B	RIGHT DOUBLE ANGLE BRACKET
」	300D	RIGHT CORNER BRACKET
』	300F	RIGHT WHITE CORNER BRACKET
】	3011	RIGHT BLACK LENTICULAR BRACKET
?	2986	RIGHT WHITE PARENTHESIS
?	3019	RIGHT WHITE TORTOISE SHELL BRACKET
?	3017	RIGHT WHITE LENTICULAR BRACKET
≫	00BB	RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK
〟	301F	LOW DOUBLE PRIME QUOTATION MARK
‐	2010	HYPHEN
?	301C	WAVE DASH
?	30A0	KATAKANA-HIRAGANA DOUBLE HYPHEN
?	2013	EN DASH
・	30FB	KATAKANA MIDDLE DOT
：	003A	COLON
。	3002	IDEOGRAPHIC FULL STOP
、	3001	IDEOGRAPHIC COMMA
ぁ	3041	HIRAGANA LETTER SMALL A
ぃ	3043	HIRAGANA LETTER SMALL I
ぅ	3045	HIRAGANA LETTER SMALL U
ぇ	3047	HIRAGANA LETTER SMALL E
ぉ	3049	HIRAGANA LETTER SMALL O
ァ	30A1	KATAKANA LETTER SMALL A
ィ	30A3	KATAKANA LETTER SMALL I
ゥ	30A5	KATAKANA LETTER SMALL U
ェ	30A7	KATAKANA LETTER SMALL E
ォ	30A9	KATAKANA LETTER SMALL O
っ	3063	HIRAGANA LETTER SMALL TU
ゃ	3083	HIRAGANA LETTER SMALL YA
ゅ	3085	HIRAGANA LETTER SMALL YU
ょ	3087	HIRAGANA LETTER SMALL YO
ゎ	308E	HIRAGANA LETTER SMALL WA
?	3095	HIRAGANA LETTER SMALL KA
?	3096	HIRAGANA LETTER SMALL KE
ッ	30C3	KATAKANA LETTER SMALL TU
ャ	30E3	KATAKANA LETTER SMALL YA
ュ	30E5	KATAKANA LETTER SMALL YU
ョ	30E7	KATAKANA LETTER SMALL YO
ヮ	30EE	KATAKANA LETTER SMALL WA
ヵ	30F5	KATAKANA LETTER SMALL KA
ヶ	30F6	KATAKANA LETTER SMALL KE

プロパティ設定ダイアログ

Labelコントロールの各プロパティは、プロパティ設定ダイアログで設定することができます。このダイアログを表示するには、レポート上のLabelコントロールを選択した状態で、［プロパティ］ウィンドウの下部にあるコマンドから［プロパティ設定ダイアログ］リンクをクリックします。表示される［Label］ダイアログが、Labelコントロールのプロパティ設定ダイアログにあたります。
［Label］ダイアログでは、以下の各ページでLabelコントロールのプロパティを設定することができます。

［全般］

［外観］

［フォント］

［書式］

［配置］