|
不規則な形のリージョンをサポートするにはこのメソッドをオーバーライドします。
|
ポイントがエレメントの四角形の内部にあれば True を返します。
|
|
このメソッドは、エレメントの背景色を描画するために、描画操作中に DrawTheme の後に呼び出されます。通常、このメソッドは、エレメントの背景を描画しない null 実装となるようにオーバーライドされます(たとえば TextUIElement はこのように動作します)。このメソッドを使用してカスタムの描画を実行することもできます。
|
渡された UIElementDrawParams 構造体の DrawBackColor メソッドを呼び出して、無効な領域を塗りつぶします。
|
|
このメソッドは、エレメントの境界線を描画するために、描画操作中に DrawImageBackground の後に呼び出されます。実際には、このメソッドをオーバーライドしなければならないケースは非常にまれです。 これは、BorderStyleとBorderSides の各プロパティによって境界線を非常に柔軟に制御できるためです。しかし、カスタムの境界線描画を実行するためにこのメソッドをオーバーライドすることもできます。
|
渡された UIElementDrawParams 構造体の DrawBorders メソッドを呼び出します。このメソッドは、エレメントの BorderStyle プロパティと BorderSides プロパティに基づいて境界線を描画します。
|
|
このメソッドは、エレメントの子エレメントを描画するために、描画操作中に DrawForeground の後に呼び出されます。通常、このメソッドは、エレメントの子エレメントを描画しない null 実装となるようにオーバーライドされます。
|
|
|
このメソッドは、エレメントのフォーカス インジケータを描画するために、描画操作中に呼び出されます。エレメントとすべてのその子エレメントの描画が完了した後に呼び出されます。コントロールがフォーカスを持っていて(または Draw メソッドの呼び出し時に forceDrawAsFocused パラメータが True に設定されていて)、エレメントが DrawsFocusRect プロパティから True を返す場合にだけ、呼び出されます。
|
RectInsideBorders プロパティを使用して、エレメントの境界線内部のフォーカス四角形を描画します。
|
|
このメソッドは、エレメントの前景を描画するために、描画操作中に DrawImage の後に呼び出されます(たとえば TextUIElement はこのメソッドでテキストを描画します)。
|
|
|
このメソッドは、エレメントの前景イメージを描画するために、描画操作中に DrawBorders の後に呼び出されます(たとえば UIElement はこのメソッドでイメージを描画します)。
|
|
|
このメソッドは、エレメントの背景イメージを描画するために、描画操作中に DrawBackColor の後に呼び出されます。通常、このメソッドは、エレメントの背景を描画しないように null 実装を提供するためにオーバーライドされます(たとえば TextUIElement はこのように動作します)。このメソッドを使用してカスタムの描画を実行することもできます。
|
渡された UIElementDrawParams 構造体により提供されている、解決された外観の ImageBackground を描画します。
|
|
このメソッドは、エレメントを XP テーマ エレメントとして描画するために描画操作中に最初に呼び出される「Draw…」メソッドです。ドロップダウン ボタンエレメントやスクロールバー エレメントなどのテーマ エレメントはこのメソッドをオーバーライドし、XPThemes クラスを使用してエレメントを適切に表示します。そして、他の描画メソッドが省略されるように True を返します。
|
何もせず、他の「Draw…」メソッドが呼び出されるように False を返します。
|
|
このメソッドは、Adjustable プロパティから True が返されるエレメントによってオーバーライドされ、マウスがエレメントの調整可能領域の上にあるときに適切なカーソルを供給します。
|
|
|
range パラメータには、エレメントを縦横方向またはどちらか一方の方向に調整する際の範囲の限界を含む構造体が設定されます。また、マウスのドラッグ操作中に反転させる必要のある垂直バーおよび水平バーに対応した四角形の初期値も返します。
|
range パラメータに、0 で満たされた構造体を設定します。
|
|
このメソッドはエレメントのコンテキストを返します。一般に、このメソッドをオーバーライドすることはあまりありません。通常は、コンテキスト オブジェクトを複数持つエレメントによってのみオーバーライドされます(つまり、基本クラスの PrimaryContext プロパティでは十分でないことを意味します)。たとえば、UltraGrid でこのメソッドをオーバーライドするエレメントは RowColRegionIntersectionUIElement のみです。 このエレメントは RowScrollRegion オブジェクトと ColScrollRegion オブジェクトの両方の参照を維持する必要があります。
|
コンテキスト オブジェクトがすでに設定されているかどうか、およびその型と要求された型とが一致するかどうかをチェックします。どちらも成立する場合はコンテキスト オブジェクトを返します。 どちらかが成立しない場合は、このメソッドをその親で呼び出します(これは実質的には、一致するものが見つかるまで、またはコントロールのメイン エレメントに達するまで、親チェーンをたどることを示します)。この動作は重要です。たとえば、アプリケーションが CellUIElement の子 TextUIElement の Row コンテキストを要求した場合、このメソッドは RowUIElement に達するまで親エレメント チェーンをたどり、適切な Row コンテキストを返します。
|
|
エレメントが自身の前景色、背景色、境界線の色などを指定できるように、要素が描画される前に呼び出されます。注:デフォルト値のままの外観設定には、すべて親エレメントの設定が適用されます(ImageBackground、BackGradientStyle、BackHatchStyle の各プロパティを除く)。
|
|
|
通常はこのメソッドをオーバーライドすることはありません。
|
エレメントの四角形のオフセットを設定します。 recursive フラグが True であれば、各子エレメントについてこのメソッドを呼び出します。
|
|
|
|
|
|
|
|
OnMouseDown 内など、マウスをキャプチャしたエレメントでマウスのキャプチャがキャンセルされたときに呼び出されます。
|
パニング タイマーをすべて停止し、カーソルをリセットした後、エレメントの親エレメントでこのメソッドを呼び出します。これは実質的には親チェーンをたどることを示します。
|
|
マウスがエレメントの上でクリックされたときに呼び出されます。
|
エレメントの親エレメントでこのメソッドを呼び出します。これは実質的には親チェーンをたどることを示します。
|
|
マウスがエレメントの上でダブルクリックされたときに呼び出されます。
|
エレメントの親エレメントでこのメソッドを呼び出します。これは実質的には親チェーンをたどることを示します。
|
|
このメソッドは、マウスがエレメントの上にある間にマウス ボタンが押されたときに呼び出されます。通常は、何らかのアクションを実行したりマウスをキャプチャするようにオーバーライドされます。このメソッドから戻る前に、captureMouseForElement パラメータにエレメント(通常はこのエレメント)を設定すると、そのエレメントに対してマウスがキャプチャされ、続いて OnMouseMove が呼び出されます。
|
マウス中央のボタンが押されて SupportsHorizontalMousePanning または SupportsVerticalMousePanning プロパティが True を返すと、適切なマウスのパンニング カーソルが表示され、OnMousePanHorizontal または OnMousePanVertical メソッドの呼び出しを生成するタイマーが始まり、メソッドが True を返します。それ以外の場合は、エレメントがメソッドをオーバーライドするか、またはメイン エレメントに達するまで、その親エレメントでこのメソッドを呼び出し(実質的には親チェーンをたどり)、False を返します。
|
|
このメソッドは、マウスがエレメントの四角形に入ったときに呼び出されます。
|
|
|
通常、このメソッドはツールチップを表示するようにオーバーライドされます。このメソッドはマウスがエレメントの上で停止したときに呼び出されます。このメソッドをオーバーライドする場合は、WantsMouseHoverNotification プロパティもオーバーライドし、True を返してください。
|
エレメントの親エレメントでこのメソッドを呼び出します。これは実質的には親チェーンをたどることを示します。
|
|
このメソッドは、マウスがエレメントの四角形から出たときに呼び出されます。
|
|
|
マウスがエレメントの上に移動したとき、またはマウスが移動してエレメントが OnMouseDown でマウスをキャプチャしたときに呼び出されます。
|
エレメントの親エレメントでこのメソッドを呼び出します。これは実質的には親チェーンをたどることを示します。
|
|
このメソッドは、水平パニング操作中に、SupportsHorizontalMousePanning プロパティに対して True を返すエレメントによって呼び出されます。カーソル位置と基点マーク間のピクセル数がこのメソッドに渡されます。この値は、カーソルが基点マークよりも右にある場合は正、基点マークよりも左にある場合は負、基点マークのしきい値内にある場合は 0 になります。
|
何もしません。SupportsHorizontalMousePanning プロパティに対して True を返すエレメントで、オーバーライドしてください。
|
|
このメソッドは、垂直パニング操作中に、SupportsVerticalMousePanning プロパティに対して True を返すエレメントによって呼び出されます。カーソル位置と基点マーク間のピクセル数がこのメソッドに渡されます。この値は、カーソルが基点マークよりも下にある場合は正、基点マークよりも上にある場合は負、基点マークのしきい値内にある場合は 0 になります。
|
何もしません。SupportsVerticalMousePanning プロパティに対して True を返すエレメントで、オーバーライドしてください。
|
|
マウス ボタンがエレメントの上で離されたとき、またはマウスボタンが離されてエレメントが OnMouseDown でマウスをキャプチャしたときに呼び出されます。注:このメソッドから True が返されると、次回のクリック イベントが無視されます。
|
パニング タイマーをすべて停止し、カーソルをリセットした後、エレメントの親エレメントでこのメソッドを呼び出します。これは実質的には親チェーンをたどることを示します。
|
|
このメソッドは、Adjustable プロパティから True を返すエレメントによってオーバーライドされ、ポイントがエレメントの調整可能領域の上にあるかどうかを調べます。 たとえば、列ヘッダ エレメントでユーザーが右側の境界線の 3 ピクセル以内をクリックした場合に列ヘッダ エレメントの幅を変更できるようにする、という動作を実現できます。この場合、このメソッドは、ポイントが右側の境界線の 3 ピクセル以内にある場合に True を返します。
|
|
|
このメソッドは、エレメントがその子エレメントの作成や配置を必要とするときに呼び出されます。子エレメントを持つエレメントはすべて、このメソッドをオーバーライドする必要があります。
|
|
|
すべての子エレメントが適切に作成されて配置されることを保証するために、描画操作中に呼び出されます。通常はこのメソッドをオーバーライドする必要はありません。
|
ChildElementsDirty フラグが True の場合は、デフォルトの実装によって PositionChildElements が呼び出され、フラグがリセットされます。
|