Shading クラス

定義

名前空間:

DocumentFormat.OpenXml.Wordprocessing

アセンブリ:

DocumentFormat.OpenXml.dll

パッケージ:

DocumentFormat.OpenXml v3.0.1

シェーディング クラスを定義します。

このクラスは、Office 2007 以降で使用できます。

オブジェクトを xml としてシリアル化されるときに、修飾名は w:shd です。

public class Shading : DocumentFormat.OpenXml.OpenXmlLeafElement

type Shading = class
    inherit OpenXmlLeafElement

Public Class Shading
Inherits OpenXmlLeafElement

継承

Object

OpenXmlElement

OpenXmlLeafElement

Shading

注釈

[ISO/IEC 29500-1 1st Edition]

shd (段落網掛け)

この要素は、段落の内容に適用される網かけを指定します。

このシェーディングは、次の 3 つのコンポーネントで構成されます。

• 背景色

• (省略可能)パターン

• (省略可能)パターンの色

結果のシェーディングは、段落の背後にある背景色を設定し、その背景の上にパターンによって提供されるマスクを使用してパターンの色を適用することによって適用されます。

この要素が特定の段落で省略された場合、その値は、スタイル階層の任意のレベルで以前に設定された設定によって決定されます (つまり、前の設定は変更されません)。 スタイル階層でこの設定が指定されていない場合は、段落の網かけは適用されません。

[例: 20% の塗りつぶしパターンを使用して、テーマの色 のアクセント 6 をオーバーレイしたテーマの色 のアクセント 3 で構成される背景を持つ必要がある段落を検討してください。 この要件は、次の WordprocessingML を使用して指定されます。

<w:pPr>  
  <w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" />   
</w:pPr>  

結果の段落では、pct20 パターン マスクで指定された前景パターンの色 accent6 の下に背景色 accent3 が使用されます。 例終わり]

親の要素
pPr (§17.3.1.26);pPr (§17.3.1.25);pPr (§17.7.5.2);pPr (§17.7.6.1);pPr (§17.9.23);pPr (§17.7.8.2)

この要素のコンテンツ モデルは、§17.3.5 の共通シェーディング プロパティ定義によって定義されます。

[ISO/IEC 29500-1 1st Edition]

shd (シェーディングの実行)

段落の網かけと同様に、この要素は実行の内容に適用される網かけを指定します。

このシェーディングは、次の 3 つのコンポーネントで構成されます。

• 背景色

• (省略可能)パターン

• (省略可能)パターンの色

結果のシェーディングは、段落の背後にある背景色を設定し、その背景の上にパターンによって提供されるマスクを使用してパターンの色を適用することによって適用されます。

この要素が存在しない場合、既定値は スタイル階層の前のレベルで書式設定を適用したままにします。 この要素がスタイル階層に適用されない場合、実行シェーディングはこの実行の内容に適用されません。

[例: 20% の塗りつぶしパターンを使用してオーバーレイされたテーマの色の text2 を持つテーマの色のアクセント 6 で構成される背景を持っている必要がある実行を検討してください。 この要件は、次の WordprocessingML を使用して指定されます。

<w:pPr>  
  <w:shd w:val="pct20" w:themeColor="text2" w:themeFill="accent6" />   
</w:pPr>  

結果の実行では、pct20 パターン マスクで指定された前景パターンの色 text2 の下に背景色 accent6 が使用されます。 例終わり]

親の要素
rPr (§17.3.1.29);rPr (§17.3.1.30);rPr (§17.5.2.28);rPr (§17.9.25);rPr (§17.7.9.1);rPr (§17.7.5.4);rPr (§17.3.2.28);rPr (§17.5.2.27);rPr (§17.7.6.2);rPr (§17.3.2.27)

この要素のコンテンツ モデルは、§17.3.5 の共通シェーディング プロパティ定義によって定義されます。

[ISO/IEC 29500-1 1st Edition]

shd (テーブル シェーディング例外)

この要素は、テーブル レベルのプロパティ例外のセットの一部として、現在の行のすべてのセルに適用する網かけを指定します。 段落網掛けと同様に、この網掛けは、テキストの有無に関係なく、表の罫線までのタブの内容に適用する必要があります。セル の網かけとは異なり、表の網かけには任意のセルパディングを含める必要があります。 このプロパティは、この行内の任意のセル (§17.4.33) のセル レベルの網掛けによって置き換えられます。

このシェーディングは、次の 3 つのコンポーネントで構成されます。

• 背景色

• (省略可能)パターン

• (省略可能)パターンの色

結果のシェーディングは、段落の背後にある背景色を設定し、その背景の上にパターンによって提供されるマスクを使用してパターンの色を適用することによって適用されます。

この要素を省略した場合、セル シェーディングは、現在のテーブルのテーブル レベルのセル シェーディング設定 (§17.4.32) によって決定されます。

