DesignSurface Sınıf

Tanım

Bileşenleri tasarlamak için bir kullanıcı arabirimi sunar.

public ref class DesignSurface : IDisposable, IServiceProvider
public class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
[<System.Security.SecurityCritical>]
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
Devralma
DesignSurface
Öznitelikler
Uygulamalar

Açıklamalar

sınıfı, DesignSurface kullanıcının tasarımcı olarak algıladıkça uygular. DesignSurface , kullanıcının tasarım zamanı özelliklerini değiştirmek için işleyip işlemesi gereken kullanıcı arabirimidir. DesignSurface tamamen kendi kendine kapsanan bir tasarım yüzeyi sağlar.

Sınıf DesignSurface tek başına tasarımcı olarak kullanılabilir veya birden çok DesignSurface nesne barındıran bir uygulama için ortak bir uygulama sağlamak üzere sınıfıyla DesignSurfaceManager birleştirilebilir.

Sınıf DesignSurface kendi başına kullanılabilir veya kullanıcı bundan yeni bir sınıf türetebilir ve davranışı genişletebilir.

DesignSurface sınıfı otomatik olarak çeşitli tasarım zamanı hizmetleri sağlar. DesignSurface sınıfı, tüm hizmetlerini oluşturucusunda ekler. Bu hizmetlerin çoğu korumalı ServiceContainer özellikte değiştirilerek geçersiz kılınabilir. Bir hizmeti değiştirmek için oluşturucuyu geçersiz kılın, base çağrısı yapın ve korumalı ServiceContainer özellik aracılığıyla tüm değişiklikleri yapın. Hizmet kapsayıcısına eklenen ve uygulanan IDisposable tüm hizmetler, tasarım yüzeyi atıldığında atılır. Sınıfının sağladığı varsayılan değiştirilebilir hizmet DesignSurface kümesi aşağıdaki tabloda gösterilmiştir.

Hizmet Açıklama
IExtenderProviderService Kapsayıcının bileşen koleksiyonunun parçası olmayan nesnelerin kendi genişletici sağlayıcılarını sağlamasını sağlar.
IExtenderListService Genişletici sağlayıcılarının listesini almak için tarafından TypeDescriptor kullanılır. Bu hizmetle, genişletici sağlayıcıları kapsayıcının dışında yaşayabilir.
ITypeDescriptorFilterService Tasarımcı meta veri kancaları sağlar. Bu, meta veri filtreleme için birincil arabirimdir.
ISelectionService Tasarımcıdaki bileşenleri seçmek için bir yol sağlar.
IReferenceService Bu nesneler sitelendirilmediğinde bile nesneler için bir ad almak için bir yol sağlar.
DesignSurface Tasarım yüzeyinin kendisini bir hizmet olarak sunar.
DesignerOptionService Tasarımcı için seçenek değerlerini almak ve ayarlamak için bir temel sınıf sağlar.

Aşağıdaki tabloda varsayılan olarak sağlanan değiştirilemeyen hizmetler gösterilmektedir.

Hizmet Açıklama
IComponentChangeService Bileşenlerde değişiklik yapıldıkçe olayları tetikler.
IDesignerHost Türler, hizmetler ve işlemlere erişimi denetler. Tasarımcılar için birincil arabirim.
IContainer Tasarlanan bileşenler kümesinin sahibidir. Her tasarımcının bileşenlerine sahip olan bir IContainer bileşeni vardır.
IServiceContainer 'den IServiceProvider türetilir ve tasarımcıya hizmet ekleme ve kaldırmanın bir yolunu sağlar.

Sınıfı, bu hizmetlere ek olarak bir DesignSurface bileşenin sitesi aracılığıyla kullanılabilen tek bir hizmet de sağlar. Bu hizmet her bileşen için benzersizdir. Aşağıdaki tabloda değiştirilemeyen hizmetler gösterilmektedir.

