CDC::MaskBlt

BOOL M&askBlt ( int x, int y, int nWidth właściwości, int nHeight, CDC * pSrcDC, int xSrc, int ySrc, CBitmapamp; maskBitmap, int xMask, int yMask, DWORD dwRop );

Wartość zwracany

Niezerowa, jeśli funkcja jest skuteczne; inny sposób 0.

Parametry

x

Określa logiczne współrzędnej x lewego górnego narożnika prostokąta przeznaczenia.

y

Określa logiczne współrzędna y lewego górnego narożnika prostokąta przeznaczenia.

nWidth właściwości

Określa szerokość jednostek logicznych, docelowy prostokąt i źródła bitmapy.

nHeight

Określa wysokość jednostek logicznych, docelowy prostokąt i źródła bitmapy.

pSrcDC

Identyfikuje kontekstu urządzenia, z którym mapy bitowej ma zostać skopiowane. To musi mieć wartość zero, jeśli parametr dwRop określa operację rastrowych, która nie zawiera źródło.

xSrc

Określa logiczne współrzędną x lewym górnym rogu źródłowa bitmapa.

ySrc

Określa logiczne współrzędna y lewym górnym rogu źródłowa bitmapa.

maskBitmap

Identyfikuje bitmapowych monochromatycznych maski w połączeniu z bitmapy kolorów w kontekście urządzenia źródłowego.

xMask

Określa przesunięcie poziome pikseli bitmapy maski, określonej przez parametr maskBitmap.

yMask

Określa przesunięcie pionowe pikseli bitmapy maski, określonej przez parametr maskBitmap.

dwRop

Określa pierwszego planu i tła trójskładnikowych rastrowe operacji kody, których funkcja używa się do kontrolowania kombinacji danych źródłowych i docelowych. Kod operacji rastrowe tła jest przechowywany w bajcie wyższe słowo tej wartości; kod operacji rastrowe pierwszego planu jest przechowywany w bajcie wyższe słowo tej wartości; niższe słowo tej wartości jest ignorowany i powinna być równa zero. Makro MAKEROP4 tworzy takiej kombinacji pierwszego planu i tła kodów operacji rastrowe. Zobacz sekcję Uwagi do dyskusji pierwszego planu i tła w kontekście tej funkcji. Zobacz opis funkcji BitBlt Członkowskich listę wspólne kody operacji rastrowe.

Uwagi

Łączy dane koloru dla bitmap źródłowego i docelowego przy użyciu danego maski i rastrowe operacji. Wartość 1 w masce określonej przez maskBitmap wskazuje, że kod operacji pierwszego planu rastrowych, określonej przez dwRop powinny być stosowane w tej lokalizacji. Wartość 0 w masce wskazuje, że kod operacji tła rastrowych, określonej przez dwRop powinny być stosowane w tej lokalizacji. Jeżeli operacje rastrowe wymagają źródła, prostokąt maska musi obejmować prostokąta źródłowego. Jeśli tak nie jest, funkcję nie powiedzie się. Jeżeli operacje rastrowe nie wymagają źródła, prostokąt maska musi obejmować docelowy prostokąt. Jeśli tak nie jest, funkcja zakończy się niepowodzeniem.

Jeżeli obrót lub Ścinanie transformacji jest aktywna dla kontekstu urządzenia źródłowego po wywołaniu tej funkcji, wystąpi błąd. Jednakże dopuszcza się inne rodzaje przekształcenia.

Jeżeli różnią się formaty kolor źródła, deseń i przeznaczenia bitmapy, ta funkcja konwertuje wzorzec lub format źródła lub oba te elementy w pasować do formatu miejsca docelowego. Jeśli mapa bitowa maska nie jest mapa bitowa monochromatyczna, wystąpi błąd. Gdy rozszerzony metaplik jest są rejestrowane, wystąpi błąd (i funkcja zwraca 0) Jeśli kontekstu urządzenia źródłowego identyfikuje kontekstu urządzenia rozszerzonych metaplików. Nie wszystkie urządzenia obsługują MaskBlt. Aplikacja powinna wywołać GetDeviceCaps dla systemów w celu ustalenia, czy urządzenie obsługuje tę funkcję. Jeżeli nie bitmapy maska jest podany, funkcja ta zachowuje się dokładnie tak, jak BitBlt, przy użyciu kodu operacji rastrowe pierwszego planu. Piksel przesuwa się w planie bitmapy maski do punktu (0,0) w kontekstu urządzenia źródłowego bitmapy. Jest to przydatne dla przypadków, w których bitmapę maska zawiera zestaw maski; Aplikacja łatwo można zastosować jednej z nich do zadania maski-Kopiowanie bloku z powierzchni poprzez dostosowanie przesunięcia pikseli i rozmiar prostokąta wysyłane do MaskBlt.

Omówie&nie CDC |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::PlgBlt, CDC::StretchBlt, :: MaskBlt

Index