add faq entries
This commit is contained in:
		
							parent
							
								
									565cc5817d
								
							
						
					
					
						commit
						c55d54e6a5
					
				
					 1 changed files with 41 additions and 0 deletions
				
			
		| 
						 | 
					@ -12,6 +12,28 @@ Make sure to also read the [Item Size and Position](/docs/guide/size-position) a
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## How do I
 | 
					## How do I
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Reduce memory usage
 | 
				
			||||||
 | 
					The main thing you can do to reduce the memory usage of a given configuration
 | 
				
			||||||
 | 
					is to use loaders. Loaders can be used to create objects only when needed,
 | 
				
			||||||
 | 
					and destroy them when not needed.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- Use @@QtQuick.Loader when the component being loaded inherits from @@QtQuick.Item.
 | 
				
			||||||
 | 
					- Use @@Quickshell.LazyLoader in other cases.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Show widgets conditionally
 | 
				
			||||||
 | 
					The @@QtQuick.Item.visible property can be used to change the visibility of an
 | 
				
			||||||
 | 
					Item conditionally, as well as Loaders.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Note that you can change out a loader's component conditionally:
 | 
				
			||||||
 | 
					```qml
 | 
				
			||||||
 | 
					@@QtQuick.Loader {
 | 
				
			||||||
 | 
					  readonly property Component thing1: ...
 | 
				
			||||||
 | 
					  readonly property Component thing2: ...
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					  sourceComponent: condition ? thing1 : thing2
 | 
				
			||||||
 | 
					}
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Make a rounded window
 | 
					### Make a rounded window
 | 
				
			||||||
Rounded windows are simply transparent square ones with a rounded rectangle
 | 
					Rounded windows are simply transparent square ones with a rounded rectangle
 | 
				
			||||||
inside of them.
 | 
					inside of them.
 | 
				
			||||||
| 
						 | 
					@ -29,3 +51,22 @@ inside of them.
 | 
				
			||||||
  }
 | 
					  }
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Something is broken
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### There is a hole in my window
 | 
				
			||||||
 | 
					If you set a Rectangle's color to `"transparent"` and touch its `border` property,
 | 
				
			||||||
 | 
					you'll hit [QTBUG-137166](https://bugreports.qt.io/browse/QTBUG-137166), which
 | 
				
			||||||
 | 
					causes everything under the transparent rectangle to become invisible.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Adding a definition like `border.width: 0` seems to work around it, especially
 | 
				
			||||||
 | 
					if the only border property you wanted to set was radius.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### My window should not be opaque
 | 
				
			||||||
 | 
					If a window is created with an opaque background color, Quickshell will use
 | 
				
			||||||
 | 
					a window surface format that is opaque, which reduces the amount of processing
 | 
				
			||||||
 | 
					the gpu must do to draw it. If you change the background color of your window
 | 
				
			||||||
 | 
					between opaque and transparent colors, this may affect you.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					To tell Quickshell to always create a window capable of showing transparency,
 | 
				
			||||||
 | 
					use @@Quickshell.QsWindow.surfaceFormat to set `opaque` to false.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue