Klasa COleChangeIconDialog

Służy do okna dialogowego Ikona zmiany OLE.

Składnia

class COleChangeIconDialog : public COleDialog

Elementy członkowskie

Konstruktory publiczne

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

Metody publiczne

Nazwa/nazwisko	opis
COleChangeIconDialog::D oChangeIcon	Wykonuje zmianę określoną w oknie dialogowym.
COleChangeIconDialog::D oModal	Wyświetla okno dialogowe Ikona zmiany OLE 2.
COleChangeIconDialog::GetIconicMetafile	Pobiera uchwyt do metapliku skojarzonego z kultową formą tego elementu.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
COleChangeIconDialog::m_ci	Struktura, która kontroluje zachowanie okna dialogowego.

Uwagi

Utwórz obiekt klasy COleChangeIconDialog , gdy chcesz wywołać to okno dialogowe. Po utworzeniu COleChangeIconDialog obiektu można użyć struktury m_ci , aby zainicjować wartości lub stany kontrolek w oknie dialogowym. Struktura m_ci jest typu OLEUICHANGEICON. Aby uzyskać więcej informacji na temat korzystania z tej klasy okna dialogowego, zobacz funkcję składową DoModal .

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGEICON w zestawie Windows SDK.

Aby uzyskać więcej informacji na temat okien dialogowych specyficznych dla ole, zobacz artykuł Okna dialogowe w ole.

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

Wymagania

Nagłówek: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Ta funkcja konstruuje tylko COleChangeIconDialog obiekt.

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Parametry

pItem
Wskazuje element do przekonwertowania.

dwFlags
Flaga tworzenia zawierająca dowolną liczbę następujących wartości połączonych przy użyciu operatora bitowego lub:

• CIF_SELECTCURRENT Określa, że przycisk radiowy Bieżący zostanie wybrany początkowo po wywołaniu okna dialogowego. Jest to opcja domyślna.

• CIF_SELECTDEFAULT Określa, że domyślny przycisk radiowy zostanie wybrany początkowo po wywołaniu okna dialogowego.

• CIF_SELECTFROMFILE Określa, że przycisk radiowy Z pliku zostanie wybrany początkowo po wywołaniu okna dialogowego.

• CIF_SHOWHELP Określa, że przycisk Pomoc będzie wyświetlany po wywołaniu okna dialogowego.

• CIF_USEICONEXE Określa, że ikona powinna zostać wyodrębniona z pliku wykonywalnego określonego w szIconExe polu m_ci zamiast pobierana z typu. Jest to przydatne w przypadku osadzania lub łączenia z plikami innym niż OLE.

pParentWnd
Wskazuje obiekt okna nadrzędnego lub właściciela (typu CWnd), do którego należy obiekt okna dialogowego. Jeśli ma wartość NULL, nadrzędne okno okna dialogowego zostanie ustawione na główne okno aplikacji.

Uwagi

Aby wyświetlić okno dialogowe, wywołaj funkcję DoModal .

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGEICON w zestawie Windows SDK.

COleChangeIconDialog::D oChangeIcon

Wywołaj tę funkcję, aby zmienić ikonę reprezentującą element na element wybrany w oknie dialogowym, gdy funkcja DoModal zwróci element IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parametry

pItem
Wskazuje element, którego ikona się zmienia.

Wartość zwracana

Bezzerowe, jeśli zmiana zakończy się pomyślnie; w przeciwnym razie 0.

COleChangeIconDialog::D oModal

Wywołaj tę funkcję, aby wyświetlić okno dialogowe Ikona zmiany OLE.

virtual INT_PTR DoModal();

Wartość zwracana

Stan ukończenia okna dialogowego. Jedna z następujących wartości:

• IDOK, jeśli okno dialogowe zostało pomyślnie wyświetlone.

• IDCANCEL, jeśli użytkownik anulował okno dialogowe.

• IDABORT, jeśli wystąpił błąd. Jeśli zwracana jest funkcja IDABORT, wywołaj funkcję składową COleDialog::GetLastError , aby uzyskać więcej informacji o typie błędu, który wystąpił. Aby uzyskać listę możliwych błędów, zobacz funkcję OleUIChangeIcon w zestawie WINDOWS SDK.

Uwagi

Jeśli chcesz zainicjować różne kontrolki okna dialogowego, ustawiając elementy członkowskie struktury m_ci , należy to zrobić przed wywołaniem DoModalmetody , ale po utworzeniu obiektu okna dialogowego.

Jeśli DoModal funkcja IDOK zwraca wartość IDOK, możesz wywołać inne funkcje członkowskie, aby pobrać ustawienia lub informacje wprowadzone przez użytkownika w oknie dialogowym.

COleChangeIconDialog::GetIconicMetafile

Wywołaj tę funkcję, aby uzyskać dojście do metapliku zawierającego kultowy aspekt wybranego elementu.

HGLOBAL GetIconicMetafile() const;

Wartość zwracana

Uchwyt do metapliku zawierającego kultowy aspekt nowej ikony, jeśli okno dialogowe zostało odrzucone, wybierając przycisk OK. W przeciwnym razie ikona była wyświetlana przed wyświetleniem okna dialogowego.

COleChangeIconDialog::m_ci

Struktura typu OLEUICHANGEICON używana do kontrolowania zachowania okna dialogowego Zmień ikonę.

OLEUICHANGEICON m_ci;

Uwagi

Elementy członkowskie tej struktury można modyfikować bezpośrednio lub za pomocą funkcji składowych.

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGEICON w zestawie Windows SDK.

Zobacz też

Klasa COleDialog
Wykres hierarchii
Klasa COleDialog