[例: 最後の 2 行に一連のテーブル レベルのプロパティ例外があり、 背景 2 テーマの色にテーマの色の網掛けを与えるテーブルがあるとします。

このテーブル レベルのシェーディング例外は、次の WordprocessingML を使用して指定されます。

<w:tblPrEx>  
  <w:jc w:val="left" />   
  <w:shd w:val="clear" w:color="auto" w:fill="EEECE1" w:themeFill="background2" />   
</w:tblPrEx>  

shd 要素は、背景テーマの背景色 2 を使用して、明確なパターンを持つセル シェーディングを指定します。 例終わり]

親の要素
tblPrEx (§17.4.61);tblPrEx (§17.4.62)

この要素のコンテンツ モデルは、§17.3.5 の共通シェーディング プロパティ定義によって定義されます。

[ISO/IEC 29500-1 1st Edition]

shd (テーブル シェーディング)

この要素は、現在のテーブルのエクステントに適用する網かけを指定します。 段落網掛けと同様に、この網掛けは、テキストの有無に関係なく、表の罫線までのタブの内容に適用する必要があります。セル の網かけとは異なり、表の網かけには任意のセルパディングを含める必要があります。 このプロパティは、テーブル レベルのプロパティ例外 (§17.4.31) を使用して、セル レベルのシェーディングに置き換えられます。または、この行の任意のセル (§17.4.33)。

このシェーディングは、次の 3 つのコンポーネントで構成されます。

• 背景色

• (省略可能)パターン

• (省略可能)パターンの色

結果のシェーディングは、段落の背後にある背景色を設定し、その背景の上にパターンによって提供されるマスクを使用してパターンの色を適用することによって適用されます。

この要素を省略した場合、このテーブル内のセルには、関連付けられているテーブル スタイルで指定された網かけを使用する必要があります。 スタイル階層でセル シェーディングが指定されていない場合、このテーブル内のセルにはセル シェーディングを含めないようにします (つまり、セル シェーディングは透明になります)。

[例: 次のように、最初の行の最初のセルにセル レベルの赤い網掛けがあるテーブルを考えてみましょう。

R1c1

R1C2

R2C1

R2C2

このテーブル レベルのセル シェーディングは、次の WordprocessingML を使用して指定します。

<w:tbl>  
  <w:tblPr>  
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000"/>  
    …  </w:tblPr>  
  …</w:tbl>  

shd 要素は、FF0000 (赤) の背景色を使用して、明確なパターンでセル シェーディングを指定します。 例終わり]

親の要素
tblPr (§17.4.60);tblPr (§17.4.59);tblPr (§17.7.6.4);tblPr (§17.7.6.3)

この要素のコンテンツ モデルは、§17.3.5 の共通シェーディング プロパティ定義によって定義されます。

[ISO/IEC 29500-1 1st Edition]

shd (Table Cell Shading)

この要素は、現在のテーブル セルのエクステントに適用する網かけを指定します。 段落網掛けと同様に、この網かけは、テキストの有無に関係なく、セルの罫線までのセルの内容に適用されます。

このシェーディングは、次の 3 つのコンポーネントで構成されます。

• 背景色

• (省略可能)パターン

• (省略可能)パターンの色

結果のシェーディングは、段落の背後にある背景色を設定し、その背景の上にパターンによって提供されるマスクを使用してパターンの色を適用することによって適用されます。

この要素を省略した場合、セル シェーディングは、現在のテーブルのテーブル レベルまたはテーブル レベルの例外セル シェーディング設定 (§17.4.31;§17.4.32) によって決定されます。

[例: 次のように、最初の行の最初のセルにセル レベルの赤い網掛けがあるテーブルを考えてみましょう。

R1c1

R1C2

R2C1

R2C2

このセル シェーディングは、次の WordprocessingML を使用して指定します。

<w:tc>  
  <w:tcPr>  
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000" />  
  </w:tcPr>  
</w:tc>  

shd 要素は、FF0000 (赤) の背景色を使用して、明確なパターンでセル シェーディングを指定します。 例終わり]

親の要素
tcPr (§17.7.6.8);tcPr (§17.7.6.9);tcPr (§17.4.70);tcPr (§17.4.71)

この要素のコンテンツ モデルは、§17.3.5 の共通シェーディング プロパティ定義によって定義されます。

ISO/IEC29500: 2008。

コンストラクター

Shading()

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

プロパティ

