SetConsoleMode

Składnia

Argumenty

Argument	Opis
hConsoleHandle	Uchwyt do bufora ekranu konsoli. Uchwyt musi mieć dostęp GENERIC_READ.
dwMode	Tryb do ustawienia. Jeśli wartość argumentu hConsoleHandle dotyczy bufora wejściowego, wartość tego argumentu może składać się z poniższych stałych. Podczas tworzenia konsoli domyślnie tylko tryb ENABLE_WINDOW_INPUT nie jest dostępny. Nazwa Wartość Znaczenie ENABLE_ECHO_INPUT 0x0004 Znaki odczytywane przez funkcję ReadFile lub » WinAPI ♦ ReadConsole są zapisywane do aktywnego bufora ekranu podczas odczytywania. Ten tryb może być używany tylko w połączeniu z trybem ENABLE_LINE_INPUT. ENABLE_EXTENDED_FLAGS 0x0080 Tryb używany do włączania lub wyłączania dodatkowych flag. Połączenie tego trybu z innymi flagami powoduje ich włączenie. Flagi, które nie zostaną podane zostaną wyłączone. ENABLE_INSERT_MODE 0x0020 Kiedy ten tryb jest ustawiony, tekst wprowadzany w oknie konsoli zostanie wstawiony w miejscu kursora i cały poniższy tekst nie zostanie nadpisany, inaczej cały tekst zostanie nadpisany. ENABLE_LINE_INPUT 0x0002 Funkcja ReadFile lub » WinAPI ♦ ReadConsole zakończy działanie tylko, gdy zostanie odczytany znak powrotu karetki (CR). Jeśli ten tryb jest wyłączony, wymienione funkcje zakończą działanie, gdy co najmniej jeden znak zostanie odczytany. ENABLE_MOUSE_INPUT 0x0010 Jeśli wskaźnik myszy jest wewnątrz okna konsoli i okno ma fokus klawiatury, zdarzenia myszy są umieszczane w buforze wejściowym. Te zdarzenia są pomijane przez funkcję ReadFile oraz » WinAPI ♦ ReadConsole, jeśli ten tryb jest włączony. ENABLE_PROCESSED_INPUT 0x0001 Flaga powoduje, że znak sterujący CTRL+C jest przetwarzany przez system i nie jest umieszczany w buforze wejściowym. Jeśli bufor wejściowy jest odczytywany przez funkcję ReadFile lub » WinAPI ♦ ReadConsole, inne znaki sterujące są przetwarzane przez system i nie są zwracane w buforze funkcji ReadFile lub » WinAPI ♦ ReadConsole. Jeśli tryb ENABLE_LINE_INPUT jest również włączony, znaki backspace, powrotu karetki (CR) i nowej linii (LF) są obsługiwane przez system. ENABLE_QUICK_EDIT_MODE 0x0040 Ta flaga pozwala na używanie myszy do zaznaczania i edycji tekstu. ENABLE_WINDOW_INPUT 0x0008 Działania użytkownika zmieniające rozmiar bufora ekranu konsoli są umieszczane w buforze ekranu konsoli. Informacje o tych zdarzeniach mogą być odczytane z bufora wejściowego za pomocą funkcji » WinAPI ♦ ReadConsoleInput.  Jeśli wartość argumentu hConsoleHandle dotyczy bufora ekranu, wartość tego argumentu może składać się z poniższych stałych. Podczas tworzenia bufora ekranu oba tryby są domyślnie włączone. Nazwa Wartość Znaczenie ENABLE_PROCESSED_OUTPUT 0x0001 Znaki zapisywane przez funkcję » WinAPI ♦ WriteFile lub WriteConsole albo odczytywane przez funkcję ReadFile lub » WinAPI ♦ ReadConsole są sprawdzane poprzez kontrolę sekwencji ASCII. Znaki backspace, tabulatory (tab), dźwiękowe (bell), powrotu karetki (CR) i nowej linii (LF) są przetwarzane. ENABLE_WRAP_AT_EOL_OUTPUT 0x0002 Podczas zapisywania danych przez funkcję » WinAPI ♦ WriteFile lub WriteConsole albo odczytywania ich przez funkcję ReadFile lub » WinAPI ♦ ReadConsole kursor przemieszcza się na początek następnego wiersza po napotkaniu końca obecnego wiersza. To powoduje automatyczne przewijanie wierszy wyświetlanych w oknie konsoli, gdy kursor znajdzie się za ostatnim wierszem w oknie. To powoduje również przewijanie treści bufora ekranu konsoli (utratę górnego wiersza bufora ekranu konsoli), gdy kursor znajdzie się za ostatnim wierszem w buforze ekranu konsoli. Jeśli ten tryb jest wyłączony, ostatni znak w wierszu jest nadpisywany przez kolejne znaki.

Zwracana wartość

Jeśli nie wystąpią błędy, zwracana wartość jest niezerowa, inaczej 0. Aby uzyskać szczegółowe informacje o błędzie, wywołaj funkcję _{» WinAPI ♦} GetLastError.

Dodatkowe informacje

Konsola składa się z bufora wejściowego oraz z buforów ekranu. Tryb bufora konsoli określa, jak konsola zachowuje się podczas odczytywania i zapisywania danych. Jedno ustawienie stałych flag jest używane z uchwytami wejścia, natomiast inne ustawienia są używane do uchwytów buforów ekranu (wyjścia). Ustawienie trybu wyjścia jednego bufora ekranu nie zmienia trybu wyjścia innych buforów ekranu. Tryby ENABLE_LINE_INPUT i ENABLE_ECHO_INPUT tylko powodują przetwarzanie używane w funkcji ReadFile albo ReadConsole do odczytywania z buforu wejścia konsoli. Podobnie tryb ENABLE_PROCESSED_INPUT głównie jest używany w funkcji ReadFile albo ReadConsole. Oprócz tego określa również, czy znak CTRL+C jest wstawiany do bufora wejściowego (do odczytania przez funkcję ReadConsoleInput) lub jest przekazywany do funkcji zdefiniowanej przez programistę. Tryby ENABLE_WINDOW_INPUT oraz ENABLE_MOUSE_INPUT określają, czy interakcje użytkownika obejmujące zmianę rozmiaru okna i akcje związane z użyciem myszy są przekazywane do bufora wejściowego, czy mają być odrzucane. Te zdarzenia mogą byc odczytane przez funkcję ReadConsoleInput, ale są zawsze przechwytywane przez funkcję ReadFile lub ReadConsole. Tryby ENABLE_PROCESSED_OUTPUT i ENABLE_WRAP_AT_EOL_OUTPUT powodują przetwarzanie z użyciem funkcji ReadConsole, _{» WinAPI ♦} WriteFile, _{» WinAPI ♦} WriteFile lub WriteConsole. Aby określić obecny tryb bufora wejściowego lub bufora ekranu konsoli, wywołaj funkcję _{» WinAPI ♦} GetConsoleMode.

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Wincon.h (dołącza Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms686033(v=vs.85).aspx