PowerTools ActiveReports for .NET 9.0J > ActiveReportsユーザーガイド > 概念 > セクションレポートの概念 > セクションレポートのレポートコントロール > Label |
セクションレポートの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 | 行間を取得または設定します。単位はポイントです。 |
MultiLine | コントロール内に複数行表示するかどうかを取得または設定します。 |
ShrinkToFit | テキストをコントロール領域内に表示するためにフォントサイズを自動的に小さくするかどうかを取得または設定します。 |
Style | スタイル文字列を取得または設定します。 |
Text | レポートで表示するテキストを取得または設定します。 |
TextJustify | Alignmentプロパティが「Justify」に設定された場合に、テキストの配置(位置揃え)を取得または設定します。他の設定の場合は、このプロパティは無視されます。 |
VerticalAlignment | コントロールの境界内におけるラベルテキストの垂直方向の配置を取得または設定します。 |
VerticalText | ラベルのテキストを縦書きに表示するかどうかを示します。 |
WrapMode | ラベルコントロールで複数行表示するときに、必要に応じて自動的に折り返しを行うかどうかを示します。 |
Labelコントロールをダブルクリックすることにより、編集モードに入りテキストを直接入力できます。[プロパティ]ウインドウまたはコード上にTextプロパティを指定して、テキストを入力することも可能です。
テキストの書式をツールバーまたは[プロパティ]ウインドウから設定できます。書式設定は、コントロールのテキスト全体に適用されます。[プロパティ]ウインドウで変更した書式はコントロールに即時反映されます。ツールバーから書式を設定した場合は、[プロパティ]ウインドウの値も変更されます。
メモ: LabelのAlignmentプロパティは「Justify」に設定されている場合は、編集モードに入ると、テキストは一時的に左揃えに表示されます。編集モードを終了すると、自動的に両端揃えに戻ります。 |
直接編集モードでは、以下のキーコマンドを使用できます。
キーシーケンス | 動作 |
---|---|
Enter | 改行 |
Alt + Enter | 変更を保存し、編集モードを終了します。 |
Esc |
変更を保存せずに、編集モードを終了します。 |
エンドユーザデザイナでこの機能を無効にしたい場合は、EditModeEnteringおよびEditModeExitイベントを使用してください。
以下1.および2.の手順により、文字列を縦書きで出力できます。
複数行文字列の縦書きには対応していません。 |
LabelコントロールのMultiLineプロパティをTrueに設定した上で、以下のいずれかの方法により、文字列を縦方向に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に設定して、縦書きを出力する場合には、いくつか注意事項/制限事項が存在します。以下の内容をご確認ください。
|
縦書きは、以下のエクスポートでサポートされます。
Excel、Text、RTFの各エクスポートについては、縦書きは無効になりますので、あらかじめご注意ください。 |
|
出力形式は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 |
レポート上にコントロールを選択した状態で、[プロパティ]ウインドウの下部にあるコマンドから[プロパティ設定ダイアログ]をクリックしてダイアログを開きます。
[全般]
[名前]: レポートで使用されていないユニークなラベル名を入力します。この名前はドキュメントの要素およびXML出力時に表示されます。
[タグ]: コントロールに付随する文字列を入力します。コード上でこのプロパティにアクセスするとオブジェクトとして認識されますが、[プロパティ]ウィンドウまたは[プロパティ設定ダイアログ]では文字列となります。
[表示する]: コントロールを非表示にするには、このチェックを外します。
[データフィールド]: コントロールにバインドするデータソースのフィールドを選択します。
[テキスト]: ラベルに表示する静的テキストを入力します。
[ハイパーリンク]: ビューワのHyperLinkイベントに使用するURLを入力します。HTMLやPDFにエクスポートした場合、URLは自動的にアンカータグやハイパーリンクに変換されます。
[外観]
[背景色]: ラベルの背景色を設定します。
[角度]: スライダーを使用してコントロール領域内のテキストの角度を設定します。
[フォント]
[名前]: フォント名またはフォントのテーマを選択します。
[サイズ]: ポイント単位でフォントのサイズを選択します。
[スタイル]: NormalやItalicを選択します。
[太さ]: NormalやBoldを選択します。
[色]: テキストの色を選択します。
[文字飾り]: 下線や取り消し線のチェックボックスを選択します。
[GDI文字セット]: 使用するGDI文字セットを示す値を入力します。有効値の一覧は、MSDNの「Font.GDICharSetプロパティ」を参照してください。
[GDI縦書きフォント]: GDI縦書きフォントから派生しているフォントを示すためにこのチェックボックスを選択します。
[書式]
[行間]: 行間のスペースを設定する値をポイント単位で入力します。
[文字ピッチ]: 文字間のスペースを設定する値をポイント単位で入力します。
[複数行を表示]: コントロールに複数行を表示するためにこのチェックボックスを選択します。
[高さ]
[縮小して全体を表示する]: ShrinkToFitプロパティを「True」に設定するためにこのチェックボックスを選択します。
[文字列の方向]
[右から左]: テキストを逆の方向に表示するためにこのチェックボックスを選択します。
[縦書き]: テキストを上から下の方向に表示するためにこのチェックボックスを選択します。
[配置]
[縦位置]: Top、Middle、Bottomから選択します。
[横位置]: Left、Center、Right、Justifyから選択します。
[均等割付]: Auto、Distribute、DistributeAllLinesから選択します。
メモ: [均等割付]のオプションを有効にするには[横位置]を「Justify」に設定する必要があります。 |
[折り返し]: NoWrap、WordWrap、CharWrapの値をいずれか選択し、テキストを折り返すかどうかまたはその方法を指定します。
[パディング]
ラベルの周囲に表示するスペースをポイント単位で入力します。