다음을 통해 공유


공통 컨트롤 매개 변수

다음은 컨트롤 리소스 정의 문의 일반 구문에 대해 설명합니다. 각 매개 변수의 의미는 다음과 같습니다. 경우에 따라 문은 매개 변수를 다르게 사용하거나 매개 변수를 무시할 수 있습니다. 문별 변형은 문 설명서에 설명되어 있습니다.

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

text

컨트롤과 함께 표시할 텍스트입니다. 텍스트는 컨트롤 내에 위치하거나 컨트롤에 인접합니다.

이 매개 변수는 큰따옴표(")로 묶인 0개 이상의 문자를 포함해야 합니다. 문자열은 자동으로 null로 종료되고 결과 리소스 파일에서 유니코드로 변환됩니다.

기본적으로 큰따옴표 사이에 나열된 문자는 ANSI 문자이며 이스케이프 시퀀스는 바이트 이스케이프 시퀀스로 해석됩니다. 문자열 앞에 "L" 접두사가 있으면 문자열은 와이드 문자열이고 이스케이프 시퀀스는 유니코드 문자를 지정하는 2 바이트 이스케이프 시퀀스로 해석됩니다. 텍스트에 큰따옴표가 필요한 경우 큰따옴표를 두 번 포함해야 합니다.

텍스트의 앰퍼샌드(> 문자)는 다음 문자가 컨트롤의 니모닉 문자로 사용됨을 나타냅니다. 컨트롤이 표시되면 앰퍼샌드가 표시되지 않지만 니모닉 문자에 밑줄이 표시됩니다. 사용자는 밑줄이 그린 니모닉 문자에 해당하는 키를 눌러 컨트롤을 선택할 수 있습니다. 앰퍼샌드를 문자열의 문자로 사용하려면 두 개의 앰퍼샌드(&&A)를 삽입합니다.

id

컨트롤 식별자입니다. 이 값은 범위 0에서 65,535까지의 16비트 부호 없는 정수이거나 해당 범위의 값으로 계산되는 간단한 산술 식이어야 합니다.

x

대화 상자의 왼쪽을 기준으로 컨트롤 왼쪽의 X 좌표입니다. 이 값은 0에서 65,535까지의 16비트 부호 없는 정수여야 합니다. 좌표는 대화 상자 단위에 있으며 지정된 컨트롤을 포함하는 대화 상자, 창 또는 컨트롤의 원본을 기준으로 합니다.

y

대화 상자의 위쪽을 기준으로 컨트롤 위쪽의 Y 좌표입니다. 이 값은 0에서 65,535까지의 16비트 부호 없는 정수여야 합니다. 좌표는 지정된 컨트롤을 포함하는 대화 상자, 창 또는 컨트롤의 원점과 관련된 대화 상자 단위에 있습니다.

width

컨트롤의 너비입니다. 이 값은 1에서 65,535까지의 16비트 부호 없는 정수여야 합니다. 너비는 1/4자 단위입니다.

height

컨트롤의 높이입니다. 이 값은 1에서 65,535까지의 16비트 부호 없는 정수여야 합니다. 높이는 1/8자 단위입니다.

style

컨트롤 스타일. 비트 OR(|) 연산자를 사용하여 스타일을 결합합니다. 자세한 내용은 창 스타일을 참조 하세요.

확장 스타일

확장 창 스타일입니다. 확장 스타일을 지정하려면 스타일을 지정해야 합니다. 자세한 내용은 EXSTYLE을 참조 하세요.

helpId

WM_HELP 처리하는 동안 컨트롤을 식별하는 데 사용되는 ID를 나타내는 숫자 식입니다.

controlData

컨트롤에 대한 컨트롤별 데이터입니다. 대화 상자가 만들어지고 컨트롤별 데이터가 있는 해당 대화 상자의 컨트롤이 만들어지면 해당 컨트롤에 대한 WM_CREATE 메시지의 lParam을 통해 해당 데이터에 대한 포인터가 컨트롤의 창 프로시저로 전달됩니다.

설명

가로 대화 상자 단위는 대화 상자 기본 너비 단위의 1/4입니다. 세로 단위는 대화 상자 기본 높이 단위의 1/8입니다. 현재 대화 상자 기본 단위는 현재 시스템 글꼴의 높이와 너비에서 계산됩니다. GetDialogBaseUnits 함수는 대화 상자 기본 단위를 픽셀 단위로 반환합니다. 좌표는 대화 상자의 원점과 상대적입니다.