ConditionalFormattingRule クラス

定義

ConditionalFormattingRule クラスを定義します。このクラスは Office2010 以上で使用できます。 オブジェクトを xml としてシリアル化されるときに、修飾名は x14:cfRule です。

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement
type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement
Public Class ConditionalFormattingRule
Inherits OpenXmlCompositeElement
継承
ConditionalFormattingRule
属性

注釈

2.6.27 CT_CfRule

*ターゲット名前空間:*http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

参照先: CT_ConditionalFormatting

この複合型は、範囲の条件付き書式ルールを指定します。

子要素:

xm:f: 条件付き書式ルールの数式を指定する f 要素。 数式は、次の制限を使用して、数式で指定された文法に従う必要があります。

式は、ref-infix-operator、book-prefix、local-cell-reference、array-constant、bang-reference、bang-name、sheet-range-reference、または構造参照の実稼働ルールに準拠しなけい。

数式は、単一シート領域の生産ルールと一致しなけい。

次の表では、数式の解釈方法について説明します。

型の値 f の数式の解釈
cellIs 演算子で指定された ST_ConditionalFormattingOperator ([ISO/IEC-29500-1] セクション 18.18.15) のオペランドを指定する数式、数値、またはセル参照を指定する f 要素。演算子が "between" または "notBetween" の場合、f MUST には 2 つの数式が含まれている必要があります。それ以外の場合、f MUST は 1 つの数式を含む必要があります。
expression 数式を指定する f 要素。数式が 0 を返す場合、条件付き書式は表示されません。数式が 0 以外の値を返す場合、条件付き書式が表示されます。
colorScale、dataBar、iconSet 数式を指定する f 要素。数式が 0 を返す場合、条件付き書式は表示されません。数式が 0 以外の値を返す場合、または存在しない場合は、条件付き書式が表示されます。
containsText, notContainsText, beginsWith,

endsWith,

containsBlanks、notContainsBlanks、

containsErrors,

notContainsErrors
型で指定された操作を実装する数式を指定する f 要素。数式が 0 を返す場合、条件付き書式は表示されません。数式が 0 以外の値を返す場合、条件付き書式が表示されます。

colorScale: 色CT_ColorScaleを指定する要素を指定します。

dataBar: データ CT_DataBarを指定する要素です。

iconSet: アイコン CT_IconSetを指定 する要素です

*dxf:*範囲に適用される 差分書式 ([ISO/IEC-29500-1] セクション M.2.7.3.8) を指定する CT_Dxf ([ISO/IEC-29500-4] セクション A.2) 要素。 type "colorScale"、"dataBar"、または "iconSet"の場合、または priority 属性が存在しない場合、この要素は存在していなければなりません。

extLst: この CT_ExtensionList 拡張を指定する要素 ([ISO/IEC-29500-4] セクション A.2) 要素です。

属性:

型: 範囲 ST_CfType 条件付き書式の表示方法を指定するプロパティ ([ISO/IEC-29500-1] セクション 18.18.12) 属性。

type が"colorScale" の場合のみ 、colorScale 子要素は、この要素に存在する必要があります。

型が "dataBar" の場合のみ 、dataBar 子要素は、この要素に存在する必要があります。

type が "iconSet" の場合のみ 、iconSet 子要素は、この要素に存在する必要があります。

優先度: このルールの相対的な優先度をこのシート (1) の他のルールと比較して指定する int ([XMLSCHEMA2] セクション 3.3.17) 属性、または関連付けられた CT_CfRule ([ISO/IEC-29500-4] セクション A.2) 要素で指定された条件付き書式データ バー ルールの拡張情報をこの CT_CfRule が指定するかどうかを指定します。 0 より大きい必要があります。

優先度 存在する場合、ルールは最小優先度から最大の優先度に順に適用され、同じワークシート パーツに存在する他の CT_CfRule または CT_CfRule ([ISO/IEC-29500-4] セクション A.2) 要素の優先度値を複製しなけらねない。

優先度 存在しない場合、CT_CfRuleは条件付き書式データ バー ルールの拡張情報を指定し 、dataBar 子要素が存在し、この追加情報を記述する必要があります。 id 属性は、関連付けられた CT_CfRule ([ISO/IEC-29500-4] セクション A.2) を識別するために使用され、この CT_CfRule ([ISO/IEC-29500-4] セクション A.2) の優先度属性は、このルールの相対的な優先度を指定します。 この要素にpriority 属性も id 属性も存在しない場合、または id が存在するが 、一 致する GUID を含む CT_CfRule ([ISO/IEC-29500-4]セクション A.2) 要素が存在しない場合は、このレコードと、その後の dataBar 子要素を無視する必要があります。 この要素に priority 属性が存在する場合は 、id を無視する必要があります。

