HtmlElement.OffsetParent プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

HtmlElement.OffsetParent プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

OffsetRectangle を計算するときの基準となる要素を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 OffsetParent As HtmlElement

Visual Basic (使用法)

Dim instance As HtmlElement
Dim value As HtmlElement

value = instance.OffsetParent

public HtmlElement OffsetParent { get; }

C++

public:
property HtmlElement^ OffsetParent {
    HtmlElement^ get ();
}

/** @property */
public HtmlElement get_OffsetParent ()

JScript

public function get OffsetParent
 () : HtmlElement

プロパティ値
オフセットを計算するときの基準となる要素。要素の親、または要素の階層に含まれる別の要素が、相対位置または絶対位置を使用している場合、OffsetParent は、相対位置または絶対位置を使用している要素のうち、現在の要素が入れ子になっている最初の要素です。現在の要素の上位にある要素が絶対位置または相対位置を使用していない場合、OffsetParent はドキュメントの BODY タグになります。

解説

HTML ページにおける要素の位置は、既定のフロー位置、相対位置 (要素がその親を基準に固定の距離だけオフセットされる)、および絶対位置 (要素にドキュメントの左上隅を基準とした固定の座標が設定される) の 3 つのうち、いずれかの方法で決定されます。

ドキュメントの要素が相対位置または絶対位置を使用している場合、OffsetParent を使用して、要素のクライアント領域における座標位置を計算できます。

HTML における要素の位置の詳細については、「About Element Positioning」(http://msdn.microsoft.com/library/default.asp?url=/workshop/author/position/positioning.asp) を参照してください。

使用例

次のコード例を使用すると、OffsetParent および OffsetRectangle の動作が、span1、span2、span3 で、それぞれどのように異なるかを確認できます。

<HTML>
    <BODY>

        <DIV>
            <SPAN>Placeholder text 1.</SPAN>
        </DIV>

        <DIV style="position:relative;top:100px;left:100px;">
            <SPAN>Placeholder text 2.</SPAN>
        </DIV>

        <DIV style="position:absolute;top:200px;left:200px;">
            <DIV style="position:relative;top:100px;left:100px;">
                <SPAN>Placeholder text 3.</SPAN>
            </DIV>
        </DIV>

    </BODY>
</HTML>

private void GetOffsets()
{
    String str = "";
    HtmlDocument doc = webBrowser1.Document;

    foreach (HtmlElement elem in doc.GetElementsByTagName("SPAN"))
    {
        str += "OffsetParent for " + elem.Id + "
 is " + elem.OffsetParent.Id;
        str += "; OffsetRectangle is " + elem.OffsetRectangle.ToString()
 + "\n";
    }

    MessageBox.Show(str);
}