ControlDesigner.UsePreviewControl プロパティ
アセンブリ: System.Design (system.design.dll 内)

コントロール デザイナがデザイン時プレビュー用のコントロールの一時コピーを使用する場合は true。コントロール デザイナがコントロール デザイナに含まれているコントロールの Component プロパティを使用する場合は false。

UsePreviewControl プロパティが true の場合、ViewControl プロパティはコントロールの一時コピーを返します。一時コントロールに加えられた変更は、ドキュメントに永続化されません。
UsePreviewControl プロパティが false の場合、ViewControl プロパティはコントロールの Component プロパティのインスタンスを返します。コントロールのインスタンスに加えられた変更は永続化されます。
SupportsPreviewControlAttribute オブジェクト内の SupportsPreviewControl 設定は、UsePreviewControl プロパティの値を設定するために使用します。したがって、SupportsPreviewControl の設定により、基本 ControlDesigner クラスの ViewControl プロパティによって返されるコントロールの種類が決定されます。SupportsPreviewControlAttribute がコントロール デザイナの宣言内で指定されていない場合、ControlDesigner の動作は SupportsPreviewControl プロパティに false を設定した場合と同じになります。
継承時の注意 ControlDesigner クラスから派生したカスタム デザイナは、UsePreviewControl プロパティをオーバーライドし、SupportsPreviewControlAttribute オブジェクトを無視します。一般に、ViewControl プロパティが常にコントロールの一時コピーを返すことを示すには、UsePreviewControl プロパティをオーバーライドして常に true を返すようにします。ViewControl プロパティが常にコントロールのインスタンスを返すことを示すには、UsePreviewControl プロパティをオーバーライドして常に false を返すようにします。たとえば、PreviewControlDesigner クラスは ControlDesigner から派生し、UsePreviewControl プロパティに対して常に true を返します。

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- ControlDesigner.UsePreviewControl プロパティのページへのリンク