stopIfTrue: ブール ([XMLSCHEMA2] セクション 3.2.2) 属性で、このルールがセルに対して "true" と評価された場合に、セルに対して追加の条件付き書式ルールの評価がスキップされるかどうかを指定します。

aboveAverage: 表で指定した範囲の他のセルの平均値以上の値を持つセルに条件付き書式ルールを適用するかどうかを指定するブール値 ([XMLSCHEMA2] セクション 3.2.2) 属性。 type が "aboveAverage" と等しくない場合、この属性は存在していなければなりません。

意味
"true" 条件付き書式ルールは、範囲内のすべてのセルの平均値を超す値を持つセルに適用されます。
"false" 条件付き書式ルールは、範囲内のすべてのセルの平均値を下回る値を持つセルに適用されます。

パーセント: 表で指定したセルの割合に条件付き書式ルールを適用するかどうかを指定するブール型 ([XMLSCHEMA2] セクション 3.2.2) 属性。 type が "top10" に等しくない場合、この属性は存在していなければなりません。

意味
"true" rank は、条件付き書式が適用される範囲のセルの割合を指定します。
"false" 条件付き書式ルールは、ランクで指定されたセル数に適用されます。

下: 表で指定した条件付き書式ルールの適用方法を指定するブール型 ([XMLSCHEMA2] セクション 3.2.2) 属性。 type が "top10" に等しくない場合、この属性は存在していなければなりません。

意味
"true" 条件付き書式は、パーセントとランクで指定された範囲の下端にある値を持つセルに適用されます。
"false" 条件付き書式は、パーセントとランクで指定された範囲の上端にある値を持つセルに適用されます。

演算子: この 条件付ST_ConditionalFormattingOperator に使用する値の比較の種類を指定する属性 ([ISO/IEC-29500-1] セクション 18.18.15) 属性。 type が "cellIs" と等しくない 場合、この属性は存在していなければなりません。

text: この 条件付 き書式ルールに使用されるテキスト値を指定する文字列 ([XMLSCHEMA2] セクション 3.2.1) 属性。 type が "beginsWith"、"containsText"、"endsWith"、または "notContainsText" に等しくない場合、この属性は存在していなければなりません。

timePeriod: この 条件付ST_TimePeriod ルールに使用される期間を指定する ST_TimePeriod ([ISO/IEC-29500-1] セクション 18.18.82) 属性。 型が "timePeriod" と等しくない場合、この属性は存在していなければなりません。

rank: この 条件付き書式ルール によって書式設定されるセルの数を指定する、unsignedInt ([XMLSCHEMA2] セクション 3.3.22) 属性。 パーセントの値 、ランクがセル の割合 か量かを指定します。 % "true" の場合、 ランク は 0 以上、100 以下である必要があります。 それ以外の場合 、ランク は 1 以上 1,000 以下である必要があります。 type が "top10" に等しくない場合、この属性は存在していなければなりません。

*stdDev:*条件付き書式 ルールで書式設定する平均より上または下の標準偏差の数を指定する int ([XMLSCHEMA2] セクション 3.3.17) 属性。 type が "aboveAverage" と等しくない場合、または equalAverage が "true" の場合、この属性は存在していなければなりません。

equalAverage: ブール ([XMLSCHEMA2] セクション 3.2.2) 属性で、上記 のAverage と共に、次の表で指定した条件付き書式ルールの適用方法を指定します。 type が "aboveAverage" と等しくない場合、この属性は存在していなければなりません。

equalAverage の値 上記の値Average 意味
"true" "true" 条件付き書式は、範囲内のセルの平均値以上の値を持つセルに適用されます。
"true" "false" 条件付き書式は、範囲内のセルの平均値以下の値を持つセルに適用されます。
"false" "true" 条件付き書式は、値が範囲内のすべてのセルの平均値に stdDev を加え、範囲内のすべてのセルの標準偏差を乗算したセルに適用されます。
"false" "false" 条件付き書式は、値が stdDev を引いた範囲内のすべてのセルの平均値を下回り、範囲内のすべてのセルの標準偏差を乗算したセルに適用されます。

activePresent: 数式 f に存在し、型が "colorScale"、"dataBar"、または "iconSet" の場合にのみ、"true" である必要があるブール型 ([XMLSCHEMA2] セクション 3.2.2) 属性。

id: この ST_Guid を識別する属性 ([ISO/IEC-29500-1] セクション 22.9.2.4) を指定します。 priority属性が存在せず、この属性が存在する場合、この属性は、この CT_CfRule 要素を対応する CT_CfRule ([ISO/IEC-29500-4] セクション A.2) 要素と一致するために使用されます。 priority 属性も この 属性も存在しない場合は、この属性CT_CfRule子要素CT_DataBar無視する必要があります。

次の W3C XML スキーマ ([XMLSCHEMA1] セクション 2.1) フラグメントは、この複合型の内容を指定します。

<xsd:complexType name="CT_CfRule">

<xsd:sequence>

<xsd:element ref="xm:f" minOccurs="0" maxOccurs="3"/>

<xsd:element name="colorScale" type="CT_ColorScale" minOccurs="0" maxOccurs="1"/>

<xsd:element name="dataBar" type="CT_DataBar" minOccurs="0" maxOccurs="1"/>

<xsd:element name="iconSet" type="CT_IconSet" minOccurs="0" maxOccurs="1"/>

<xsd:element name="dxf" type="x:CT_Dxf" minOccurs="0" maxOccurs="1"/>

<xsd:element name="extLst" type="x:CT_ExtensionList" minOccurs="0" maxOccurs="1"/>

</xsd:sequence>

<xsd:attribute name="type" type="x:ST_CfType" use="optional"/>

<xsd:attribute name="priority" type="xsd:int" use="optional"/>

<xsd:attribute name="stopIfTrue" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="aboveAverage" type="xsd:boolean" use="optional" default="true"/>

<xsd:attribute name="percent" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="bottom" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="operator" type="x:ST_ConditionalFormattingOperator" use="optional"/>

<xsd:attribute name="text" type="xsd:string" use="optional"/>

<xsd:attribute name="timePeriod" type="x:ST_TimePeriod" use="optional"/>

<xsd:attribute name="rank" type="xsd:unsignedInt" use="optional"/>

<xsd:attribute name="stdDev" type="xsd:int" use="optional"/>

<xsd:attribute name="equalAverage" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="activePresent" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="id" type="x:ST_Guid" use="optional"/>

</xsd:complexType>

完全な W3C XML スキーマ ([XMLSCHEMA1] セクション 2.1) については、セクション 5.4 を参照してください。

コンストラクター

ConditionalFormattingRule()

ConditionalFormattingRule クラスの新しいインスタンスを初期化します。

ConditionalFormattingRule(IEnumerable<OpenXmlElement>)

指定した子要素を持つ ConditionalFormattingRule クラスの新しいインスタンスを初期化します。

ConditionalFormattingRule(OpenXmlElement[])

指定した子要素を持つ ConditionalFormattingRule クラスの新しいインスタンスを初期化します。

ConditionalFormattingRule(String)

外部 XML から ConditionalFormattingRule クラスの新しいインスタンスを初期化します。

プロパティ

AboveAverage

aboveAverage.スキーマの次の属性を表します。 aboveAverage

ActivePresent

activePresent.スキーマの次の属性を表します。 activePresent

Bottom

下。スキーマの下の次の属性を表します。

ChildElements

現在の要素のすべての子ノードを取得します。

(継承元 OpenXmlElement)
EqualAverage

equalAverage.スキーマの次の属性を表します。 equalAverage

ExtendedAttributes

現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。

(継承元 OpenXmlElement)
FirstChild

現在の OpenXmlElement 要素の最初の子を取得します。

(継承元 OpenXmlCompositeElement)
HasAttributes

現在の要素に属性が含されているかどうかを示すブール値を取得します。

(継承元 OpenXmlElement)
HasChildren

現在の要素に子要素が含されているかどうかを示す値を取得します。

(継承元 OpenXmlCompositeElement)
Id

id.スキーマの次の属性を表します。 id

InnerText

現在のノードとそのすべての子の連結値を取得または設定します。

(継承元 OpenXmlCompositeElement)
InnerXml

現在のノードの子ノードのみを表すマークアップを取得または設定します。