Hizmet Açıklama
IDictionaryService Bir bileşenle ilgili rastgele verileri depolamak için kullanılabilecek genel bir anahtar/değer çifti sözlüğü.
INestedContainer Bir bileşenin tasarımcıya ek alt bileşenler eklemesini sağlayan kapsayıcı. Bu bileşenler tasarım yüzeyinin bir parçası olacak, ancak serileştirmeye katılmayacaktır. Bir tasarımcıda kendi bölgesini açığa çıkarma yeteneğine sahip bir denetim tasarlamak istediğinizde ancak bölgenin serileştirmeye katılmasını istemediğinizde bu yararlı olur.

'a ISiteek olarak, site aşağıdaki arabirimleri de uygular.

Dikkat

Diğer site uygulamaları bunları uygulamayabileceği için ayırt edici olmayan atama kullanmak yerine bu arabirimlerin var olup olmadığını denetleyin.

Hizmet Açıklama
IServiceContainer Siteye özgü hizmetlerin kapsayıcısına ulaşmak için bir yol sağlar. Örneğin, IDictionaryService siteye özgü bir hizmettir. Bu hizmetle, siteye özgü ek hizmetler ekleyebilirsiniz.

Oluşturucular

DesignSurface()

DesignSurface sınıfının yeni bir örneğini başlatır.

DesignSurface(IServiceProvider)

DesignSurface sınıfının yeni bir örneğini başlatır.

DesignSurface(IServiceProvider, Type)

DesignSurface sınıfının yeni bir örneğini başlatır.

DesignSurface(Type)

DesignSurface sınıfının yeni bir örneğini başlatır.

Özellikler

ComponentContainer

IContainer Uygulamayı tasarım yüzeyinde alır.

DtelLoading

Tasarım Zamanı Hata Listesi'nin yüklenip yüklenmediğini belirten bir değer alır.

IsLoaded

Tasarım yüzeyinin şu anda yüklenip yüklenmediğini belirten bir değer alır.

LoadErrors

Yükleme hatalarından oluşan bir koleksiyon veya void koleksiyonu döndürür.

ServiceContainer

Hizmet kapsayıcısını alır.

View

Kök tasarımcının görünümünü alır.

Yöntemler

BeginLoad(DesignerLoader)

Verilen tasarımcı yükleyicisiyle yükleme işlemini başlatır.

BeginLoad(Type)

Yükleme işlemini başlatır.

CreateComponent(Type)
Geçersiz.

Bir bileşenin örneğini oluşturur.

CreateDesigner(IComponent, Boolean)

Kapsayıcıya bileşen eklendiğinde bir tasarımcı oluşturur.

CreateInstance(Type)

Verilen türün bir örneğini oluşturur.

CreateNestedContainer(IComponent)

Denetimleri veya bileşenleri iç içe yerleştirmeye uygun bir kapsayıcı oluşturur.

CreateNestedContainer(IComponent, String)

Denetimleri veya bileşenleri iç içe yerleştirmeye uygun bir kapsayıcı oluşturur.

Dispose()

tarafından DesignSurfacekullanılan kaynakları serbest bırakır.

Dispose(Boolean)

tarafından DesignSurfacekullanılan kaynakları serbest bırakır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Flush()

Tasarım yüzeyindeki değişiklikleri serileştirir.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetService(Type)

Hizmet kapsayıcısından bir hizmet alır.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnLoaded(LoadedEventArgs)

Olayı tetikler Loaded .

OnLoading(EventArgs)

Olayı tetikler Loading .

OnUnloaded(EventArgs)

Olayı tetikler Unloaded .

OnUnloading(EventArgs)

Olayı tetikler Unloading .

OnViewActivate(EventArgs)

Olayı tetikler ViewActivated .

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Ekinlikler

Disposed

Tasarım yüzeyi atıldığında gerçekleşir.

Flushed

yöntemine Flush()DesignSurfacebir çağrı yapıldığında gerçekleşir.

Loaded

Tasarımcı yükü tamamlandığında gerçekleşir.

Loading

Tasarımcı yüklenmek üzere olduğunda gerçekleşir.

Unloaded

Tasarımcının yüklemesini kaldırma işlemi tamamlandığında gerçekleşir.

Unloading

Tasarımcı yüklenmek üzere olduğunda gerçekleşir.

ViewActivated

yöntemi üzerinde IDesignerHostçağrıldığında Activate() gerçekleşir.

Şunlara uygulanır

Ayrıca bkz.