Właściwość Printer.ColorMode —

Artykuł
05/17/2015

Pobiera lub ustawia wartość określająca, czy dane wyjściowe będą drukowane w kolorze lub w trybie monochromatycznym na urządzeniu, które obsługuje kolory.

Przestrzeń nazw: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Zestaw: Microsoft.VisualBasic.PowerPacks.Vs (w Microsoft.VisualBasic.PowerPacks.Vs.dll)

Składnia

'Deklaracja
Public Property ColorMode As Short

public short ColorMode { get; set; }

public:
property short ColorMode {
    short get ();
    void set (short value);
}

member ColorMode : int16 with get, set

function get ColorMode () : short 
function set ColorMode (value : short)

Wartość właściwości

Typ: Int16
Zwraca Short.

Uwagi

Gdy PrintAction właściwość jest ustawiona na PrintToPrinter i bieżąca drukarka nie obsługuje kolor, ta właściwość jest ignorowana.Gdy PrintAction właściwość jest ustawiona na PrintToFile, pliki są zapisane w formacie PostScript skali szarości 8-bitowa bez względu na ColorMode wartości.

Jeśli ta właściwość jest ustawiona po wywołaniu Print metoda, wystąpi wyjątek czasu wykonania.

W poniższej tabeli wymieniono PrinterObjectConstants wartości, które są ważne dla ColorMode właściwości.

Stała	Wartość	Opis
vbPRCMMonochrome	1	Wydruk w trybie monochromatycznym (zwykle odcieni czerni i bieli).
vbPRCMColor	2	Wydruk w kolorze.

[!UWAGA]

Funkcje i obiekty w Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 obszaru nazw są dostarczane do użycia przez narzędzia służące do uaktualniania programu Visual Basic 6.0 do Visual Basic.W większości przypadków te funkcje i obiekty powielają funkcjonalność, która jest dostępna w innych obszarach nazw w .NET Framework.Są one niezbędne tylko wtedy, gdy model kodu programu Visual Basic 6.0 różni się znacząco od implementacji.NET Framework.

Przykłady

Poniższy przykład sprawdza, czy bieżąca drukarka obsługuje kolor i ustawia ColorMode właściwość odpowiednio.

Dim pr As New Printer
Dim ps As New Printing.PrinterSettings
If ps.SupportsColor = True Then
    pr.ColorMode = vbPRCMColor
Else
    pr.ColorMode = vbPRCMMonochrome
End If

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.