(継承元 OpenXmlCompositeElement)
LastChild

現在の OpenXmlElement 要素の最後の子を取得します。 このような OpenXmlElement 要素がないVisual Basic null (Nothing in Visual Basic) を返します。

(継承元 OpenXmlCompositeElement)
LocalName

要素のローカル名を取得します。

MCAttributes

マークアップの互換性属性を設定します。 現在の要素に対してマークアップ互換性属性が定義されていない場合は null を返します。

(継承元 OpenXmlElement)
NamespaceDeclarations

現在の要素で定義されている名前空間宣言を取得します。 名前空間宣言がない場合は、空の列挙子を返します。

(継承元 OpenXmlElement)
NamespaceUri

現在の要素の名前空間 URI を取得します。

(継承元 OpenXmlElement)
OpenXmlElementContext

現在の要素の OpenXmlEementContext を取得します。

(継承元 OpenXmlElement)
Operator

演算子。スキーマ内の次の属性を表します。

OuterXml

現在の要素とそのすべての子要素を表すマークアップを取得します。

(継承元 OpenXmlElement)
Parent

現在の要素の親要素を取得します。

(継承元 OpenXmlElement)
Percent

パーセント。スキーマ内の次の属性を表しますパーセント。

Prefix

現在の要素の名前空間プレフィックスを取得します。

(継承元 OpenXmlElement)
Priority

優先度を指定します。スキーマの次の属性を表します。

Rank

ランク。スキーマの次の属性を表します。

StandardDeviation

stdDev.スキーマの次の属性を表します。 stdDev

StopIfTrue

stopIfTrue.スキーマの次の属性を表します。 stopIfTrue

Text

text。スキーマ内の次の属性を表します。

TimePeriod

timePeriod.スキーマの次の属性を表します。 timePeriod

Type

型を指定します。スキーマの次の属性を表します。

XmlQualifiedName

現在の要素の修飾名を取得します。

(継承元 OpenXmlElement)
XName

現在の要素の修飾名を取得します。

(継承元 OpenXmlElement)

メソッド

AddAnnotation(Object)

現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。

(継承元 OpenXmlElement)
AddNamespaceDeclaration(String, String)

現在のノードに namepace 宣言を追加します。

(継承元 OpenXmlElement)
Ancestors()

現在の要素のすべての先祖を列挙します。

(継承元 OpenXmlElement)
Ancestors<T>()

指定した型を持つ現在の要素の先祖のみを列挙します。

(継承元 OpenXmlElement)
Annotation(Type)

現在の OpenXmlElement 要素から、指定した型の最初の注釈オブジェクトを取得します。

(継承元 OpenXmlElement)
Annotation<T>()

現在の OpenXmlElement 要素から、指定した型の最初の注釈オブジェクトを取得します。

(継承元 OpenXmlElement)
Annotations(Type)

現在の OpenXmlElement 要素の指定した型を持つ注釈のコレクションを取得します。

(継承元 OpenXmlElement)
Annotations<T>()

現在の OpenXmlElement 要素の指定した型を持つ注釈のコレクションを取得します。

(継承元 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)

要素のリストから、現在の要素の子要素のリストの末尾に各要素を追加します。

(継承元 OpenXmlElement)
Append(OpenXmlElement[])

要素の配列から、現在の要素の子要素のリストの末尾に各要素を追加します。

(継承元 OpenXmlElement)
AppendChild<T>(T)

指定した要素を、現在の要素の子ノードのリストの末尾に追加します。

(継承元 OpenXmlCompositeElement)
ClearAllAttributes()

既知の属性と拡張属性の両方を含む、すべての属性をクリアします。

(継承元 OpenXmlElement)
Clone()

現在のノードの複製を作成します。

(継承元 OpenXmlElement)
CloneNode(Boolean)

このノードの複製を作成します。

Descendants()

現在の要素のすべての子孫を列挙します。

(継承元 OpenXmlElement)
Descendants<T>()

現在の要素の T 型のすべての子孫を列挙します。

(継承元 OpenXmlElement)
Elements()

現在の要素のすべての子を列挙します。

(継承元 OpenXmlElement)
Elements<T>()

指定した型を持つ現在の要素の子のみを列挙します。

(継承元 OpenXmlElement)
ElementsAfter()

現在の要素に従い、現在の要素と同じ親を持つすべての兄弟要素を列挙します。

