DesignerAutoFormat.GetPreviewControl メソッド

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

DesignerAutoFormat.GetPreviewControl メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

書式をコントロールに適用する前にプレビューできるように、関連付けられているコントロールのコピーを返します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 GetPreviewControl ( _
    runtimeControl As Control _
) As Control

Visual Basic (使用法)

Dim instance As DesignerAutoFormat
Dim runtimeControl As Control
Dim returnValue As Control

returnValue = instance.GetPreviewControl(runtimeControl)

C#

public virtual Control GetPreviewControl (
    Control runtimeControl
)

C++

public:
virtual Control^ GetPreviewControl (
    Control^ runtimeControl
)

J#

public Control GetPreviewControl (
    Control runtimeControl
)

JScript

public function GetPreviewControl (
    runtimeControl : Control
) : Control

パラメータ

runtimeControl

Web サーバー コントロールの実行時バージョン。

戻り値
GetPreviewControl メソッドは、関連付けられている Web サーバー コントロールのコピー返します。

解説

GetPreviewControl メソッドは、Visual Studio 2005 などのビジュアルなデザイナの [オートフォーマット] ダイアログ ボックスで、書式を実際のコントロールに適用する前のデザイン時に、書式設定されたコントロールの実行時プレビューを表示するために使用されます。

ControlDesigner オブジェクトの SupportsPreviewControlAttribute 属性の設定に関係なく、GetPreviewControl メソッドは、runtimeControl パラメータでコントロールのコピーを返します。

継承時の注意 次のような場合は、GetPreviewControl メソッドをオーバーライドできます。

• 返されるコントロールのサイズが元のコントロールのサイズと異なる。

• より具体的なプレビューを表示するために、コントロールにサンプル データを設定する必要がある。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerAutoFormat クラス
DesignerAutoFormat メンバ
System.Web.UI.Design 名前空間
DesignerAutoFormat クラス
ControlDesigner クラス
その他の技術情報
Web フォームのデザイン時サポート