範囲の書式設定 (プレビュー)

範囲を書式設定 [ブック] アクティビティを使用して、範囲内のセルの、数値の書式、配置、フォントを設定します。

UiPath.Excel.Activities.FormatRange

説明

範囲内のセルの、数値の書式、配置、およびフォントを設定します。これは、Windows の [セルを書式設定 ] アクティビティと同等のクロスプラットフォーム アクティビティです。

注:

このアクティビティでは ファイルの .xls はサポートされていません。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

プロパティ

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。

入力

• ファイル - リソースのブックのフル パスです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ローカル ファイルを使用] を選択します。現在のフィールドが [ファイル (ローカル パス)] に変更され、ブックのフル パスを指定できます。
• シート名 - ブックのシートの名前です。
• 範囲 - 書式を設定する範囲です。このフィールドは必須です。

形式

[Windows] アクティビティと同様に、デザイナーには設定のセクションが一度に 1 つずつ表示されます。[ 書式 ] セレクターを使用して、[ データの種類]、[ 配置]、[ フォント] から選択します。セレクターはデザイナーによってのみ使用され、ワークフローとともに保存されません。表示されないセクションの設定は保持され、引き続き適用されます。

3 つのセクションで、設定の任意の組み合わせを構成できます。設定を行わない設定では、セルの既存の書式設定が保持されます。これには カテゴリが含まれます。たとえば、[ フォント スタイル] のみを設定した場合、既存の数値形式は [一般] にリセットされません。

データ型

• カテゴリ - 適用する数値形式のカテゴリです。既存の数値形式を維持するには、このフィールドは設定しないままにします。カテゴリを選択すると、そのカテゴリのフィールドのみが表示されます。[カテゴリ] を変数または式にバインドすると、すべてのカテゴリ フィールドが表示されます。
  • Number
    • 小数点以下 - 小数点以下の桁数です。既定値は 2です。
    • 1000 の区切り文字を使用 - 3 桁の区切り文字を使用する場合に選択します。既定では、このオプションは選択されていません。
  • 通貨
    • 小数点以下 - 小数点以下の桁数です。既定値は 2です。
    • 1000 の区切り文字を使用 - 3 桁の区切り文字を使用する場合に選択します。既定では、このオプションは選択されていません。
    • 記号 - 通貨記号です。既定値は $です。記号に引用符を含めることはできません。
    • 末尾に設定 - 記号を値の前ではなく後に配置するには、このオプションを選択します。既定では、このオプションは選択されていません。
  • パーセンテージ
    • 小数点以下 - 小数点以下の桁数です。既定値は 2です。
  • 日付
    • 日付形式 - 日付形式です。 2012 年 3 月 14 日 (短い) または 2012 年 3 月 14 日水曜日 (長い) です。既定値は 2012 年 3 月 14 日です。
  • Time
    • 時刻形式 - 時刻形式です。 11:30 (時と分) または 11:30:55 (時、分、秒) です。既定値は 11:30 です。
    • AM/PM - このオプションを選択すると、24 時間形式ではなく 12 時間形式の AM/PM 形式が使用されます。既定では、このオプションは選択されていません。
  • カスタム
    • カスタム書式 - カスタムの Excel 数値書式文字列です。入力したとおりに使用されます。
  • [一般] と [テキスト] には追加のフィールドはありません。[全般] ではGeneral形式が適用され、[テキスト] では@形式が適用されます。

配置

• 横方向 - セルの内容を横方向に配置します。既存の配置を維持するには、このフィールドは設定しないままにします。以下のオプションから選択できます。
  • 全般
  • 左
  • 上下中央揃え
  • 右
  • 塗りつぶし
  • 両端揃え
  • 選択範囲内で中央
  • 均等割り付け
• 縦方向 - セルの内容を縦方向に配置します。既存の配置を維持するには、このフィールドは設定しないままにします。以下のオプションから選択できます。
  • 上限数
  • 上下中央揃え
  • 下
  • 両端揃え
  • 均等割り付け
• テキストを折り返す - セル内でテキストを折り返すには、このオプションを選択します。既定では、このオプションは選択されていません。この設定は、このオプションが選択されている場合、または水平方向または垂直方向の配置が設定されている場合に適用され、折り返しをオフにすることができます。それ以外の場合は、既存の折り返しが保持されます。

フォント

• フォント - フォント ファミリの名前です。既存のフォントを保持するには、このフィールドを設定しないままにします。
• フォント スタイル - フォント スタイルです。既存のスタイルを維持するには、このフィールドは設定しないままにします。以下のスタイルから選択できます。
  • 標準
  • 斜体
  • 太字
  • 太字斜体
• フォント サイズ - フォント サイズです (ポイント)。既存のサイズを維持するには、このフィールドは設定しないままにします。
• フォントの色 - フォントの色です。色名 (例: Red)、16 進数 ( #RRGGBB または #AARRGGBB 形式)。既存の色を維持するには、このフィールドは設定しないままにします。
• 下線の種類 - フォントの下線の種類です。既存のスタイルを維持するには、このフィールドは設定しないままにします。下線を削除するには、[ なし] を選択します。以下のスタイルから選択できます。
  • なし
  • Single
  • Double
  • 下線 (会計)
  • 二重下線 (会計)
• 塗りつぶしの色 - 塗りつぶしまたは背景色です。[ フォントの色] と同じ値を受け入れます。Transparentを入力して、塗りつぶしを削除します。既存の塗りつぶしが保持されるには、このフィールドは設定しないままにします。

オプション

• パスワード - ブックのパスワードです (必要な場合)。

ブックを使用する

• ブック - ファイル パスの代わりに使用する既存のブックです。

備考

• 値のない設定は適用されません。値を持つ設定 ( False や 0など) が適用されます。
• [フォントの色] と [塗りつぶしの色] では、大文字と小文字を考慮せずに、Red や LightGrayなどの既知のSystem.Drawing色、または 16 進数の色の名前を指定できます。それ以外の値を指定すると、設定を適用する前にエラーが発生します。まだカラー ピッカーがないため、色をテキストとして入力します。
• 列全体または行全体の範囲 ( A:Aなど) では、単一の列レベルまたは行レベルのスタイルが適用されます。これは Excel の動作と一致し、後で入力するセルにもスタイルが適用されます。
• 範囲は [シート名] のシートを参照する必要があります。Sheet2!A1:A10などのシート名を含む範囲はサポートされていないため、エラーが発生します。
• カスタム形式では、最初の数値、日付、または時刻のプレースホルダーの前に、二重引用符がペアで出現しない場合にエラーが発生します。これは、引用符の前にバックスラッシュが付いているかどうかに関係なく適用されます。たとえば、 "a"\"0.00 と \"0.00 は却下されます。