(継承元 OpenXmlElement)
ElementsBefore()

現在の要素の前に、現在の要素と同じ親を持つすべての兄弟要素を列挙します。

(継承元 OpenXmlElement)
GetAttribute(String, String)

指定したタグ名と名前空間 URI を持つ Open XML 属性を取得します。

(継承元 OpenXmlElement)
GetAttributes()

すべての属性のコピーを含むリストを取得します。

(継承元 OpenXmlElement)
GetEnumerator()

子コレクションを反復処理する列挙子を返します。

(継承元 OpenXmlElement)
GetFirstChild<T>()

型 T の最初の子要素を検索します。

(継承元 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)

指定した参照要素の直後に、指定した要素を挿入します。

(継承元 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)

現在の要素の直後に指定した要素を挿入します。

(継承元 OpenXmlElement)
InsertAt<T>(T, Int32)

現在の要素の子の指定したインデックスに、指定した要素を挿入します。

(継承元 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)

指定した参照要素の直前に、指定した要素を挿入します。

(継承元 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)

現在の要素の直前に指定した要素を挿入します。

(継承元 OpenXmlElement)
IsAfter(OpenXmlElement)

ドキュメントの順序で指定した要素の後に現在の要素が表示されるかどうかを指定します。

(継承元 OpenXmlElement)
IsBefore(OpenXmlElement)

現在の要素が文書の順序で指定された要素の前に表示されるかどうかを指定します。

(継承元 OpenXmlElement)
LookupNamespace(String)

現在のノードのコンテキストで名前空間プレフィックスを解決します。

(継承元 OpenXmlElement)
LookupPrefix(String)

現在の要素スコープ内の名前空間 uri の対応するプレフィックスを検索します。

(継承元 OpenXmlElement)
NextSibling()

現在の OpenXmlElement 要素の直後にある OpenXmlElement 要素を取得します。 次の OpenXmlElement 要素がないVisual Basic null (Nothing in Visual Basic) を返します。

(継承元 OpenXmlElement)
NextSibling<T>()

現在の OpenXmlElement 要素に続く、指定した型を持つ OpenXmlElement 要素を取得します。 次の OpenXmlElement がないVisual Basic null (Nothing in Visual Basic) を返します。

(継承元 OpenXmlElement)
PrependChild<T>(T)

現在の要素の子ノードのリストの先頭に指定した要素を挿入します。

(継承元 OpenXmlCompositeElement)
PreviousSibling()

現在の OpenXmlElement 要素の直前にある OpenXmlElement 要素を取得します。 前の OpenXmlElement 要素がないVisual Basic null ( Nothing in Visual Basic ) を返します。

(継承元 OpenXmlElement)
PreviousSibling<T>()

現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。 前の OpenXmlElement 要素がない場合は、null (Visual Basic 内の Nothing) を返します。

(継承元 OpenXmlElement)
Remove()

現在の要素を親から削除します。

(継承元 OpenXmlElement)
RemoveAllChildren()

現在の要素のすべての子要素を削除します。

(継承元 OpenXmlCompositeElement)
RemoveAllChildren<T>()

T 型の現在の要素のすべての子要素を削除します。

(継承元 OpenXmlElement)
RemoveAnnotations(Type)

現在の OpenXmlElement 要素から、指定した型の注釈を削除します。

(継承元 OpenXmlElement)
RemoveAnnotations<T>()

現在の OpenXmlElement 要素から、指定した型の注釈を削除します。

(継承元 OpenXmlElement)
RemoveAttribute(String, String)

現在の要素から属性を削除します。

(継承元 OpenXmlElement)
RemoveChild<T>(T)

指定した子要素を削除します。

(継承元 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)

指定したプレフィックスの名前空間宣言を削除します。 プレフィックスがない場合は何も削除しません。

(継承元 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)

現在の要素の子要素の 1 つを別の OpenXmlElement 要素に置き換える。

(継承元 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)

属性を指定した要素に設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合、'openxmlAttribute' が拡張属性リストに追加されます。

(継承元 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)

要素に対して多数の属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合、'openxmlAttribute' が拡張属性リストに追加されます。

(継承元 OpenXmlElement)
WriteTo(XmlWriter)

現在のノードを指定した XmlWriter に保存します。

(継承元 OpenXmlElement)

明示的なインターフェイスの実装

IEnumerable.GetEnumerator() (継承元 OpenXmlElement)

適用対象