Udostępnij za pośrednictwem

Klasa COleCmdUI

  • Artykuł

Implementuje metodę MFC w celu zaktualizowania stanu obiektów interfejsu użytkownika związanych z IOleCommandTargetfunkcjami opartymi na aplikacji.

Składnia

class COleCmdUI : public CCmdUI

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
COleCmdUI::COleCmdUI COleCmdUI Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
COleCmdUI::Enable Ustawia lub czyści flagę włączania polecenia.
COleCmdUI::SetCheck Ustawia stan włączania/wyłączania polecenia przełącznika.
COleCmdUI::SetText Zwraca nazwę tekstową lub ciąg stanu dla polecenia.

Uwagi

W aplikacji, która nie jest włączona dla obiektów DocObjects, gdy użytkownik wyświetla menu w aplikacji, MFC przetwarza powiadomienia UPDATE_COMMAND_UI. Każde powiadomienie otrzymuje obiekt CCmdUI , który można manipulować w celu odzwierciedlenia stanu określonego polecenia. Jeśli jednak aplikacja jest włączona dla obiektów DocObjects, usługa MFC przetwarza powiadomienia UPDATE_OLE_COMMAND_UI i przypisuje COleCmdUI obiekty.

COleCmdUI Umożliwia obiektowi DocObject odbieranie poleceń pochodzących z interfejsu użytkownika kontenera (na przykład FileNew, Open, Print itd.) i umożliwia kontenerowi odbieranie poleceń pochodzących z interfejsu użytkownika obiektu DocObject. Chociaż IDispatch można użyć do wysyłania tych samych poleceń, IOleCommandTarget zapewnia prostszy sposób wykonywania zapytań, ponieważ opiera się na standardowym zestawie poleceń, zwykle bez argumentów i nie ma żadnych informacji o typie. COleCmdUI Umożliwia włączanie, aktualizowanie i ustawianie innych właściwości poleceń interfejsu użytkownika DocObject. Jeśli chcesz wywołać polecenie, wywołaj metodę COleServerDoc::OnExecOleCmd.

Aby uzyskać więcej informacji na temat obiektów DocObjects, zobacz CDocObjectServer i CDocObjectServerItem.

Hierarchia dziedziczenia

CCmdUI

COleCmdUI

Wymagania

Nagłówek: afxdocob.h

COleCmdUI::COleCmdUI

COleCmdUI Tworzy obiekt skojarzony z konkretnym poleceniem interfejsu użytkownika.

COleCmdUI(
    OLECMD* rgCmds,
    ULONG cCmds,
    const GUID* m_pGroup);

Parametry

rgCmds
Lista obsługiwanych poleceń skojarzonych z danym identyfikatorem GUID. Struktura OLECMD kojarzy polecenia z flagami poleceń.

cCmds
Liczba poleceń w rgCmds.

PGroup
Wskaźnik do identyfikatora GUID, który identyfikuje zestaw poleceń.

Uwagi

Obiekt COleCmdUI udostępnia interfejs programowy do aktualizowania obiektów interfejsu użytkownika DocObject, takich jak elementy menu lub przyciski paska sterowania. Obiekty interfejsu użytkownika można włączyć, wyłączyć, zaznaczyć i/lub wyczyścić za COleCmdUI pomocą obiektu.

COleCmdUI::Enable

Wywołaj tę funkcję, aby ustawić flagę COleCmdUI polecenia obiektu na OLECOMDF_ENABLED, która informuje interfejs, że polecenie jest dostępne i włączone, lub aby wyczyścić flagę polecenia.

virtual void Enable(BOOL bOn);

Parametry

Bon
Wskazuje, czy polecenie skojarzone z obiektem COleCmdUI powinno być włączone, czy wyłączone. Nonzero włącza polecenie; Wartość 0 wyłącza polecenie .

COleCmdUI::SetCheck

Wywołaj tę funkcję, aby ustawić stan włączania/wyłączania polecenia przełącznika.

virtual void SetCheck(int nCheck);

Parametry

nZnacz
Wartość określająca stan ustawiania włączonego/wyłączonego polecenia przełącznika. Wartości to:

Wartość Popis
1 Ustawia polecenie włączone.
2 Ustawia polecenie w celu nieokreślonego; nie można określić stanu, ponieważ atrybut tego polecenia znajduje się zarówno w stanie włączonym, jak i wyłączonym w odpowiednim zaznaczeniu.
dowolna inna wartość Ustawia polecenie na wyłączone.

COleCmdUI::SetText

Wywołaj tę funkcję, aby zwrócić nazwę tekstową lub ciąg stanu dla polecenia.

virtual void SetText(LPCTSTR lpszText);

Parametry

lpszText
Wskaźnik do tekstu, który ma być używany z poleceniem .

Zobacz też

Klasa CCmdUI
Wykres hierarchii