ISelectionContainer.GetObjects Yöntem (UInt32, UInt32, Object )

Makale
08/08/2016

Şu anda seçili olan nesneler veya seçilebilir olan nesneleri döndürür.

Ad Alanı: Microsoft.VisualStudio.Shell.Interop
Derleme: Microsoft.VisualStudio.Shell.Interop (Microsoft.VisualStudio.Shell.Interop.dll içinde)

Sözdizimi

int GetObjects(
    uint dwFlags,
    uint cObjects,
    object[] apUnkObjects
)

int GetObjects(
    unsigned int dwFlags,
    unsigned int cObjects,
    array<Object^>^ apUnkObjects
)

abstract GetObjects : 
        dwFlags:uint32 *
        cObjects:uint32 *
        apUnkObjects:Object[] -> int

Function GetObjects (
    dwFlags As UInteger,
    cObjects As UInteger,
    apUnkObjects As Object()
) As Integer

Parametreler

dwFlags
Type: System.UInt32

[in] Döndürülecek nesnelerin türünü belirten bayrak. Varsa ayarlamak GETOBJS_ALL, ISelectionContainer::GetObjects tüm seçilebilir nesneleri döndürür. Varsa ayarlamak GETOBJS_SELECTED, yalnızca seçili nesneler döndürülür.

cObjects
Type: System.UInt32

[in] İstenen döndürülecek nesne sayısını belirtir.

apUnkObjects
Type: System.Object[]

[in] Bir dizi seçili veya seçilebilir işaretçi işaretçisi nesneleri destekleyen IDispatch arabirimi.

Dönüş Değeri

Type: System.Int32

Yöntem başarılı olursa, döndürür S_OK. Başarısız olursa, bir hata kodu döndürür.

Notlar

COM imza

Designer.idl:

HRESULT ISelectionContainer::GetObjects(
   [in] DWORD dwFlags,
   [in] ULONG cObjects,
   [out, size_is(cObjects)] IUnknown ** apUnkObjects
);

Kullanılacak GetObjects, çağıran çağırmalısınız CountObjects nesne sayısını belirlemek için uygun türüyle (seçilen veya seçilebilir), sonra bu boyut olan bir dizi tahsis ve içine geçirme GetObjects içinde apUnkObjects parametresi.

Çünkü GetObjects olan Özellikler penceresinde doldurmak için kullanılan, nesneleri döndürülen görüntülenecek özelliklerine erişim sağlamalıdır. Bazı durumlarda, GetObjects nesnenin kendisini değil, genişletilmiş bir nesneye bir işaretçi döndürür. Genişletilmiş nesne seçili nesneye doğrudan ait değil ancak görünüşünü veya davranışını etkileyen özellikleri vardır. Örneğin, seçili nesnenin VSPackage uygulama nesnesi olarak form tasarımcısı bir formda bir düğme ise GetObjects özellikleri Özellikler penceresinde X ve Y konumu gibi içerebilir. Bu durumda, GetObjects Seçilen düğmesini yerine formun bir işaretçi döndürür.

Döndürülen nesneleri desteklediğinden IDispatch arabirimi, ortam edinebilirsiniz bilgi bunları doğrudan. Örneğin, önceden tanımlanmış gönderme tanımlayıcısının (DISPID'in) için geçirilebilir IDispatch::Invoke bir nesnenin adını almak için. Kullanıcı tanımlı tanımlayıcıları ile çakışmadığından emin olmak için negatif predeclared DISPID değeri.

Aşağıdaki tabloda bu bilgiler ve nasıl ve nereden alınır bazıları açıklanmaktadır.

Bilgi	Alınan
Nesne adı	IDispatch::Invoke DISPID_NAME gönderme tanımlayıcısının kullanma
Nesne dizini	IDispatch::Invoke DISPID_OBJECT gönderme tanımlayıcısının kullanma
Nesne türü	IProvideClassInfo::QueryInterface

Ayrıca bkz.

ISelectionContainer Arabirim
Microsoft.VisualStudio.Shell.Interop Ad Alanı

Başa dön

Aracılığıyla paylaş