CDC::StretchBlt

BOOL StretchBlt ( int x, int y, int nWidth właściwości, int nHeight, CDC * pSrcDC, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, DWORD dwRop );

Wartość zwracany

Niezerowa, jeśli bitmapa jest rysowany; inny sposób 0.

Parametry

x

Określa współrzędną x (w jednostkach logicznych) lewego górnego narożnika prostokąta przeznaczenia.

y

Określa współrzędną y (w jednostkach logicznych) lewego górnego narożnika prostokąta przeznaczenia.

nWidth właściwości

Określa szerokość (w jednostkach logicznych) docelowy prostokąt.

nHeight

Określa wysokość (w jednostkach logicznych) docelowy prostokąt.

pSrcDC

Określa kontekstu urządzenia źródłowego.

xSrc

Określa współrzędną x (w jednostkach logicznych) w lewym górnym rogu prostokąta źródłowego.

ySrc

Określa współrzędną x (w jednostkach logicznych) w lewym górnym rogu prostokąta źródłowego.

nSrcWidth

Określa szerokość (w jednostkach logicznych) prostokąta źródłowego.

nSrcHeight

Określa wysokość (w jednostkach logicznych) prostokąta źródłowego.

dwRop

Określa operacji rastrowe. Rastrowe operacji kodów zdefiniować, jak GDI łączy kolory w operacjach wyjścia, obejmujących bieżący pędzel, bitmapę ewentualnego źródła i mapy bitowej miejsca przeznaczenia. Ten parametr może mieć jedną z następujących wartości:

• BLACK&NESSnbsp;  Włącza wszystkie dane wyjściowe na czarny.
  
  
• DSTI&NVERTnbsp;  Odwraca bitmapy przeznaczenia.
  
  
• MERGECOPY   Łączy deseń, jak i bitmapowe źródła za pomocą operatora logiczna i.
  
  
• MERGEPAI&NTnbsp;  Łączy odwróconą źródłowa bitmapa z bitmapą docelowego za pomocą operatora logiczną lub.
  
  
• &NOTSRCCOPYnbsp;  Kopiuje odwróconą źródłowa bitmapa do miejsca docelowego.
  
  
• &NOTSRCERASEnbsp;  Odwraca w wyniku łączenia mapy bitowe przeznaczenia i źródła za pomocą operatora logiczną lub.
  
  
• PATCOPY   Kopiuje wzorzec do mapy bitowej miejsca przeznaczenia.
  
  
• PATI&NVERTnbsp;  Łączy mapy bitowej miejsca przeznaczenia wzorkiem używające operatora XOR logiczna.
  
  
• PATPAI&NTnbsp;  Łączy odwróconą źródłowa bitmapa za pomocą operatora logiczną lub wzorkiem. Łączy w wyniku tej operacji z bitmapą docelowego za pomocą operatora logiczną lub.
  
  
• SRCA&NDnbsp;  Łączy piksele bitmapy przeznaczenia i źródła za pomocą operatora logiczna i.
  
  
• SRCCOPY   Kopiuje źródłowa bitmapa bitmapę przeznaczenia.
  
  
• SRCERASE   Odwraca bitmapy przeznaczenia i łączy wynik z źródłowa bitmapa za pomocą operatora logiczna i.
  
  
• SRCI&NVERTnbsp;  Łączy piksele bitmapy przeznaczenia i źródła za pomocą operatora XOR logiczna.
  
  
• SRCPAI&NTnbsp;  Łączy piksele bitmapy przeznaczenia i źródła za pomocą operatora logiczną lub.
  
  
• I&ntensywność bielinbsp;  Włącza wszystkie dane wyjściowe biały.

Uwagi

Skopiowanie bitmapy od prostokąta źródłowego do docelowy prostokąt, rozciągnięcie lub kompresowanie bitmapy, jeżeli jest to konieczne dopasować wymiary prostokąta przeznaczenia. Funkcja korzystająca rozgrzewających tryb kontekstu urządzenia docelowego (ustawiana przez SetStretchBltMode) jak rozciągnąć lub skompresować mapy bitowej.

Funkcja StretchBlt przenosi bitmapy z urządzenia źródłowego, podane przez pSrcDC urządzenie docelowe, reprezentowane przez obiekt kontekstu urządzenia, których funkcja Państwa jest wywoływana. Parametry xSrc, ySrc, nSrcWidthi nSrcHeight zdefiniować lewego górnego rogu i wymiary prostokąta źródłowego. Parametry x, y, nWidth właściwościi nHeight dać lewego górnego rogu i wymiary prostokąta przeznaczenia. Operacja rastrowych, określona przez dwRop definiuje, jak źródłowa bitmapa i bitów już na urządzenie docelowe są połączone.

Funkcja StretchBlt tworzy lustrzane odbicie obrazu mapy bitowej, jeśli różnią się oznaki parametry nSrcWidth i nWidth właściwości lub nSrcHeight i nHeight . Jeśli nSrcWidth i nWidth właściwości mają różne znaki, funkcja tworzy lustrzane odbicie obrazu bitmapowego wzdłuż osi x. Jeśli nSrcHeight i nHeight mają różne znaki, funkcja tworzy obraz lustrzany bitmapy wzdłuż osi y.

Funkcja StretchBlt rozciąga się lub kompresuje źródłowa bitmapa w pamięci i następnie kopiuje wynik do miejsca przeznaczenia. Jeśli wzorek ma być scalane w wyniku, nie połączyły się dopóki rozciągnięty źródłowa bitmapa jest kopiowany do miejsca przeznaczenia. Jeśli używana jest Pędzel, jest wybrany pędzel w kontekście urządzenia docelowego. Współrzędne miejsca przeznaczenia są przekształcane zgodnie z kontekstu urządzenia docelowego; współrzędne źródła są przekształcane zgodnie z kontekstu urządzenia źródłowego.

Jeśli miejsca przeznaczenia, źródła i bitmapy wzorzec nie ma ten sam format koloru, StretchBlt konwertuje bitmapy źródła i wzorka, aby dopasować bitmapy przeznaczenia. Kolory pierwszego planu i tła kontekstu urządzenia docelowego są używane podczas konwersji.

Jeśli StretchBlt należy przekształcić bitmap monochromatycznych kolorów, ustawia białego bitów (1) do koloru tła i czarny bitów (0) do koloru pierwszego planu. Aby przekonwertować kolor czarno-białych, ustawia pikseli, które odpowiadają kolorowi tła na białe (1) i ustawia wszystkie pozostałe piksele czarny (0). Używane są kolory pierwszego planu i tła kontekstu urządzenia koloru.

Nie wszystkie urządzenia obsługują funkcję StretchBlt . Aby sprawdzić, czy urządzenie obsługuje StretchBlt, wywołania funkcji członek GetDeviceCaps dla systemów z indeksem RASTERCAPS i sprawdzić wartość zwracany Flaga RC_STRETCHBLT.

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

Zobacz teżnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::SetStretchBltMode, :: StretchBlt