CTaskDialog-Klasse

Ein Popupdialogfeld, das wie ein Meldungsfeld jedoch funktioniert, zusätzliche Informationen für den Benutzer angezeigt werden kann.CTaskDialog enthält auch Funktionen zum Erfassen von Informationen vom Benutzer ein.

class CTaskDialog : public CObject

Mitglieder

Dd293651.collapse_all(de-de,VS.110).gifKonstruktoren

CTaskDialog::CTaskDialog

Erstellt ein CTaskDialog-Objekt.

Dd293651.collapse_all(de-de,VS.110).gifMethoden

CTaskDialog::AddCommandControl

Fügt ein Ein Steuerelement für Befehlsschaltflächen CTaskDialog hinzu.

CTaskDialog::AddRadioButton

Fügt ein Optionsfeld CTaskDialog hinzu.

CTaskDialog::ClickCommandControl

Ein Steuerelement für Befehlsschaltflächen Klickt ein oder eine allgemeine Schaltfläche programmgesteuert.

CTaskDialog::ClickRadioButton

Klickt auf ein Optionsfeld programmgesteuert.

CTaskDialog::DoModal

Zeigt das CTaskDialog an.

CTaskDialog::GetCommonButtonCount

Ruft die Anzahl der verfügbaren allgemeinen Schaltflächen ab.

CTaskDialog::GetCommonButtonFlag

Konvertiert eine Standard-Windows-Schaltfläche auf das allgemeine Schaltflächentyp, der mit der CTaskDialog-Klasse zugeordnet ist.

CTaskDialog::GetCommonButtonId

Wird einer der allgemeinen Schaltflächentypen zugeordnet CTaskDialog mit der Klasse zu einer Standard-Windows-Schaltfläche.

CTaskDialog::GetOptions

Gibt die Optionsflags für dieses CTaskDialog zurück.

CTaskDialog::GetSelectedCommandControlID

Gibt das ausgewählte Ein Steuerelement für Befehlsschaltflächen zurück.

CTaskDialog::GetSelectedRadioButtonID

Gibt das Optionsfeld aktiviert zurück.

CTaskDialog::GetVerificationCheckboxState

Ruft den Zustand des Überprüfungskontrollkästchens ab.

CTaskDialog::IsCommandControlEnabled

Bestimmt, ob ein Ein Steuerelement für Befehlsschaltflächen oder eine allgemeine Schaltfläche aktiviert ist.

CTaskDialog::IsRadioButtonEnabled

Bestimmt, ob ein Optionsfeld aktiviert ist.

CTaskDialog::IsSupported

Bestimmt, ob der Computer, auf dem die Anwendung ausgeführt wird, CTaskDialog unterstützt.

CTaskDialog::LoadCommandControls

Fügt Befehlsschaltflächensteuerelemente mithilfe von Daten aus der Zeichenfolgentabelle hinzu.

CTaskDialog::LoadRadioButtons

Fügt Optionsfelder mithilfe von Daten aus der Zeichenfolgentabelle hinzu.

CTaskDialog::NavigateTo

Überträgt den Fokus zu einem anderen CTaskDialog.

CTaskDialog::OnCommandControlClick

Das Framework ruft diese Methode auf, wenn der Benutzer auf ein Ein Steuerelement für Befehlsschaltflächen klickt.

CTaskDialog::OnCreate

Das Framework ruft diese Methode auf, nachdem es CTaskDialog erstellt.

CTaskDialog::OnDestroy

Das Framework ruft diese Methode auf, unmittelbar vor dem CTaskDialog zerstört.

CTaskDialog::OnExpandButtonClick

Das Framework ruft diese Methode auf, wenn der Benutzer auf der Erweiterungsschaltfläche klickt.

CTaskDialog::OnHelp

Das Framework ruft diese Methode auf, wenn die Benutzeranforderungen unterstützen.

CTaskDialog::OnHyperlinkClick

Das Framework ruft diese Methode auf, wenn der Benutzer auf einen Link klickt.

CTaskDialog::OnInit

Das Framework ruft diese Methode auf, wenn CTaskDialog initialisiert wird.

CTaskDialog::OnNavigatePage

Das Framework ruft diese Methode auf, wenn der Benutzer den Fokus hinsichtlich der Steuerelemente auf CTaskDialog verschoben wird.

