feat(apple): beforeCaptureScreenshot callback (#10913)

Adds docs for the beforeCaptureScreenshot callback for the Cocoa SDK;
see getsentry/sentry-cocoa#4210.
We have to wait until we release Cocoa 8.33.0 to merge this.

platform-includes/enriching-events/attach-viewhierarchy/apple.mdx

@@ -13,3 +13,38 @@ SentrySDK.start { options in
   options.attachViewHierarchy = YES;
 }];
 ```
+
+### Customize View Hierarchy Capturing
+
+<Note>
+
+Requires Cocoa SDK version `8.33.0` or higher.
+
+</Note>
+
+
+The `beforeCaptureViewHierarchy` also allows you to customize the behavior based on event data, so you can decide when to capture a view hierarchy and when not to. The callback doesn't work for crash events.
+
+```swift {tabTitle:Swift}
+import Sentry
+
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.beforeCaptureViewHierarchy = { event in
+        // Return false to not capture a view hierarchy for the event.
+        return false
+    }
+}
+```
+
+```objc {tabTitle:Objective-C}
+@import Sentry;
+
+[SentrySDK startWithConfigureOptions:^(SentryOptions *options) {
+    options.dsn = @"___PUBLIC_DSN___";
+    options.beforeCaptureViewHierarchy = ^BOOL(SentryEvent * _Nonnull event) {
+        // Return NO to not capture a view hierarchy for the event.
+        return NO;
+    };
+}];
+```