Share via


COleControl::GetDC

Stellt bereit, damit ein fensterloses Objekt einen Gerätekontext des Bildschirms (oder einen kompatiblen) vom Container abruft.

CDC* GetDC(
   LPCRECT lprcRect = NULL,
   DWORD dwFlags = OLEDC_PAINTBKGND 
);

Parameter

  • lprcRect
    Ein Zeiger auf das Rechteck, das das fensterlose Steuerelement neu entwerfen möchte, in Clientkoordinaten des Steuerelements.NULL bedeutet den vollständigen Wertebereich des Objekts.

  • dwFlags
    Zeichnungsattribute des Gerätekontexts.Auswahlmöglichkeiten sind:

    • OLEDC_NODRAW gibt an, dass das Objekt den Gerätekontext, um keine Zeichnungen auszuführen jedoch verwendet Informationen über das Anzeigegerät lediglich abzurufen.Der Container sollte das DC des Fensters einfach übergeben, ohne weitere Verarbeitung.

    • OLEDC_PAINTBKGND Anforderungen dass die Containerfarbe der Hintergrund, bevor das DC zurückgegeben wird.Ein Objekt sollte dieses Flag verwenden, wenn ein Domänencontroller für das Neuzeichnen eines Bereichs mit transparentem Hintergrund anfordert.

    • OLEDC_OFFSCREEN informiert den Container, dass das Objekt in eine Offscreenbitmap rendern möchte, die auf dem Bildschirm dann kopiert werden sollen.Ein Objekt sollte dieses Flag verwenden, wenn der Zeichenvorgang, den es im Begriff ist, um auszuführen, viel Flimmern generiert.Der Container ist frei, diese Anforderung zu ehren oder nicht.Wenn dieses Flag nicht festgelegt wird, muss der Container hinter einem Domänencontroller übergeben auf dem Bildschirm.Dadurch können Objekte, um direkte Bildschirmvorgänge wie das Anzeigen einer Auswahl auszuführen (über einen XOR Vorgang).

Rückgabewert

Zeiger auf Anzeigegerätenkontext für den CWnd-Clientbereich des Containers, wenn erfolgreich; andernfalls ist der Rückgabewert NULL.Der Anzeigegerätenkontext kann in folgenden GDI-Funktionen zum Sie umbrochenen im Clientbereich des Fensters des Containers verwendet werden.

Hinweise

Die ReleaseDC-Memberfunktion muss aufgerufen werden, um den Kontext freizugeben, nachdem gezeichnet hat.Wenn GetDC, Objektübergabe das Rechteck aufgerufen wird, das sie in eigenen Clientkoordinaten zeichnen möchten.GetDC übersetzt diese in die Koordinaten des Containerclientbereichs.Das Objekt sollte ein gewünschtes zeichnendes Rechteck nicht anfordern, die als sein eigenes Clientbereichsrechteck größer ist, deren Größe mit GetClientRect abgerufen werden kann.Unbeabsichtigt zeichnen dieses verhindert Objekte an, wo sie nicht auf sollen.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl-Klasse

Hierarchien-Diagramm

COleControl::ReleaseDC