Класс COleChangeIconDialog

  • Статья

Используется для диалогового окна OLE "Изменить значок".

Синтаксис

class COleChangeIconDialog : public COleDialog

Участники

Открытые конструкторы

Имя Описание
COleChangeIconDialog::COleChangeIconDialog Формирует объект COleChangeIconDialog.

Открытые методы

Имя Описание
COleChangeIconDialog::D oChangeIcon Выполняет изменение, указанное в диалоговом окне.
COleChangeIconDialog::D oModal Отображает диалоговое окно "Значок изменения OLE 2".
COleChangeIconDialog::GetIconicMetafile Возвращает дескриптор метафайла, связанного с знаковой формой этого элемента.

Открытые члены данных

Имя Описание
COleChangeIconDialog::m_ci Структура, управляющая поведением диалогового окна.

Замечания

Создайте объект класса COleChangeIconDialog при вызове этого диалогового окна. COleChangeIconDialog После создания объекта можно использовать структуру m_ci для инициализации значений или состояний элементов управления в диалоговом окне. Структура m_ci имеет тип OLEUICHANGEICON. Дополнительные сведения об использовании этого класса диалоговых окон см. в функции-члене DoModal .

Дополнительные сведения см . в структуре OLEUICHANGEICON в пакете SDK для Windows.

Дополнительные сведения о диалоговых окнах, относящихся к OLE, см. в статье "Диалоговые окна" в OLE.

Иерархия наследования

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleChangeIconDialog

Требования

Заголовок: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Эта функция создает только COleChangeIconDialog объект.

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

Параметры

pItem
Указывает на преобразованный элемент.

dwFlags
Флаг создания, содержащий любое количество следующих значений, объединенных с помощью побитового или оператора:

  • CIF_SELECTCURRENT Указывает, что текущая переключатель будет выбрана изначально при вызове диалогового окна. Это значение по умолчанию.

  • CIF_SELECTDEFAULT Указывает, что переключатель по умолчанию будет выбран изначально при вызове диалогового окна.

  • CIF_SELECTFROMFILE Указывает, что переключатель from File будет выбран изначально при вызове диалогового окна.

  • CIF_SHOWHELP Указывает, что кнопка справки будет отображаться при вызове диалогового окна.

  • CIF_USEICONEXE Указывает, что значок должен быть извлечен из исполняемого файла, указанного в szIconExe поле m_ci вместо извлечения из типа. Это полезно для внедрения или связывания с файлами без OLE.

pParentWnd
Указывает на родительский или владелец объекта окна (типа CWnd), к которому принадлежит объект диалогового окна. Если значение NULL, родительское окно диалогового окна будет задано в главном окне приложения.

Замечания

Чтобы отобразить диалоговое окно, вызовите функцию DoModal .

Дополнительные сведения см . в структуре OLEUICHANGEICON в пакете SDK для Windows.

COleChangeIconDialog::D oChangeIcon

Вызовите эту функцию, чтобы изменить значок, представляющий элемент, выбранный в диалоговом окне после возврата идентификатора DoModal .

BOOL DoChangeIcon(COleClientItem* pItem);

Параметры

pItem
Указывает на элемент, значок которого изменяется.

Возвращаемое значение

Ненулевое значение, если изменение выполнено успешно; в противном случае — 0.

COleChangeIconDialog::D oModal

Вызовите эту функцию, чтобы отобразить диалоговое окно "Значок изменения OLE".

virtual INT_PTR DoModal();

Возвращаемое значение

Состояние завершения диалогового окна. Одно из следующих значений:

  • Идентификатор IDOK, если диалоговое окно было успешно отображено.

  • IdCANCEL, если пользователь отменил диалоговое окно.

  • IDABORT, если произошла ошибка. Если идентификатор IDABORT возвращается, вызовите COleDialog::GetLastError функцию-член, чтобы получить дополнительные сведения о типе ошибки, которая произошла. Список возможных ошибок см . в функции OleUIChangeIcon в пакете SDK для Windows.

Замечания

Если вы хотите инициализировать различные элементы управления диалоговым окном, задав элементы структуры m_ci , перед вызовом следует сделать это перед вызовом DoModal, но после создания объекта диалогового окна.

Если DoModal возвращает идентификатор IDOK, можно вызвать другие функции-члены, чтобы получить параметры или сведения, входные пользователем в диалоговое окно.

COleChangeIconDialog::GetIconicMetafile

Вызовите эту функцию, чтобы получить дескриптор метафайла, содержащего знаковый аспект выбранного элемента.

HGLOBAL GetIconicMetafile() const;

Возвращаемое значение

Дескриптор метафайла, содержащего знаковый аспект нового значка, если диалоговое окно было отклонено, нажав кнопку "ОК", в противном случае значок, как это было до отображения диалогового окна.

COleChangeIconDialog::m_ci

Структура типа OLEUICHANGEICON, используемая для управления поведением диалогового окна "Значок изменения".

OLEUICHANGEICON m_ci;

Замечания

Элементы этой структуры можно изменять напрямую или через функции-члены.

Дополнительные сведения см . в структуре OLEUICHANGEICON в пакете SDK для Windows.

См. также

Класс COleDialog
Диаграмма иерархии
Класс COleDialog