Udostępnij za pośrednictwem

Metoda IVsProject.OpenItem — (UInt32, Guid, IntPtr, IVsWindowFrame)

  • Artykuł

 

Opublikowano: sierpień 2016

Otwiera element w projekcie.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int OpenItem(
    uint itemid,
    [InAttribute] ref Guid rguidLogicalView,
    IntPtr punkDocDataExisting,
    out IVsWindowFrame ppWindowFrame
)

int OpenItem(
    unsigned int itemid,
    [InAttribute] Guid% rguidLogicalView,
    IntPtr punkDocDataExisting,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract OpenItem : 
        itemid:uint32 *
        rguidLogicalView:Guid byref *
        punkDocDataExisting:nativeint *
        ppWindowFrame:IVsWindowFrame byref -> int

Function OpenItem (
    itemid As UInteger,
    <InAttribute> ByRef rguidLogicalView As Guid,
    punkDocDataExisting As IntPtr,
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame
) As Integer

Parametry

  • itemid
    Type: System.UInt32

    [in] Identyfikator elementu do otwarcia. Powinien być VSITEMID_ROOT lub innym prawidłowym identyfikatorem elementu. Zobacz VSITEMID wyliczenia.

  • rguidLogicalView
    Type: System.Guid

    [in] Unikatowy identyfikator widoku logicznym. W przeciwnym razie GUID_NULL, wskazuje określony typ widoku, aby utworzyć. Aby uzyskać więcej informacji, zobacz LOGVIEWID.

  • punkDocDataExisting
    Type: System.IntPtr

    [in] Wskaźnik do elementu, aby otworzyć obiektu danych dokumentu. Jeśli obiekt wywołujący OpenItem miał wskaźnik do obiektu danych dokumentu, jego może przekazać go w punkDocDataExisting parametru. Jeśli obiekt wywołujący wiedzieli, że obiekt danych dokumentu nie jest otwarty, czy przekazać null. Jeśli obiekt wywołujący nie wiedział nic był otwarty obiekt danych dokumentu lub jeśli chcesz go wyszukać w górę w tabeli uruchomionego dokumentu (Normalizacją), aby dowiedzieć się, a następnie można przekazać DOCDATAEXISTING_UNKNOWN. Jeśli ta wartość jest przekazywany, następnie OpenStandardEditor będzie wyszukiwać wartości w Normalizacją przez wywołanie metody FindAndLockDocument (RDT_EditLock), aby określić, czy plik (obiekt dokumentu danych) jest już otwarty.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell.idl:

HRESULT IVsProject::OpenItem(
   [in] VSITEMID itemid,
   [in] REFGUID rguidLogicalView,
   [in] IUnknown *punkDocDataExisting,
   [out] IVsWindowFrame **ppWindowFrame
);

Implementując IVsProjectSpecificEditorMap2 obiektu interfejsu w projekcie, można wykonać obsługi plików określonego projektu. Oznacza to, że mogą obsługiwać otwierania pliku w edytorze określonego projektu lub umożliwiając globalne edytora otworzyć element. Otwieranie elementu wymaga uruchomienia przy użyciu edytora OpenStandardEditor lub OpenSpecificEditor, w zależności od obsługi, należy wdrożyć. Aby uzyskać więcej informacji, zobacz GetSpecificEditorProperty.

[!UWAGA]

W implementacji programu OpenItem, nie należy wywoływać Show na ramki okna return w ppWindowFrame.

Porównaj z ReopenItem metody.

Zobacz też

Interfejs IVsProject
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku