Udostępnij za pośrednictwem

Metoda IOleInPlaceComponent.OnEnterState — (UInt32, Int32)

  • Artykuł

 

Informuje o w miejscu VSPackage obiekt, który został wprowadzony w środowisku lub w lewo stanie.

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

Składnia

void OnEnterState(
    uint dwStateId,
    int fEnter
)

void OnEnterState(
    unsigned int dwStateId,
    int fEnter
)

abstract OnEnterState : 
        dwStateId:uint32 *
        fEnter:int -> unit

Sub OnEnterState (
    dwStateId As UInteger,
    fEnter As Integer
)

Parametry

  • dwStateId
    Type: System.UInt32

    [in] Określa stan nowych lub wcześniej. Nieprawidłowa lista dwStateId wartości, zobacz _OLECSTATE.

  • fEnter
    Type: System.Int32

    [in] Flaga, która jest równa true do wskazania, że środowisko wprowadza stan określony przez dwStateId i false do wskazania, że zostanie zakończone jego stan.

Uwagi

Podpis COM

Z oleipc.idl:

void IOleInPlaceComponent::OnEnterState(
   [in] DWORD dwStateId,
   [in] BOOL fEnter
);

Wywołania środowiska OnEnterState Metoda powiadomić obiekty w miejscu, które nastąpiła zmiana stanu. Jeśli dwStateID jest równa olecstateOnModal, została wyświetlona modalne okno dialogowe. Obiekty w miejscu należy wyłączyć odpowiednio ich systemu windows. Obiekty w miejscu kontroli tylko innych niż składnik jest powiadamiany o zmianach stanu modalne z OnEnterState. Obiekty w miejscu kontroli składnika jest powiadamiany za pośrednictwem EnableModeless.

Do powiadamiania środowiska, że obiekt w miejscu wprowadza modalne stanu, należy wywołać obiekt OnUIComponentEnterState i ustaw dwStateId parametr olecstateOnModal. Środowisko jest odpowiedzialna za wszystkie inne obiekty w miejscu, dla których jest odpowiedzialny o zmianie stanu powiadomienie.

Gdy dwStateId parametr ma wartość olecstateOnRedrawOff w OnEnterState, oznacza to, że obiekt w miejscu należy wyłączyć malowanie ekranu. Ten stan jest zwykle wprowadzono programowo w języku Visual Basic dla aplikacji programisty ustawienie właściwości aplikacji. Obiekt może odpowiadać na tej zmiany stanu w jeden z dwóch sposobów:

  • Ukrywając jego okien najwyższego poziomu bez wymuszenia natychmiastowego odświeżenia. Gdy włączone jest ponownie malowanie ekranu, można wymusić obiektu w miejscu repaint.

  • Przez generują pułapki wszystkie WM_PAINT wiadomości, ustawienie flagi bez odświeżenie Jeśli wiadomość zostanie odebrana podczas rysowania jest wyłączona. Gdy włączone jest ponownie malowanie ekranu, obiekt w miejscu może polegać na Oznacz flagą, aby określić, czy repaint jest konieczne.

Gdy dwStateId parametr ma wartość olecstateOnWarningsOff, oznacza to, że obiekt w miejscu należy wyłączyć wyświetlanie ostrzeżenia dla użytkownika. Środowisko zwykle przechodzi ten stan programowo gdy języka Visual Basic dla aplikacji programisty ustawia właściwości aplikacji. Obiekt w miejscu natychmiast wykonuje swoją odpowiedź domyślna do bieżącej sytuacji, niezależnie od tego mogą być zamiast wyświetlania wiadomości. Na przykład jeśli obiekt w miejscu obecnie trwa zamykanie, jego należy zapisać wszystkie niezapisane zmiany i zamknij. Obiekt nie powinien być wyświetlany okno dialogowe z pytaniem, czy użytkownik chce, aby zapisać zmiany.

Zobacz też

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

Powrót do początku