QWaylandSurface Class

멤버 함수 문서

QWaylandSurface::QWaylandSurface()

초기화되지 않은 QWaylandSurface 객체를 생성합니다.

QWaylandSurface::QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

지정된 ` compositor ` 및 ` client`에 대해, 그리고 지정된 ` id ` 및 ` version`을 사용하여 `QWaylandSurface`를 생성하고 초기화합니다.

[override virtual noexcept] QWaylandSurface::~QWaylandSurface()

QWaylandSurface 를 삭제합니다.

[signal] void QWaylandSurface::childAdded(QWaylandSurface *child)

이 신호는 wl_subsurface child 가 표면에 추가되었을 때 발생합니다.

QWaylandCompositor *QWaylandSurface::compositor() const

이 QWaylandSurface 에 대한 컴포지터를 반환합니다.

[invokable] void QWaylandSurface::destroy()

QWaylandSurface 를 삭제합니다.

[signal] void QWaylandSurface::dragStarted(QWaylandDrag *drag)

이 신호는 이 표면에서 ‘ drag ’가 시작되었을 때 발신됩니다.

[invokable] void QWaylandSurface::frameStarted()

전송을 위해 모든 프레임 콜백을 준비합니다.

[static] QWaylandSurface *QWaylandSurface::fromResource(wl_resource *resource)

Wayland 리소스 resource 에 해당하는 QWaylandSurface 를 반환합니다.

[invokable] void QWaylandSurface::initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

지정된 ` compositor ` 및 ` client`, 그리고 ` id ` 및 ` version`을 사용하여 ` QWaylandSurface `을 초기화합니다.

bool QWaylandSurface::inputRegionContains(const QPoint &p) const

QWaylandSurface 의 입력 영역에 점 p 이 포함되어 있으면 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

bool QWaylandSurface::inputRegionContains(const QPointF &position) const

QWaylandSurface 의 입력 영역에 점 position 이 포함되어 있으면 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

[invokable] bool QWaylandSurface::isDestroyed() const

QWaylandSurface 가 소멸된 경우 true를 반환합니다. 그렇지 않으면 false를 반환합니다.

bool QWaylandSurface::isInitialized() const

QWaylandSurface 가 초기화된 경우 true를 반환합니다.

QWaylandView *QWaylandSurface::primaryView() const

이 QWaylandSurface 의 기본 뷰를 반환합니다.

QWaylandView::advance() 및 QWaylandSurface::setPrimaryView()도 참조하십시오 .

struct wl_resource *QWaylandSurface::resource() const

이 QWaylandSurface 에 해당하는 Wayland 리소스를 반환합니다.

[invokable] void QWaylandSurface::sendFrameCallbacks()

보류 중인 프레임 콜백을 전송합니다.

void QWaylandSurface::setPrimaryView(QWaylandView *view)

이 표면( QWaylandSurface)에 여러 뷰가 있는 경우, 이 표면의 주 뷰(primary view)를 view 로 설정합니다. 주 뷰는 클라이언트의 재생 빈도를 제어하는 뷰입니다. 이 뷰는 QWaylandView::advance()가 호출될 때 버퍼 참조를 제거하는 역할을 합니다. 자세한 내용은 QWaylandView::advance() 문서를 참조하십시오.

QWaylandWlShellIntegration 및 QWaylandXdgShellV5Integration과 같은 셸 서피스 통합의 경우, 클라이언트로부터의 최대화 및 전체 화면 요청은 해당 통합이 서피스의 주 뷰를 가지고 있을 때만 효과가 있습니다.

primaryView() 및 QWaylandView::advance()도 참조하십시오 .

bool QWaylandSurface::setRole(QWaylandSurfaceRole *role, wl_resource *errorResource, uint32_t errorCode)

표면에 ‘ role ’을 설정합니다. 역할(role)은 표면이 화면에 어떻게 매핑될지를 정의하며, 역할이 지정되지 않은 표면은 숨겨진 것으로 간주됩니다. 표면에 역할이 한 번 할당되면, 이는 해당 표면의 영구적인 역할이 됩니다. 이후 다른 역할을 사용하여 ` setRole() `를 호출하면 ` errorResource `에 프로토콜 오류가 발생하고 클라이언트에게 ` errorCode `가 전송됩니다. 이 요구 사항을 강제 적용하는 것이 표면 역할의 주된 목적입니다.

` role `는 포인터 값으로 비교됩니다. 이름이 무엇이든 간에, ` QWaylandSurfaceRole `의 두 객체는 서로 다른 역할로 간주됩니다.

표면 역할은 예를 들어 셸 확장 프로그램에서와 같이 표면이 특정 목적으로 채택될 때 프로토콜 구현에 의해 내부적으로 설정됩니다. 이러한 방식으로 표면을 사용하는 확장 프로그램을 개발하는 경우가 아니라면 이 함수를 호출해서는 안 됩니다.

역할을 할당할 수 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

[signal] void QWaylandSurface::surfaceDestroyed()

이 신호는 해당 wl_surface가 소멸될 때 발생합니다.

[slot] void QWaylandSurface::updateSelection()

컴포지터가 클립보드에 저장해 둔 선택 영역으로 표면을 업데이트합니다. 표면이 키보드 포커스를 받을 때 이 작업은 자동으로 수행되지만, 이 함수는 키보드 포커스를 받지 않은 클라이언트를 업데이트하는 데 유용합니다.

QList<QWaylandView *> QWaylandSurface::views() const

이 QWaylandSurface 에 대한 뷰를 반환합니다.

wl_client *QWaylandSurface::waylandClient() const

이 QWaylandSurface 를 사용하여 wl_client 를 고정합니다.