解决措施
当Surface模式下的XComponent组件其内容与组件的尺寸不一致时,可通过设置renderFit属性,以调整内容在组件尺寸范围内的布局方式,例如拉伸、居中、等比缩放等。在API version 低于18时,Surface模式下的XComponent组件的renderFit属性仅支持设置为RenderFit.RESIZE_FILL;如果设置为其他属性值可能在部分机型出现显示异常。如果确实需要设置RESIZE_FILL之外的属性值,可以通过升级至API version 18或在XComponent组件id字段中包含"RenderFitSurface"关键字来修正显示效果。升级API version 18是推荐方案,适用于新开发项目;id字段修改方案适用于需要兼容旧API version的项目。
示例代码
@Entry
@Component
struct XComponentSurfaceRenderFit {
@State xcWidth: number = 500;
@State xcHeight: number = 700;
myXComponentController: XComponentController = new XComponentController();
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Start }) {
XComponent({
id: 'myXComponent_RenderFitSurface', // When the string of the id contains "RenderFitSurface", RenderFit can be displayed correctly
type: XComponentType.SURFACE,
controller: this.myXComponentController
})
.width(this.xcWidth)
.height(this.xcHeight)
.renderFit(RenderFit.CENTER)
}
.width('100%')
}
}