【C語言】控制台窗口圖形界面編程（六）：光標設置

00. 目錄

目錄

• 00. 目錄
• 01. CONSOLE_CURSOR_INFO結構
• 02. GetConsoleCursorInfo函數
• 03. SetConsoleCursorInfo函數
• 04. SetConsoleCursorPosition函數

01. CONSOLE_CURSOR_INFO結構

包含有關控制台光標的信息。

typedef struct _CONSOLE_CURSOR_INFO {
  DWORD dwSize;
  BOOL  bVisible;
} CONSOLE_CURSOR_INFO, *PCONSOLE_CURSOR_INFO;

dwSize
光標填充的字符單元格的百分比。該值介於1和100之間。光標外觀會發生變化，從完全填充單元格到顯示為單元格底部的水平線。

注意 雖然dwSize值通常介於1和100之間，但在某些情況下，可能會返回該范圍之外的值。例如，如果在注冊表中將CursorSize設置為0，則返回的dwSize值將為0。

bVisible
光標的可見性。如果光標可見，則此成員為TRUE。

02. GetConsoleCursorInfo函數

獲取有關指定控制台屏幕緩沖區的光標大小和可見性的信息。

類型聲明

BOOL WINAPI GetConsoleCursorInfo(
  _In_  HANDLE               hConsoleOutput,
  _Out_ PCONSOLE_CURSOR_INFO lpConsoleCursorInfo
);

功能:
	獲取光標相關信息
參數:
	hConsoleOutput 控制台屏幕緩沖區的句柄。句柄必須具有GENERIC_READ訪問權限。
	lpConsoleCursorInfo 指向CONSOLE_CURSOR_INFO結構的指針，該結構接收有關控制台游標的信息。

返回值:
	如果函數成功，則返回值為非零值。
	如果函數失敗，則返回值為零。要獲取擴展錯誤信息，請調用GetLastError。

參考程序

#define _CRT_SECURE_NO_WARNINGS
#include<stdio.h>
#include<string.h>
#include<stdlib.h>

#include <Windows.h>
#include <conio.h>


int main(void)
{
	//定義句柄變量
	HANDLE hOut = NULL;

	//光標信息變量
	CONSOLE_CURSOR_INFO cursorInfo;

	//獲取標准輸出句柄
	hOut = GetStdHandle(STD_OUTPUT_HANDLE);

	//獲取當前光標信息
	GetConsoleCursorInfo(hOut, &cursorInfo);

	printf("光標默認大小: %d 光標是否可見: %d\n", cursorInfo.dwSize, cursorInfo.bVisible);


	//關閉句柄
	CloseHandle(hOut);

	system("pause");
	return 0;
}

執行結果

03. SetConsoleCursorInfo函數

設置指定控制台屏幕緩沖區的光標大小和可見性。

函數聲明:

BOOL WINAPI SetConsoleCursorInfo(
  _In_       HANDLE              hConsoleOutput,
  _In_ const CONSOLE_CURSOR_INFO *lpConsoleCursorInfo
);
功能：
	設置光標的屬性
參數：
	hConsoleOutput 控制台屏幕緩沖區的句柄。句柄必須具有GENERIC_READ訪問權限。
	lpConsoleCursorInfo 指向CONSOLE_CURSOR_INFO結構的指針，該結構為控制台屏幕緩沖區的游標提供新規范。

返回值：
	如果函數成功，則返回值為非零值。
	如果函數失敗，則返回值為零。要獲取擴展錯誤信息，請調用GetLastError。

參考程序

#define _CRT_SECURE_NO_WARNINGS
#include<stdio.h>
#include<string.h>
#include<stdlib.h>

#include <Windows.h>
#include <conio.h>


int main(void)
{
	//定義句柄變量
	HANDLE hOut = NULL;

	//光標信息變量
	CONSOLE_CURSOR_INFO cursorInfo;

	//獲取標准輸出句柄
	hOut = GetStdHandle(STD_OUTPUT_HANDLE);

	//獲取當前光標信息
	GetConsoleCursorInfo(hOut, &cursorInfo);
	printf("光標默認大小: %d 光標是否可見: %d\n", cursorInfo.dwSize, cursorInfo.bVisible);

	getchar();
	//設置光標的尺寸為20
	cursorInfo.dwSize = 5;
	SetConsoleCursorInfo(hOut, &cursorInfo);

	getchar();

	//設置光標的尺寸為50
	cursorInfo.dwSize = 50;
	SetConsoleCursorInfo(hOut, &cursorInfo);

	getchar();

	//設置光標的尺寸為100
	cursorInfo.dwSize = 100;
	SetConsoleCursorInfo(hOut, &cursorInfo);

	getchar();

	//設置光標不可見
	cursorInfo.dwSize = 25;
	cursorInfo.bVisible = 0;
	SetConsoleCursorInfo(hOut, &cursorInfo);

	getchar();

	//關閉句柄
	CloseHandle(hOut);

	system("pause");
	return 0;
}

執行結果

04. SetConsoleCursorPosition函數

設置指定控制台屏幕緩沖區中的光標位置。

函數聲明：

BOOL WINAPI SetConsoleCursorPosition(
  _In_ HANDLE hConsoleOutput,
  _In_ COORD  dwCursorPosition
);

功能：
	設置光標的位置
	
參數：
	hConsoleOutput 控制台屏幕緩沖區的句柄。句柄必須具有GENERIC_READ訪問權限。
	dwCursorPosition 用於指定新的光標位置（以字符為單位）。坐標是屏幕緩沖區字符單元格的列和行。坐標必須位於控制台屏幕緩沖區的邊界內。
	
返回值：
	如果函數成功，則返回值為非零值。
	如果函數失敗，則返回值為零。要獲取擴展錯誤信息，請調用GetLastError。

參考程序；

#define _CRT_SECURE_NO_WARNINGS
#include<stdio.h>
#include<string.h>
#include<stdlib.h>

#include <Windows.h>
#include <conio.h>


int main(void)
{
	//定義句柄變量
	HANDLE hOut = NULL;

	COORD pos;

	//獲取標准輸出句柄
	hOut = GetStdHandle(STD_OUTPUT_HANDLE);

	pos.X = 8;
	pos.Y = 8;
	//設置光標的位置
	SetConsoleCursorPosition(hOut, pos);
	printf("hello itcast1");

	pos.X = 18;
	pos.Y = 16;
	//設置光標的位置
	SetConsoleCursorPosition(hOut, pos);
	printf("hello itcast2");


	//關閉句柄
	CloseHandle(hOut);

	system("pause");
	return 0;
}

測試結果：