CTaskDialog::OnRadioButtonClick

Das Framework ruft diese Methode auf, wenn der Benutzer ein Optionsfeld-Steuerelement auswählt.

CTaskDialog::OnTimer

Das Framework ruft diese Methode auf, wenn der Zeitgeber abläuft.

CTaskDialog::OnVerificationCheckboxClick

Das Framework ruft diese Methode auf, wenn der Benutzer auf das Überprüfungskontrollkästchen klickt.

CTaskDialog::RemoveAllCommandControls

Entfernt alle Befehlssteuerelemente von CTaskDialog.

CTaskDialog::RemoveAllRadioButtons

Entfernt alle Optionsfelder von CTaskDialog.

CTaskDialog::SetCommandControlOptions

Aktualisiert ein Ein Steuerelement für Befehlsschaltflächen auf CTaskDialog.

CTaskDialog::SetCommonButtonOptions

Aktualisiert eine Teilmenge allgemeine aktiviert werden, Schaltflächen und erfordert UAC-Ausweitung.

CTaskDialog::SetCommonButtons

Fügt allgemeine Schaltflächen CTaskDialog hinzu.

CTaskDialog::SetContent

Aktualisiert den Inhalt CTaskDialog.

CTaskDialog::SetDefaultCommandControl

Gibt das standardmäßige Ein Steuerelement für Befehlsschaltflächen an.

CTaskDialog::SetDefaultRadioButton

Gibt das standardmäßige Optionsfeld an.

CTaskDialog::SetDialogWidth

Passt die Breite CTaskDialog.

CTaskDialog::SetExpansionArea

Aktualisiert den Erweiterungsbereich CTaskDialog.

CTaskDialog::SetFooterIcon

Aktualisiert das Fußzeilensymbol für CTaskDialog.

CTaskDialog::SetFooterText

Aktualisiert den Text in der Fußzeile CTaskDialog.

CTaskDialog::SetMainIcon

Aktualisiert das Symbol CTaskDialog.

CTaskDialog::SetMainInstruction

Aktualisiert die Anweisung CTaskDialog.

CTaskDialog::SetOptions

Konfiguriert die Optionen für CTaskDialog.

CTaskDialog::SetProgressBarMarquee

Konfiguriert eine Laufschriftleiste für CTaskDialog und fügt sie dem Dialogfeld hinzu.

CTaskDialog::SetProgressBarPosition

Passt die Position der Statusanzeige.

CTaskDialog::SetProgressBarRange

Passt den Bereich der Statusanzeige.

CTaskDialog::SetProgressBarState

Legt den Zustand der Statusanzeige fest und zeigt diesen auf CTaskDialog an.

CTaskDialog::SetRadioButtonOptions

Aktiviert oder deaktiviert ein Optionsfeld.

CTaskDialog::SetVerificationCheckbox

Legt den aktivierten Zustand des Überprüfungskontrollkästchens fest.

CTaskDialog::SetVerificationCheckboxText

Legt den Text auf der rechten Seite des Überprüfungskontrollkästchens fest.

CTaskDialog::SetWindowTitle

Legt den Titel CTaskDialog fest.

CTaskDialog::ShowDialog

Erstellt und zeigt CTaskDialog an.

CTaskDialog::TaskDialogCallback

Das Framework ruft dieses als Reaktion auf verschiedene Windows-Meldungen auf.

Dd293651.collapse_all(de-de,VS.110).gifDatenmember

m_aButtons

Das Array von Befehlsschaltflächensteuerelementen für CTaskDialog.

m_aRadioButtons

Das Array von Optionsfeld-Steuerelementen für CTaskDialog.

m_bVerified

TRUE gibt das Überprüfungskontrollkästchen wird überprüft an; FALSE gibt es ist nicht an.

m_footerIcon

Das Symbol in der Fußzeile CTaskDialog.

m_hWnd

Ein Handle für das Fenster für CTaskDialog.

m_mainIcon

Das hauptsächliche Symbol CTaskDialog.

m_nButtonDisabled

Eine Maske, die angibt, die aus allgemeinen Schaltflächen deaktiviert werden.

m_nButtonElevation

