ISelectionContainer.GetObjects – metoda (UInt32, UInt32, Object )

Článek
08/05/2016

Vrátí aktuálně vybrané objekty nebo objekty, které lze vybrat.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

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

Parametry

dwFlags
[v] Příznak, který určuje typ objektů vrátit.Pokud nastavena na GETOBJS_ALL, ISelectionContainer::GetObjects vrátí všechny objekty na Vybratelný.Pokud nastavena na GETOBJS_SELECTED, jsou vráceny pouze aktuálně vybrané objekty.

cObjects
[v] Určuje požadovaný počet vrácených objektů.

apUnkObjects
[v] Ukazatele na matici ukazatele vybrané nebo volitelný objektů, které podporují IDispatch rozhraní.

Vrácená hodnota

Type: System.Int32

Pokud metoda uspěje, vrací S_OK.Pokud se nezdaří, vrátí kód chyby.

Poznámky

Podpis COM

Z designer.idl:

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

Použití GetObjects, nejprve musí volající CountObjects typu vhodné (vybrané nebo volitelný) určit počet objektů, pak přidělit matice s danou velikost a jejich předávání do GetObjects v apUnkObjects parametr.

Protože GetObjects je určená k naplnění okno Vlastnosti, objekty vrácené musí poskytnout přístup k vlastnosti zobrazení.V některých případech GetObjects vrací ukazatel rozšířeného objektu, nikoli samotný objekt.Rozšířené objekt má vlastnosti, které přímo nepatří do vybraného objektu, ale mohou ovlivnit jeho vzhled a chování.Pokud je vybraný objekt tlačítko ve formuláři Návrhář formuláře jako implementace VSPackage objektu, například GetObjects může obsahovat vlastnosti, například polohu x a y v okně Vlastnosti.V tomto případě GetObjects ve formuláři, nikoli vybrané tlačítko vrátí ukazatel.

Protože podporují vrácených objektů IDispatch rozhraní prostředí informace můžete získat od nich.Například odeslání předdefinovaný identifikátor (DISPID) mohou být předány do IDispatch::Invoke získat název objektu.Predeclared hodnoty dispID jsou negativní zajistit, aby že nedošlo ke konfliktu s identifikátory definované uživatelem.

Následující tabulka popisuje některé informace a jak a kde je získat.

Informace	Získané Z
Název objektu	IDispatch::InvokePomocí identifikátoru odeslání DISPID_NAME
Rejstřík objektů	IDispatch::InvokePomocí identifikátoru odeslání DISPID_OBJECT
Typ objektu	IProvideClassInfo::QueryInterface

Viz také

ISelectionContainer – rozhraní
Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím