Klasse COleChangeIconDialog

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Wordt gebruikt voor het dialoogvenster OLE-wijzigingspictogram.

Syntaxis

class COleChangeIconDialog : public COleDialog

Leden

Openbare constructors

Naam Description
COleChangeIconDialog::COleChangeIconDialog Maakt een COleChangeIconDialog object.

Openbare methoden

Naam Description
COleChangeIconDialog::D oChangeIcon Hiermee wordt de wijziging uitgevoerd die is opgegeven in het dialoogvenster.
COleChangeIconDialog::D oModal Hiermee wordt het dialoogvenster OLE 2-pictogram wijzigen weergegeven.
COleChangeIconDialog::GetIconicMetafile Hiermee haalt u een ingang op voor het metabestand dat is gekoppeld aan de iconische vorm van dit item.

Leden van openbare gegevens

Naam Description
COleChangeIconDialog::m_ci Een structuur waarmee het gedrag van het dialoogvenster wordt bepaald.

Opmerkingen

Maak een object van klasse COleChangeIconDialog wanneer u dit dialoogvenster wilt aanroepen. Nadat een COleChangeIconDialog object is gemaakt, kunt u de m_ci structuur gebruiken om de waarden of statussen van besturingselementen in het dialoogvenster te initialiseren. De m_ci structuur is van het type OLEUICHANGEICON. Zie de functie DoModal-lid voor meer informatie over het gebruik van deze dialoogvensterklasse.

Zie de structuur OLEUICHANGEICON in de Windows SDK voor meer informatie.

Zie het artikel Dialoogvensters in OLE voor meer informatie over OLE-specifieke dialoogvensters.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

Requirements

Koptekst: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Met deze functie wordt alleen een COleChangeIconDialog object samengesteld.

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

Parameterwaarden

pItem
Verwijst naar het item dat moet worden geconverteerd.

dwFlags
Vlag voor maken, die een willekeurig aantal van de volgende waarden bevat, gecombineerd met behulp van de bitsgewijze operator:

  • CIF_SELECTCURRENT Geeft aan dat het keuzerondje Huidig wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen. Dit is de standaardwaarde.

  • CIF_SELECTDEFAULT Geeft aan dat het keuzerondje Standaard wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen.

  • CIF_SELECTFROMFILE Geeft aan dat het keuzerondje Bestand in eerste instantie wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen.

  • CIF_SHOWHELP Geeft aan dat de Knop Help wordt weergegeven wanneer het dialoogvenster wordt aangeroepen.

  • CIF_USEICONEXE Geeft aan dat het pictogram moet worden geëxtraheerd uit het uitvoerbare bestand dat is opgegeven in het szIconExe veld van m_ci in plaats van opgehaald uit het type. Dit is handig voor het insluiten of koppelen van niet-OLE-bestanden.

pParentWnd
Verwijst naar het bovenliggende of eigenaarvensterobject (van het type CWnd) waartoe het dialoogvensterobject behoort. Als het NULL is, wordt het bovenliggende venster van het dialoogvenster ingesteld op het hoofdtoepassingsvenster.

Opmerkingen

Als u het dialoogvenster wilt weergeven, roept u de functie DoModal aan.

Zie de structuur OLEUICHANGEICON in de Windows SDK voor meer informatie.

COleChangeIconDialog::D oChangeIcon

Roep deze functie aan om het pictogram voor het item te wijzigen in het item dat in het dialoogvenster is geselecteerd nadat DoModal IDOK retourneert.

BOOL DoChangeIcon(COleClientItem* pItem);

Parameterwaarden

pItem
Verwijst naar het item waarvan het pictogram wordt gewijzigd.

Retourwaarde

Niet-nul als de wijziging is geslaagd; anders 0.

COleChangeIconDialog::D oModal

Roep deze functie aan om het dialoogvenster OLE-wijzigingspictogram weer te geven.

virtual INT_PTR DoModal();

Retourwaarde

Voltooiingsstatus voor het dialoogvenster. Een van de volgende waarden:

  • IDOK als het dialoogvenster is weergegeven.

  • IDCANCEL als de gebruiker het dialoogvenster heeft geannuleerd.

  • IDABORT als er een fout is opgetreden. Als IDABORT wordt geretourneerd, roept u de COleDialog::GetLastError lidfunctie aan om meer informatie te krijgen over het type fout dat is opgetreden. Zie de functie OleUIChangeIcon in de Windows SDK voor een overzicht van mogelijke fouten.

Opmerkingen

Als u de verschillende dialoogvensterbesturingselementen wilt initialiseren door leden van de m_ci structuur in te stellen, moet u dit doen voordat u aanroept DoModal, maar nadat het dialoogvensterobject is gemaakt.

Als DoModal IDOK wordt geretourneerd, kunt u andere lidfuncties aanroepen om de instellingen of informatie op te halen die door de gebruiker is ingevoerd in het dialoogvenster.

COleChangeIconDialog::GetIconicMetafile

Roep deze functie aan om een ingang te krijgen voor het metabestand dat het iconische aspect van het geselecteerde item bevat.

HGLOBAL GetIconicMetafile() const;

Retourwaarde

De ingang naar het metabestand met het iconische aspect van het nieuwe pictogram, als het dialoogvenster is gesloten door OK te kiezen; anders is het pictogram zoals het was voordat het dialoogvenster werd weergegeven.

COleChangeIconDialog::m_ci

Structuur van het type OLEUICHANGEICON dat wordt gebruikt om het gedrag van het dialoogvenster Change Icon te bepalen.

OLEUICHANGEICON m_ci;

Opmerkingen

Leden van deze structuur kunnen rechtstreeks of via lidfuncties worden gewijzigd.

Zie de structuur OLEUICHANGEICON in de Windows SDK voor meer informatie.

Zie ook

Klasse COleDialog
Hiërarchiegrafiek
Klasse COleDialog

  • Last updated on