Eine Maske, die angibt, die aus allgemeinen Schaltflächen UAC-Ausweitung erfordern.

m_nButtonId

Die ID des ausgewählten Befehlsschaltflächensteuerelements.

m_nCommonButton

Eine Maske, die angibt, das allgemeine Schaltflächen auf CTaskDialog angezeigt werden.

m_nDefaultCommandControl

Die ID des Befehlsschaltflächensteuerelements, das ausgewählt wird, wenn CTaskDialog angezeigt wird. 

m_nDefaultRadioButton

Die ID des RadioButton-Steuerelements, das ausgewählt wird, wenn CTaskDialog angezeigt wird.

m_nFlags

Eine Maske, die die Optionen für CTaskDialog angibt.

m_nProgressPos

Die aktuelle Position der Statusanzeige.Dabei muss es sich um einen Wert zwischen m_nProgressRangeMin und m_nProgressRangeMax handeln.

m_nProgressRangeMax

Der maximale Wert für die Statusanzeige.

m_nProgressRangeMin

Der minimale Wert für die Statusanzeige.

m_nProgressState

Der Zustand der Statusanzeige.Weitere Informationen finden Sie unter CTaskDialog::SetProgressBarState.

m_nRadioId

Die ID des Steuerelements des aktivierten Optionsfelds.

m_nWidth

Die Breite des CTaskDialog in Pixel.

m_strCollapse

Die Zeichenfolge, die CTaskDialog auf der rechten Seite des Erweiterungsfelds anzeigt, wenn die erweiterten Informationen ausgeblendet werden.

m_strContent

Die Zeichenfolge CTaskDialog.

m_strExpand

Die Zeichenfolge, die CTaskDialog auf der rechten Seite des Erweiterungsfelds anzeigt, wenn die erweiterten Informationen angezeigt werden.

m_strFooter

Die Fußzeile CTaskDialog.

m_strInformation

Die erweiterten Informationen für CTaskDialog.

m_strMainInstruction

Die Anweisung CTaskDialog.

m_strTitle

Der Titel der CTaskDialog.

m_strVerification

Die Zeichenfolge, die CTaskDialog auf der rechten Seite des Überprüfungskontrollkästchens anzeigt.

Hinweise

Die CTaskDialog-Klasse ersetzt das Standardwindows-meldungs-Feld und verfügt über zusätzliche Funktionen wie neue Steuerelemente, mit der Informationen vom Benutzer zu erfassen.Diese Klasse ist in der MFC-Bibliothek in Visual Studio 2010.CTaskDialog ist verfügbar Starten mit Windows Vista.In früheren Versionen von Windows können das CTaskDialog-Objekt nicht anzeigen.Verwenden Sie CTaskDialog::IsSupported, um zur Laufzeit zu bestimmen, ob der aktuelle Benutzer das Aufgabendialogfeld anzeigen kann.Das Standardwindows-meldungs-Feld wird weiterhin in Visual Studio 2010 unterstützt.

CTaskDialog ist nur verfügbar, wenn Sie die Anwendung erstellen, indem Sie die Unicode-Bibliothek verwenden.

CTaskDialog verfügt über zwei verschiedene Konstruktoren.Ein Konstruktor ermöglicht es Ihnen, zwei Befehlsschaltflächen und maximal sechs regulären Schaltflächen-Steuerelemente anzugeben.Sie können mehr Befehlsschaltflächen hinzufügen, nachdem Sie CTaskDialog erstellen.Der zweite Konstruktor unterstützt keine Befehlsschaltflächen, aber Sie können eine unbegrenzte Anzahl reguläre Schaltflächen-Steuerelemente hinzufügen.Weitere Informationen über die Konstruktoren, finden Sie unter CTaskDialog::CTaskDialog.

Im folgenden Bild wird ein Beispiel CTaskDialog an, um den Speicherort von einigen der Steuerelemente zu veranschaulichen.

CTaskDialog-Beispiel

Beispiel für CTaskDialog

Anforderungen

**Minimales erforderliches Betriebssystem:**Windows Vista

Header: afxtaskdialog.h

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Hinzufügen von einem CTaskDialog zu einer Anwendung

Referenz

CObject-Klasse

Hierarchien-Diagramm

Weitere Ressourcen

MFC-Klassen