ChildElements	現在の要素のすべての子ノードを取得します。 (継承元 OpenXmlElement)
Color	網かけパターンの色 スキーマ内の次の属性を表します: w:color
ExtendedAttributes	現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。 (継承元 OpenXmlElement)
Features	現在の要素の を IFeatureCollection 取得します。 この機能コレクションは読み取り専用ですが、使用可能な場合は親パーツとパッケージから機能を継承します。 (継承元 OpenXmlElement)
Fill	網かけの背景色 スキーマ内の次の属性を表します。 w:fill
FirstChild	OpenXmlElement 要素の最初の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
HasAttributes	現在の要素に属性があるかどうかを示す値を取得します。 (継承元 OpenXmlElement)
HasChildren	現在の要素に子要素があるかどうかを示す値を取得します。 (継承元 OpenXmlLeafElement)
InnerText	ノードとそのすべての子の連結値を取得または設定します。 (継承元 OpenXmlElement)
InnerXml	現在の要素の子要素のみを表すマークアップを取得または設定します。 (継承元 OpenXmlLeafElement)
LastChild	OpenXmlElement 要素の最後の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
LocalName	現在の要素のローカル名を取得します。 (継承元 OpenXmlElement)
MCAttributes	マークアップ互換性属性を取得または設定します。 現在の要素に対してマークアップ互換性属性が定義されていない場合は null を返します。 (継承元 OpenXmlElement)
NamespaceDeclarations	現在の要素で定義されているすべての名前空間宣言を取得します。 名前空間宣言がない場合は、空の列挙子を返します。 (継承元 OpenXmlElement)
NamespaceUri	現在の要素の名前空間 URI を取得します。 (継承元 OpenXmlElement)
OpenXmlElementContext	現在の要素の OpenXmlElementContext を取得します。 (継承元 OpenXmlElement)
OuterXml	現在の要素とそのすべての子要素を表すマークアップを取得します。 (継承元 OpenXmlElement)
Parent	現在の要素の親要素を取得します。 (継承元 OpenXmlElement)
Prefix	現在の要素の名前空間プレフィックスを取得します。 (継承元 OpenXmlElement)
ThemeColor	網掛けパターンのテーマの色 スキーマ内の次の属性を表します: w:themeColor
ThemeFill	シェーディングの背景テーマの色 スキーマ内の次の属性を表します。 w:themeFill
ThemeFillShade	網掛け 背景テーマ カラー シェード スキーマ内の次の属性を表します。 w:themeFillShade
ThemeFillTint	網かけ, 背景, テーマ, 色, 濃淡 スキーマ内の次の属性を表します。 w:themeFillTint
ThemeShade	網掛けパターンテーマカラーシェード スキーマ内の次の属性を表します。 w:themeShade
ThemeTint	網かけパターンテーマの色の濃淡 スキーマ内の次の属性を表します。 w:themeTint
Val	網かけパターン スキーマ内の次の属性を表します: w:val
XmlQualifiedName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)
XName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)

メソッド

AddAnnotation(Object)	現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。 (継承元 OpenXmlElement)
AddNamespaceDeclaration(String, String)	現在のノードに名前空間宣言を追加します。 (継承元 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)	現在の要素の子ノードのリストの末尾に、指定した要素を追加します。 (継承元 OpenXmlElement)
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)	指定した参照要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAfterSelf<T>(T)	現在の要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAt<T>(T, Int32)	現在の要素の子要素のリスト内の指定したインデックスに、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	指定した参照要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertBeforeSelf<T>(T)	現在の要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlElement)
IsAfter(OpenXmlElement)	指定した要素の後に現在の要素がドキュメントの順序で表示されるかどうかを判断します。 (継承元 OpenXmlElement)
IsBefore(OpenXmlElement)	指定した要素の前に現在の要素がドキュメントの順序で表示されるかどうかを判断します。 (継承元 OpenXmlElement)
LookupNamespace(String)	現在のノードのコンテキストの名前空間プレフィックスを解決します。 (継承元 OpenXmlElement)
LookupPrefix(String)	現在の要素スコープ内の名前空間 URI の対応するプレフィックスを検索します。 (継承元 OpenXmlElement)
NextSibling()	現在の OpenXmlElement 要素の直後にある OpenXmlElement 要素を取得します。 次の OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
NextSibling<T>()	現在の OpenXmlElement 要素に続く指定した型を持つ OpenXmlElement 要素を取得します。 次の OpenXmlElement がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PrependChild<T>(T)	現在の要素の子要素のリストの先頭に、指定した要素を挿入します。 (継承元 OpenXmlElement)
PreviousSibling()	現在の OpenXmlElement 要素のすぐ前にある OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PreviousSibling<T>()	現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
Remove()	現在の要素を親から削除します。 (継承元 OpenXmlElement)
RemoveAllChildren()	現在の要素のすべての子要素を削除します。 (継承元 OpenXmlLeafElement)
RemoveAllChildren<T>()	T 型の現在の要素の子要素をすべて削除します。 (継承元 OpenXmlElement)
RemoveAnnotations(Type)	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAnnotations<T>()	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAttribute(String, String)	現在の要素から 属性を削除します。 (継承元 OpenXmlElement)
RemoveChild<T>(T)	現在の要素の子要素の一覧から、指定した子要素を削除します。 (継承元 OpenXmlElement)
RemoveNamespaceDeclaration(String)	指定したプレフィックスの名前空間宣言を削除します。 プレフィックスがない場合は、何も削除しません。 (継承元 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	子要素を、現在の要素の子要素のリスト内の別の子要素に置き換えます。 (継承元 OpenXmlElement)
SetAttribute(OpenXmlAttribute)	指定した要素に属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	要素に複数の属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
WriteTo(XmlWriter)	現在のノードを指定した XmlWriter に保存します。 (継承元 OpenXmlElement)

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

IEnumerable.GetEnumerator()	シェーディング クラスを定義します。 このクラスは、Office 2007 以降で使用できます。 オブジェクトを xml としてシリアル化されるときに、修飾名は w:shd です。 (継承元 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	子コレクションを反復処理する列挙子を返します。 (継承元 OpenXmlElement)