BorderImage QML Type

이 속성은 테두리 이미지의 중간 부분을 반복하거나 늘리는 방법을 설명합니다.

각 속성의 기본 타일 모드는 BorderImage.Stretch입니다.

currentFrame 는 현재 표시되는 프레임입니다. 기본값은 0 입니다. 이미지에 여러 프레임이 포함된 경우 0 과 frameCount - 1 사이의 숫자로 설정하여 다른 프레임을 표시할 수 있습니다.

frameCount 는 이미지의 프레임 수입니다. 대부분의 이미지에는 프레임이 하나만 있습니다.

로컬 파일시스템의 이미지를 별도의 스레드에서 비동기적으로 로드하도록 지정합니다. 기본값은 false이므로 이미지가 로드되는 동안 사용자 인터페이스 스레드가 차단됩니다. asynchronous 을 참으로 설정하면 이미지를 즉시 표시하는 것보다 반응형 사용자 인터페이스를 유지하는 것이 더 바람직한 경우에 유용합니다.

이 속성은 로컬 파일 시스템에서 읽은 이미지에만 유효합니다. 네트워크 리소스(예: HTTP)를 통해 로드된 이미지는 항상 비동기적으로 로드됩니다.

4개의 테두리선(가로 2개, 세로 2개)은 아래 그림과 같이 이미지를 9개의 섹션으로 나눕니다:

각 테두리선(왼쪽, 오른쪽, 위쪽, 아래쪽)은 소스 이미지의 각 가장자리에서 픽셀 단위로 오프셋을 지정합니다. 기본적으로 각 테두리 선의 값은 0입니다.

예를 들어, 다음 정의는 하단 선을 이미지 하단에서 10픽셀 위로 설정합니다:

BorderImage {
    border.bottom: 10
    // ...
}

테두리 선은 .sci file 을 사용하여 지정할 수도 있습니다.

이미지를 캐시할지 여부를 지정합니다. 기본값은 true입니다. cache 을 false로 설정하면 큰 이미지를 처리할 때 작은 'UI 요소' 이미지를 희생시키면서 캐시되지 않도록 하는 데 유용합니다.

이 속성은 이미지의 가로 반전 여부(효과적으로 미러링된 이미지 표시)를 보유합니다.

기본값은 false입니다.

이 속성은 이미지 로딩 진행률을 0.0(아무것도 로드되지 않음)에서 1.0(완료)까지 보유합니다.

status 를참조하세요 .

이 속성은 source 속성이 변경되어 로드가 비동기적으로 수행될 때의 동작을 정의합니다. asynchronous 속성이 true 으로 설정되어 있거나 이미지가 로컬 파일 시스템에 없는 경우에 해당합니다.

retainWhileLoading 가 false (기본값)인 경우 이전 이미지는 즉시 삭제되고 새 이미지가 로드되는 동안 컴포넌트가 지워집니다. true 로 설정하면 이전 이미지가 유지되며 새 이미지가 준비될 때까지 계속 표시됩니다.

이 속성을 활성화하면 새 이미지를 로드하는 데 시간이 오래 걸리는 경우 깜박임을 방지할 수 있습니다. 새 이미지가 로드되는 동안 이중 버퍼링을 위해 메모리를 추가로 사용하는 대가가 따릅니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 속성은 이미지 크기 조정 또는 변형 시 이미지가 부드럽게 필터링되는지 여부를 유지합니다. 부드럽게 필터링하면 시각적 품질이 향상되지만 일부 하드웨어에서는 속도가 느려질 수 있습니다. 이미지가 자연스러운 크기로 표시되는 경우 이 속성은 시각적 또는 성능에 영향을 미치지 않습니다.

기본적으로 이 속성은 true로 설정됩니다.

이 속성은 소스 이미지를 참조하는 URL을 보유합니다.

BorderImage Qt에서 지원하는 모든 이미지 형식을 처리할 수 있으며, Qt에서 지원하는 모든 URL 체계에서 로드됩니다.

이 속성은 테두리, 이미지 파일 및 지정된 테두리 이미지에 대한 타일 규칙을 지정하는 QML 전용 텍스트 기반 형식으로 작성된 .sci 파일을 참조하는 데에도 사용할 수 있습니다.

다음 .sci 파일은 이미지 picture.png 의 테두리를 각 면에 10으로 설정합니다:

border.left: 10
border.top: 10
border.bottom: 10
border.right: 10
source: "picture.png"

URL은 절대적이거나 컴포넌트의 URL에 상대적일 수 있습니다.

QQuickImageProvider 를참조하세요 .

이 속성은 로드된 이미지의 실제 너비와 높이를 보유합니다.

BorderImage 에서 이 속성은 읽기 전용입니다.

Image::sourceSize도 참조 하세요.

이 속성은 이미지 로딩 상태를 설명합니다. 다음 중 하나가 될 수 있습니다:

progress 를참조하세요 .